react-native-enriched-markdown 0.1.0 → 0.2.0

package/ios/renderer/RenderContext.m

@@ -0,0 +1,312 @@
+#import "RenderContext.h"
+#import "CodeBackground.h"
+#import "FontUtils.h"
+#import <React/RCTFont.h>
+
+@implementation BlockStyle
+@end
+
+@implementation RenderContext {
+  NSMutableDictionary<NSString *, UIFont *> *_fontCache;
+  NSParagraphStyle *_baseSpacerTemplate;
+  NSParagraphStyle *_baseBlockSpacerTemplate;
+}
+
+- (instancetype)init
+{
+  if (self = [super init]) {
+    _linkRanges = [NSMutableArray array];
+    _linkURLs = [NSMutableArray array];
+    _headingRanges = [NSMutableArray array];
+    _headingLevels = [NSMutableArray array];
+    _imageRanges = [NSMutableArray array];
+    _imageAltTexts = [NSMutableArray array];
+    _imageURLs = [NSMutableArray array];
+    _listItemRanges = [NSMutableArray array];
+    _listItemPositions = [NSMutableArray array];
+    _listItemDepths = [NSMutableArray array];
+    _listItemOrdered = [NSMutableArray array];
+    _fontCache = [NSMutableDictionary dictionary];
+    _currentBlockStyle = [[BlockStyle alloc] init];
+    _allowFontScaling = YES;
+    _maxFontSizeMultiplier = 0;
+
+    NSMutableParagraphStyle *spacerTemplate = [[NSMutableParagraphStyle alloc] init];
+    _baseSpacerTemplate = [spacerTemplate copy];
+
+    NSMutableParagraphStyle *blockSpacerTemplate = [[NSMutableParagraphStyle alloc] init];
+    blockSpacerTemplate.minimumLineHeight = 1;
+    blockSpacerTemplate.maximumLineHeight = 1;
+    _baseBlockSpacerTemplate = [blockSpacerTemplate copy];
+
+    [self reset];
+  }
+  return self;
+}
+
+#pragma mark - Font Cache
+
+- (UIFont *)cachedFontForSize:(CGFloat)fontSize family:(NSString *)fontFamily weight:(NSString *)fontWeight
+{
+  CGFloat effectiveMultiplier = _allowFontScaling ? RCTFontSizeMultiplierWithMax(_maxFontSizeMultiplier) : 1.0;
+
+  NSString *weightKey = (fontWeight.length > 0) ? fontWeight : @"";
+  NSString *key =
+      [NSString stringWithFormat:@"%.1f|%@|%@|%.2f", fontSize, fontFamily ?: @"", weightKey, effectiveMultiplier];
+
+  UIFont *cached = _fontCache[key];
+  if (cached) {
+    return cached;
+  }
+
+  NSString *effectiveWeight = (fontWeight.length > 0) ? fontWeight : nil;
+
+  UIFont *font = [RCTFont updateFont:nil
+                          withFamily:fontFamily
+                                size:@(fontSize)
+                              weight:effectiveWeight
+                               style:nil
+                             variant:nil
+                     scaleMultiplier:effectiveMultiplier];
+
+  if (font) {
+    _fontCache[key] = font;
+  }
+  return font;
+}
+
+#pragma mark - Paragraph Style Factory
+
+- (NSMutableParagraphStyle *)spacerStyleWithHeight:(CGFloat)height spacing:(CGFloat)spacing
+{
+  NSMutableParagraphStyle *style = [_baseSpacerTemplate mutableCopy];
+  style.minimumLineHeight = height;
+  style.maximumLineHeight = height;
+  style.paragraphSpacing = spacing;
+  return style;
+}
+
+- (NSMutableParagraphStyle *)blockSpacerStyleWithMargin:(CGFloat)margin
+{
+  NSMutableParagraphStyle *style = [_baseBlockSpacerTemplate mutableCopy];
+  style.paragraphSpacing = margin;
+  return style;
+}
+
+#pragma mark - Link Registry
+
+- (void)registerLinkRange:(NSRange)range url:(NSString *)url
+{
+  if (range.length == 0)
+    return;
+  [self.linkRanges addObject:[NSValue valueWithRange:range]];
+  [self.linkURLs addObject:url ?: @""];
+}
+
+- (void)registerHeadingRange:(NSRange)range level:(NSInteger)level text:(NSString *)text
+{
+  if (range.length == 0)
+    return;
+  [self.headingRanges addObject:[NSValue valueWithRange:range]];
+  [self.headingLevels addObject:@(level)];
+}
+
+- (void)registerImageRange:(NSRange)range altText:(NSString *)altText url:(NSString *)url
+{
+  if (range.length == 0)
+    return;
+  [self.imageRanges addObject:[NSValue valueWithRange:range]];
+  [self.imageAltTexts addObject:altText ?: @""];
+  [self.imageURLs addObject:url ?: @""];
+}
+
+#pragma mark - Registration Helpers
+
+- (void)registerListItemRange:(NSRange)range
+                     position:(NSInteger)position
+                        depth:(NSInteger)depth
+                    isOrdered:(BOOL)isOrdered
+{
+  if (![self isValidRange:range])
+    return;
+
+  [self.listItemRanges addObject:[NSValue valueWithRange:range]];
+  [self.listItemPositions addObject:@(position)];
+  [self.listItemDepths addObject:@(depth)];
+  [self.listItemOrdered addObject:@(isOrdered)];
+}
+
+#pragma mark - Private
+
+- (BOOL)isValidRange:(NSRange)range
+{
+  return range.length > 0 && range.location != NSNotFound;
+}
+
+#pragma mark - Block Style Management
+
+/**
+ * Updates the shared BlockStyle object with new traits.
+ * This avoids allocating a new object for every block node in the AST.
+ */
+- (void)setBlockStyle:(BlockType)type
+             fontSize:(CGFloat)fontSize
+           fontFamily:(NSString *)fontFamily
+           fontWeight:(NSString *)fontWeight
+                color:(UIColor *)color
+         headingLevel:(NSInteger)headingLevel
+{
+  _currentBlockType = type;
+  _currentHeadingLevel = headingLevel;
+
+  _currentBlockStyle.fontSize = fontSize;
+  _currentBlockStyle.fontFamily = fontFamily ?: @"";
+  _currentBlockStyle.fontWeight = fontWeight ?: @"normal";
+  _currentBlockStyle.color = color ?: [UIColor blackColor];
+}
+
+- (void)setBlockStyle:(BlockType)type
+             fontSize:(CGFloat)fontSize
+           fontFamily:(NSString *)fontFamily
+           fontWeight:(NSString *)fontWeight
+                color:(UIColor *)color
+{
+  [self setBlockStyle:type fontSize:fontSize fontFamily:fontFamily fontWeight:fontWeight color:color headingLevel:0];
+}
+
+- (void)setBlockStyle:(BlockType)type font:(UIFont *)font color:(UIColor *)color headingLevel:(NSInteger)headingLevel
+{
+  _currentBlockType = type;
+  _currentHeadingLevel = headingLevel;
+
+  UIColor *finalColor = color ?: [UIColor blackColor];
+  _currentBlockStyle.cachedFont = font;
+  _currentBlockStyle.color = finalColor;
+
+  // Pre-create text attributes dictionary if we have both font and color
+  if (font) {
+    _currentBlockStyle.cachedTextAttributes =
+        @{NSFontAttributeName : font, NSForegroundColorAttributeName : finalColor};
+  }
+}
+
+- (BlockStyle *)getBlockStyle
+{
+  return _currentBlockStyle;
+}
+
+- (NSDictionary *)getTextAttributes
+{
+  BlockStyle *style = _currentBlockStyle;
+
+  // Return pre-cached attributes if available
+  if (style.cachedTextAttributes) {
+    return style.cachedTextAttributes;
+  }
+
+  // Fall back to creating attributes from font cache
+  UIFont *font = style.cachedFont;
+  if (!font) {
+    font = [self cachedFontForSize:style.fontSize family:style.fontFamily weight:style.fontWeight];
+  }
+  UIColor *color = style.color ?: [UIColor blackColor];
+
+  // Cache for future calls within same block
+  style.cachedTextAttributes = @{NSFontAttributeName : font, NSForegroundColorAttributeName : color};
+  return style.cachedTextAttributes;
+}
+
+- (void)clearBlockStyle
+{
+  _currentBlockType = BlockTypeNone;
+  _currentHeadingLevel = 0;
+  _currentBlockStyle.cachedFont = nil;
+  _currentBlockStyle.cachedTextAttributes = nil;
+}
+
+#pragma mark - Reset
+
+- (void)reset
+{
+  [_linkRanges removeAllObjects];
+  [_linkURLs removeAllObjects];
+  [_headingRanges removeAllObjects];
+  [_headingLevels removeAllObjects];
+  [_imageRanges removeAllObjects];
+  [_imageAltTexts removeAllObjects];
+  [_imageURLs removeAllObjects];
+  [_listItemRanges removeAllObjects];
+  [_listItemPositions removeAllObjects];
+  [_listItemDepths removeAllObjects];
+  [_listItemOrdered removeAllObjects];
+  [self clearBlockStyle];
+
+  _blockquoteDepth = 0;
+  _listDepth = 0;
+  _listType = ListTypeUnordered;
+  _listItemNumber = 0;
+
+  // Revert shared style object to baseline defaults
+  _currentBlockStyle.fontSize = 0;
+  _currentBlockStyle.fontFamily = @"";
+  _currentBlockStyle.fontWeight = @"";
+  _currentBlockStyle.color = [UIColor blackColor];
+}
+
+#pragma mark - Static Utilities
+
+/**
+ * Determines if specific inline attributes should protect the current color.
+ */
++ (BOOL)shouldPreserveColors:(NSDictionary *)attrs
+{
+  return (attrs[NSLinkAttributeName] != nil || attrs[CodeAttributeName] != nil);
+}
+
+/**
+ * Calculates whether a strong color should override the block color.
+ */
++ (UIColor *)calculateStrongColor:(UIColor *)configStrongColor blockColor:(UIColor *)blockColor
+{
+  if (!configStrongColor || [configStrongColor isEqual:blockColor]) {
+    return blockColor;
+  }
+  return configStrongColor;
+}
+
+/**
+ * Safely calculates a range based on a start point and the current output length.
+ */
++ (NSRange)rangeForRenderedContent:(NSMutableAttributedString *)output start:(NSUInteger)start
+{
+  if (output.length < start)
+    return NSMakeRange(start, 0);
+  return NSMakeRange(start, output.length - start);
+}
+
+/**
+ * Surgically applies attributes only if they differ from current values.
+ * This minimizes "dirtying" the AttributedString, which improves layout performance.
+ */
++ (void)applyFontAndColorAttributes:(NSMutableAttributedString *)output
+                              range:(NSRange)range
+                               font:(UIFont *)font
+                              color:(UIColor *)color
+                 existingAttributes:(NSDictionary *)attrs
+               shouldPreserveColors:(BOOL)shouldPreserve
+{
+  if (range.length == 0)
+    return;
+
+  // Font Update: Only if it exists and is different
+  if (font && ![font isEqual:attrs[NSFontAttributeName]]) {
+    [output addAttribute:NSFontAttributeName value:font range:range];
+  }
+
+  // Color Update: Only if not a link/code and different from existing
+  if (color && !shouldPreserve && ![color isEqual:attrs[NSForegroundColorAttributeName]]) {
+    [output addAttribute:NSForegroundColorAttributeName value:color range:range];
+  }
+}
+
+@end

package/ios/renderer/RendererFactory.h

@@ -0,0 +1,12 @@
+#import "MarkdownASTNode.h"
+#import "NodeRenderer.h"
+
+@class RenderContext;
+
+@interface RendererFactory : NSObject
+- (instancetype)initWithConfig:(id)config;
+- (id<NodeRenderer>)rendererForNodeType:(MarkdownNodeType)type;
+- (void)renderChildrenOfNode:(MarkdownASTNode *)node
+                        into:(NSMutableAttributedString *)output
+                     context:(RenderContext *)context;
+@end

package/ios/renderer/RendererFactory.m

@@ -0,0 +1,116 @@
+#import "RendererFactory.h"
+#import "BlockquoteRenderer.h"
+#import "CodeBlockRenderer.h"
+#import "CodeRenderer.h"
+#import "EmphasisRenderer.h"
+#import "HeadingRenderer.h"
+#import "ImageRenderer.h"
+#import "LinkRenderer.h"
+#import "ListItemRenderer.h"
+#import "ListRenderer.h"
+#import "ParagraphRenderer.h"
+#import "RenderContext.h"
+#import "StrikethroughRenderer.h"
+#import "StrongRenderer.h"
+#import "StyleConfig.h"
+#import "TextRenderer.h"
+#import "ThematicBreakRenderer.h"
+#import "UnderlineRenderer.h"
+
+@implementation RendererFactory {
+  StyleConfig *_config;
+  NSMutableDictionary<NSNumber *, id<NodeRenderer>> *_cache;
+}
+
+/**
+ * Initializes the factory with a shared style configuration.
+ * Uses a mutable dictionary to cache renderer instances as they are needed.
+ */
+- (instancetype)initWithConfig:(StyleConfig *)config
+{
+  self = [super init];
+  if (self) {
+    _config = config;
+    _cache = [NSMutableDictionary new];
+  }
+  return self;
+}
+
+/**
+ * Returns a shared renderer instance for a specific node type.
+ * Implements lazy initialization to avoid allocating unused renderers.
+ */
+- (id<NodeRenderer>)rendererForNodeType:(MarkdownNodeType)type
+{
+  id<NodeRenderer> cached = _cache[@(type)];
+  if (cached) {
+    return cached;
+  }
+
+  id<NodeRenderer> renderer = [self createRendererForType:type];
+  if (renderer) {
+    _cache[@(type)] = renderer;
+  }
+  return renderer;
+}
+
+/**
+ * Internal factory method to instantiate specialized renderers.
+ */
+- (id<NodeRenderer>)createRendererForType:(MarkdownNodeType)type
+{
+  switch (type) {
+    case MarkdownNodeTypeText:
+      return [TextRenderer new];
+    case MarkdownNodeTypeStrong:
+      return [[StrongRenderer alloc] initWithRendererFactory:self config:_config];
+    case MarkdownNodeTypeEmphasis:
+      return [[EmphasisRenderer alloc] initWithRendererFactory:self config:_config];
+    case MarkdownNodeTypeStrikethrough:
+      return [[StrikethroughRenderer alloc] initWithRendererFactory:self config:_config];
+    case MarkdownNodeTypeUnderline:
+      return [[UnderlineRenderer alloc] initWithRendererFactory:self config:_config];
+    case MarkdownNodeTypeParagraph:
+      return [[ParagraphRenderer alloc] initWithRendererFactory:self config:_config];
+    case MarkdownNodeTypeLink:
+      return [[LinkRenderer alloc] initWithRendererFactory:self config:_config];
+    case MarkdownNodeTypeHeading:
+      return [[HeadingRenderer alloc] initWithRendererFactory:self config:_config];
+    case MarkdownNodeTypeCode:
+      return [[CodeRenderer alloc] initWithRendererFactory:self config:_config];
+    case MarkdownNodeTypeImage:
+      return [[ImageRenderer alloc] initWithRendererFactory:self config:_config];
+    case MarkdownNodeTypeBlockquote:
+      return [[BlockquoteRenderer alloc] initWithRendererFactory:self config:_config];
+    case MarkdownNodeTypeListItem:
+      return [[ListItemRenderer alloc] initWithRendererFactory:self config:_config];
+    case MarkdownNodeTypeUnorderedList:
+      return [[ListRenderer alloc] initWithRendererFactory:self config:_config isOrdered:NO];
+    case MarkdownNodeTypeOrderedList:
+      return [[ListRenderer alloc] initWithRendererFactory:self config:_config isOrdered:YES];
+    case MarkdownNodeTypeCodeBlock:
+      return [[CodeBlockRenderer alloc] initWithRendererFactory:self config:_config];
+    case MarkdownNodeTypeThematicBreak:
+      return [[ThematicBreakRenderer alloc] initWithRendererFactory:self config:_config];
+    default:
+      return nil;
+  }
+}
+
+/**
+ * Helper method for container renderers to process their children.
+ * Leverages the factory to find the appropriate renderer for each child node.
+ */
+- (void)renderChildrenOfNode:(MarkdownASTNode *)node
+                        into:(NSMutableAttributedString *)output
+                     context:(RenderContext *)context
+{
+  for (MarkdownASTNode *child in node.children) {
+    id<NodeRenderer> renderer = [self rendererForNodeType:child.type];
+    if (renderer) {
+      [renderer renderNode:child into:output context:context];
+    }
+  }
+}
+
+@end

package/ios/renderer/StrikethroughRenderer.h

@@ -0,0 +1,6 @@
+#pragma once
+#import "NodeRenderer.h"
+
+@interface StrikethroughRenderer : NSObject <NodeRenderer>
+- (instancetype)initWithRendererFactory:(id)rendererFactory config:(id)config;
+@end

package/ios/renderer/StrikethroughRenderer.m

@@ -0,0 +1,40 @@
+#import "StrikethroughRenderer.h"
+#import "MarkdownASTNode.h"
+#import "RenderContext.h"
+#import "RendererFactory.h"
+#import "StyleConfig.h"
+
+@implementation StrikethroughRenderer {
+  RendererFactory *_rendererFactory;
+  StyleConfig *_config;
+}
+
+- (instancetype)initWithRendererFactory:(id)rendererFactory config:(id)config
+{
+  if (self = [super init]) {
+    _rendererFactory = rendererFactory;
+    _config = (StyleConfig *)config;
+  }
+  return self;
+}
+
+#pragma mark - Rendering
+
+- (void)renderNode:(MarkdownASTNode *)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;
+
+  // Apply strikethrough style
+  [output addAttribute:NSStrikethroughStyleAttributeName value:@(NSUnderlineStyleSingle) range:range];
+
+  // Apply strikethrough line color (not text color)
+  UIColor *strikethroughColor = [_config strikethroughColor];
+  [output addAttribute:NSStrikethroughColorAttributeName value:strikethroughColor range:range];
+}
+
+@end

package/ios/renderer/StrongRenderer.h

@@ -0,0 +1,6 @@
+#pragma once
+#import "NodeRenderer.h"
+
+@interface StrongRenderer : NSObject <NodeRenderer>
+- (instancetype)initWithRendererFactory:(id)rendererFactory config:(id)config;
+@end

package/ios/renderer/StrongRenderer.m

@@ -0,0 +1,83 @@
+#import "StrongRenderer.h"
+#import "FontUtils.h"
+#import "MarkdownASTNode.h"
+#import "RenderContext.h"
+#import "RendererFactory.h"
+#import "StyleConfig.h"
+
+@implementation StrongRenderer {
+  RendererFactory *_rendererFactory;
+  StyleConfig *_config;
+}
+
+- (instancetype)initWithRendererFactory:(id)rendererFactory config:(id)config
+{
+  if (self = [super init]) {
+    _rendererFactory = rendererFactory;
+    _config = (StyleConfig *)config;
+  }
+  return self;
+}
+
+#pragma mark - Rendering
+
+- (void)renderNode:(MarkdownASTNode *)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];
+  UIColor *configStrongColor = [_config strongColor];
+  UIColor *calculatedColor =
+      configStrongColor ? [RenderContext calculateStrongColor:configStrongColor blockColor:blockStyle.color] : nil;
+
+  [output enumerateAttributesInRange:range
+                             options:NSAttributedStringEnumerationLongestEffectiveRangeNotRequired
+                          usingBlock:^(NSDictionary<NSAttributedStringKey, id> *attrs, NSRange subrange, BOOL *stop) {
+                            // 1. Resolve Font
+                            UIFont *currentFont =
+                                attrs[NSFontAttributeName] ?: cachedFontFromBlockStyle(blockStyle, context);
+
+                            // Optimization: Only apply bold if not already bold
+                            if (!([currentFont.fontDescriptor symbolicTraits] & UIFontDescriptorTraitBold)) {
+                              UIFont *boldFont = [self ensureFontIsBold:currentFont];
+                              if (boldFont) {
+                                [output addAttribute:NSFontAttributeName value:boldFont range:subrange];
+                              }
+                            }
+
+                            // 2. Resolve Color
+                            // Only apply if we have a color and the current segment doesn't explicitly forbid overrides
+                            if (calculatedColor && ![RenderContext shouldPreserveColors:attrs]) {
+                              // Optimization: Check if this color is already set to avoid redundant attribute changes
+                              if (![attrs[NSForegroundColorAttributeName] isEqual:calculatedColor]) {
+                                [output addAttribute:NSForegroundColorAttributeName
+                                               value:calculatedColor
+                                               range:subrange];
+                              }
+                            }
+                          }];
+}
+
+#pragma mark - Helper Methods
+
+- (UIFont *)ensureFontIsBold:(UIFont *)font
+{
+  if (!font)
+    return nil;
+
+  UIFontDescriptor *descriptor = font.fontDescriptor;
+  UIFontDescriptorSymbolicTraits traits = descriptor.symbolicTraits;
+
+  // Create new descriptor combining current traits with Bold
+  UIFontDescriptor *boldDescriptor = [descriptor fontDescriptorWithSymbolicTraits:(traits | UIFontDescriptorTraitBold)];
+
+  // Fallback to original font if bold version is unavailable
+  return boldDescriptor ? [UIFont fontWithDescriptor:boldDescriptor size:0] : font;
+}
+
+@end

package/ios/renderer/TextRenderer.h

@@ -0,0 +1,6 @@
+#import "MarkdownASTNode.h"
+#import "NodeRenderer.h"
+#import "RenderContext.h"
+
+@interface TextRenderer : NSObject <NodeRenderer>
+@end

package/ios/renderer/TextRenderer.m

@@ -0,0 +1,16 @@
+#import "TextRenderer.h"
+#import "RenderContext.h"
+
+@implementation TextRenderer
+
+- (void)renderNode:(MarkdownASTNode *)node into:(NSMutableAttributedString *)output context:(RenderContext *)context
+{
+  if (!node.content)
+    return;
+
+  NSAttributedString *text = [[NSAttributedString alloc] initWithString:node.content
+                                                             attributes:[context getTextAttributes]];
+  [output appendAttributedString:text];
+}
+
+@end

package/ios/renderer/ThematicBreakRenderer.h

@@ -0,0 +1,5 @@
+#import "NodeRenderer.h"
+
+@interface ThematicBreakRenderer : NSObject <NodeRenderer>
+- (instancetype)initWithRendererFactory:(id)rendererFactory config:(id)config;
+@end

package/ios/renderer/ThematicBreakRenderer.m

@@ -0,0 +1,53 @@
+#import "ThematicBreakRenderer.h"
+#import "MarkdownASTNode.h"
+#import "StyleConfig.h"
+#import "ThematicBreakAttachment.h"
+
+#pragma mark - Renderer Implementation
+
+@implementation ThematicBreakRenderer {
+  __weak id _rendererFactory;
+  StyleConfig *_config;
+}
+
+- (instancetype)initWithRendererFactory:(id)rendererFactory config:(id)config
+{
+  self = [super init];
+  if (self) {
+    _rendererFactory = rendererFactory;
+    _config = (StyleConfig *)config;
+  }
+  return self;
+}
+
+- (void)renderNode:(MarkdownASTNode *)node into:(NSMutableAttributedString *)output context:(RenderContext *)context
+{
+  [self ensureStartingNewline:output];
+
+  ThematicBreakAttachment *attachment = [[ThematicBreakAttachment alloc] init];
+  attachment.lineColor = _config.thematicBreakColor ?: [UIColor separatorColor];
+  attachment.lineHeight = _config.thematicBreakHeight > 0 ? _config.thematicBreakHeight : 1.0;
+  attachment.marginTop = _config.thematicBreakMarginTop;
+  attachment.marginBottom = _config.thematicBreakMarginBottom;
+
+  NSDictionary *attributes = @{
+    NSAttachmentAttributeName : attachment,
+    NSParagraphStyleAttributeName : [NSParagraphStyle defaultParagraphStyle]
+  };
+
+  NSAttributedString *breakString = [[NSAttributedString alloc] initWithString:@"\uFFFC" attributes:attributes];
+
+  [output appendAttributedString:breakString];
+  [output appendAttributedString:[[NSAttributedString alloc] initWithString:@"\n"]];
+}
+
+#pragma mark - Private Utilities
+
+- (void)ensureStartingNewline:(NSMutableAttributedString *)output
+{
+  if (output.length > 0 && ![output.string hasSuffix:@"\n"]) {
+    [output appendAttributedString:[[NSAttributedString alloc] initWithString:@"\n"]];
+  }
+}
+
+@end

package/ios/renderer/UnderlineRenderer.h

@@ -0,0 +1,6 @@
+#import "NodeRenderer.h"
+#import <Foundation/Foundation.h>
+
+@interface UnderlineRenderer : NSObject <NodeRenderer>
+- (instancetype)initWithRendererFactory:(id)rendererFactory config:(id)config;
+@end