react-native-enriched-markdown-scaffold 0.6.0-scaffold.4

package/ios/utils/AccessibilityInfo.h

@@ -0,0 +1,35 @@
+#import <Foundation/Foundation.h>
+
+@class RenderContext;
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ * Container for accessibility-related data extracted from RenderContext.
+ * Used by MarkdownAccessibilityElementBuilder to build VoiceOver elements.
+ */
+@interface AccessibilityInfo : NSObject
+
+// Headings
+@property (nonatomic, copy, readonly) NSArray<NSValue *> *headingRanges;
+@property (nonatomic, copy, readonly) NSArray<NSNumber *> *headingLevels;
+
+// Links
+@property (nonatomic, copy, readonly) NSArray<NSValue *> *linkRanges;
+@property (nonatomic, copy, readonly) NSArray<NSString *> *linkURLs;
+
+// Images
+@property (nonatomic, copy, readonly) NSArray<NSValue *> *imageRanges;
+@property (nonatomic, copy, readonly) NSArray<NSString *> *imageAltTexts;
+
+// List items
+@property (nonatomic, copy, readonly) NSArray<NSValue *> *listItemRanges;
+@property (nonatomic, copy, readonly) NSArray<NSNumber *> *listItemPositions;
+@property (nonatomic, copy, readonly) NSArray<NSNumber *> *listItemDepths;
+@property (nonatomic, copy, readonly) NSArray<NSNumber *> *listItemOrdered; // YES = ordered, NO = bullet
+
++ (instancetype)infoFromContext:(RenderContext *)context;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/utils/AccessibilityInfo.m

@@ -0,0 +1,24 @@
+#import "AccessibilityInfo.h"
+#import "RenderContext.h"
+
+@implementation AccessibilityInfo
+
++ (instancetype)infoFromContext:(RenderContext *)context
+{
+  AccessibilityInfo *info = [[AccessibilityInfo alloc] init];
+  if (info) {
+    info->_headingRanges = [context.headingRanges copy];
+    info->_headingLevels = [context.headingLevels copy];
+    info->_linkRanges = [context.linkRanges copy];
+    info->_linkURLs = [context.linkURLs copy];
+    info->_imageRanges = [context.imageRanges copy];
+    info->_imageAltTexts = [context.imageAltTexts copy];
+    info->_listItemRanges = [context.listItemRanges copy];
+    info->_listItemPositions = [context.listItemPositions copy];
+    info->_listItemDepths = [context.listItemDepths copy];
+    info->_listItemOrdered = [context.listItemOrdered copy];
+  }
+  return info;
+}
+
+@end

package/ios/utils/BlockquoteBorder.h

@@ -0,0 +1,20 @@
+#pragma once
+#import "ENRMUIKit.h"
+#import "StyleConfig.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+extern NSString *const BlockquoteDepthAttributeName;
+extern NSString *const BlockquoteBackgroundColorAttributeName;
+
+@interface BlockquoteBorder : NSObject
+
+- (instancetype)initWithConfig:(StyleConfig *)config;
+- (void)drawBordersForGlyphRange:(NSRange)glyphsToShow
+                   layoutManager:(NSLayoutManager *)layoutManager
+                   textContainer:(NSTextContainer *)textContainer
+                         atPoint:(CGPoint)origin;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/utils/BlockquoteBorder.m

@@ -0,0 +1,97 @@
+#import "BlockquoteBorder.h"
+#import "ParagraphStyleUtils.h"
+#import "StyleConfig.h"
+
+// Attribute constants for identifying blockquote segments in text storage
+NSString *const BlockquoteDepthAttributeName = @"BlockquoteDepth";
+NSString *const BlockquoteBackgroundColorAttributeName = @"BlockquoteBackgroundColor";
+
+@implementation BlockquoteBorder {
+  StyleConfig *_config;
+}
+
+- (instancetype)initWithConfig:(StyleConfig *)config
+{
+  if (self = [super init]) {
+    _config = config;
+  }
+  return self;
+}
+
+/**
+ * Main drawing entry point called by the LayoutManager.
+ * Iterates through line fragments to draw backgrounds and borders for nested blockquotes.
+ */
+- (void)drawBordersForGlyphRange:(NSRange)glyphsToShow
+                   layoutManager:(NSLayoutManager *)layoutManager
+                   textContainer:(NSTextContainer *)textContainer
+                         atPoint:(CGPoint)origin
+{
+  NSTextStorage *textStorage = layoutManager.textStorage;
+  if (!textStorage || textStorage.length == 0) {
+    return;
+  }
+
+  // Cache configuration values to minimize pointer chasing and method lookups in the loop
+  StyleConfig *c = _config;
+  CGFloat borderWidth = c.blockquoteBorderWidth;
+  CGFloat gapWidth = c.blockquoteGapWidth;
+  CGFloat levelSpacing = borderWidth + gapWidth;
+  CGFloat containerWidth = textContainer.size.width;
+  RCTUIColor *defaultBgColor = c.blockquoteBackgroundColor;
+  RCTUIColor *borderColor = c.blockquoteBorderColor;
+
+  UIBezierPath *borderPath = [UIBezierPath bezierPath];
+
+  [layoutManager
+      enumerateLineFragmentsForGlyphRange:glyphsToShow
+                               usingBlock:^(CGRect rect, CGRect usedRect, NSTextContainer *container,
+                                            NSRange glyphRange, BOOL *stop) {
+                                 // Map the glyph range back to character indices to retrieve attributes
+                                 NSRange charRange = [layoutManager characterRangeForGlyphRange:glyphRange
+                                                                               actualGlyphRange:NULL];
+                                 if (charRange.location == NSNotFound || charRange.length == 0) {
+                                   return;
+                                 }
+
+                                 // Perform a single attribute lookup for the current line fragment
+                                 NSDictionary *attrs = [textStorage attributesAtIndex:charRange.location
+                                                                       effectiveRange:NULL];
+                                 NSNumber *depthNum = attrs[BlockquoteDepthAttributeName];
+
+                                 // If no depth is found, this fragment is not part of a blockquote
+                                 if (!depthNum) {
+                                   return;
+                                 }
+
+                                 NSInteger depth = [depthNum integerValue];
+                                 CGFloat baseY = origin.y + rect.origin.y;
+                                 BOOL isRTL = ENRMParagraphIsRTL(attrs[NSParagraphStyleAttributeName]);
+
+                                 // 1. Draw Background (Painter's algorithm: draw backgrounds before borders)
+                                 RCTUIColor *bgColor = attrs[BlockquoteBackgroundColorAttributeName] ?: defaultBgColor;
+                                 if (bgColor && bgColor != [RCTUIColor clearColor]) {
+                                   CGContextRef ctx = UIGraphicsGetCurrentContext();
+                                   [bgColor setFill];
+                                   CGContextFillRect(ctx,
+                                                     CGRectMake(origin.x, baseY, containerWidth, rect.size.height));
+                                 }
+
+                                 // 2. Aggregate vertical borders into the batch path
+                                 for (NSInteger level = 0; level <= depth; level++) {
+                                   CGFloat borderX =
+                                       isRTL ? origin.x + containerWidth - borderWidth - (levelSpacing * level)
+                                             : origin.x + (levelSpacing * level);
+                                   CGRect borderRect = CGRectMake(borderX, baseY, borderWidth, rect.size.height);
+                                   UIBezierPathAppendPath(borderPath, [UIBezierPath bezierPathWithRect:borderRect]);
+                                 }
+                               }];
+
+  // 3. Perform a single batch fill for all borders
+  if (!borderPath.isEmpty) {
+    [borderColor setFill];
+    [borderPath fill];
+  }
+}
+
+@end

package/ios/utils/CodeBackground.h

@@ -0,0 +1,19 @@
+#pragma once
+#import "ENRMUIKit.h"
+#import "StyleConfig.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+extern NSString *const CodeAttributeName;
+
+@interface CodeBackground : NSObject
+
+- (instancetype)initWithConfig:(StyleConfig *)config;
+- (void)drawBackgroundsForGlyphRange:(NSRange)glyphsToShow
+                       layoutManager:(NSLayoutManager *)layoutManager
+                       textContainer:(NSTextContainer *)textContainer
+                             atPoint:(CGPoint)origin;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/utils/CodeBackground.m

@@ -0,0 +1,197 @@
+#import "CodeBackground.h"
+#import "ENRMUIKit.h"
+#import "RenderContext.h"
+
+NSString *const CodeAttributeName = @"Code";
+
+static const CGFloat kCodeBackgroundCornerRadius = 2.0;
+static const CGFloat kCodeBackgroundBorderWidth = 0.5;
+
+@implementation CodeBackground {
+  StyleConfig *_config;
+}
+
+- (instancetype)initWithConfig:(StyleConfig *)config
+{
+  self = [super init];
+  if (self) {
+    _config = config;
+  }
+  return self;
+}
+
+- (void)drawBackgroundsForGlyphRange:(NSRange)glyphsToShow
+                       layoutManager:(NSLayoutManager *)layoutManager
+                       textContainer:(NSTextContainer *)textContainer
+                             atPoint:(CGPoint)origin
+{
+  RCTUIColor *backgroundColor = _config.codeBackgroundColor;
+  if (!backgroundColor)
+    return;
+
+  NSTextStorage *textStorage = layoutManager.textStorage;
+  NSRange charRange = [layoutManager characterRangeForGlyphRange:glyphsToShow actualGlyphRange:NULL];
+  if (charRange.location == NSNotFound || charRange.length == 0)
+    return;
+
+  [textStorage enumerateAttribute:CodeAttributeName
+                          inRange:NSMakeRange(0, textStorage.length)
+                          options:0
+                       usingBlock:^(id value, NSRange range, BOOL *stop) {
+                         if (!value || range.length == 0)
+                           return;
+                         if (NSIntersectionRange(range, charRange).length == 0)
+                           return;
+
+                         [self drawCodeBackgroundForRange:range
+                                            layoutManager:layoutManager
+                                            textContainer:textContainer
+                                                  atPoint:origin
+                                          backgroundColor:backgroundColor
+                                              borderColor:self->_config.codeBorderColor];
+                       }];
+}
+
+- (void)drawCodeBackgroundForRange:(NSRange)range
+                     layoutManager:(NSLayoutManager *)layoutManager
+                     textContainer:(NSTextContainer *)textContainer
+                           atPoint:(CGPoint)origin
+                   backgroundColor:(RCTUIColor *)backgroundColor
+                       borderColor:(RCTUIColor *)borderColor
+{
+  NSRange glyphRange = [layoutManager glyphRangeForCharacterRange:range actualCharacterRange:NULL];
+  if (glyphRange.location == NSNotFound || glyphRange.length == 0)
+    return;
+
+  CGFloat referenceHeight = [self findReferenceHeightForRange:range textStorage:layoutManager.textStorage];
+
+  [layoutManager
+      enumerateLineFragmentsForGlyphRange:glyphRange
+                               usingBlock:^(CGRect rect, CGRect usedRect, NSTextContainer *tc, NSRange lineRange,
+                                            BOOL *stop) {
+                                 NSRange intersect = NSIntersectionRange(lineRange, glyphRange);
+                                 if (intersect.length == 0)
+                                   return;
+
+                                 BOOL isFirst = (intersect.location == glyphRange.location);
+                                 BOOL isLast = (NSMaxRange(intersect) == NSMaxRange(glyphRange));
+
+                                 CGRect finalRect;
+                                 if (isFirst || isLast) {
+                                   // Precise bounds are only required for the start and end of the span
+                                   CGRect textRect = [layoutManager boundingRectForGlyphRange:intersect
+                                                                              inTextContainer:textContainer];
+                                   finalRect = CGRectMake(textRect.origin.x + origin.x, textRect.origin.y + origin.y,
+                                                          textRect.size.width, textRect.size.height);
+
+                                   // For multi-line, extend the first line to the right edge of the fragment
+                                   if (isFirst && !isLast) {
+                                     finalRect.size.width =
+                                         (usedRect.origin.x + usedRect.size.width + origin.x) - finalRect.origin.x;
+                                   }
+                                 } else {
+                                   // OPTIMIZATION: Middle lines use the usedRect of the fragment directly
+                                   finalRect = CGRectMake(usedRect.origin.x + origin.x, usedRect.origin.y + origin.y,
+                                                          usedRect.size.width, usedRect.size.height);
+                                 }
+
+                                 // Ensure consistent height and no gaps
+                                 if (finalRect.size.height < referenceHeight) {
+                                   finalRect.size.height = referenceHeight;
+                                 }
+
+                                 [self drawBackgroundAndBorders:finalRect
+                                                backgroundColor:backgroundColor
+                                                    borderColor:borderColor
+                                                        isFirst:isFirst
+                                                         isLast:isLast];
+                               }];
+}
+
+#pragma mark - Drawing Logic
+
+- (void)drawBackgroundAndBorders:(CGRect)rect
+                 backgroundColor:(RCTUIColor *)backgroundColor
+                     borderColor:(RCTUIColor *)borderColor
+                         isFirst:(BOOL)isFirst
+                          isLast:(BOOL)isLast
+{
+  UIBezierPath *path = [self pathForRect:rect isFirst:isFirst isLast:isLast];
+  [backgroundColor setFill];
+  [path fill];
+
+  if (borderColor) {
+    [borderColor setStroke];
+    UIBezierPath *strokePath =
+        (isFirst && isLast) ? path : [self openBorderPathForRect:rect isFirst:isFirst isLast:isLast];
+    strokePath.lineWidth = kCodeBackgroundBorderWidth;
+    BezierPathSetRoundStyle(strokePath);
+    [strokePath stroke];
+  }
+}
+
+- (UIBezierPath *)pathForRect:(CGRect)rect isFirst:(BOOL)isFirst isLast:(BOOL)isLast
+{
+#if !TARGET_OS_OSX
+  UIRectCorner corners = 0;
+  if (isFirst)
+    corners |= (UIRectCornerTopLeft | UIRectCornerBottomLeft);
+  if (isLast)
+    corners |= (UIRectCornerTopRight | UIRectCornerBottomRight);
+
+  return [UIBezierPath bezierPathWithRoundedRect:rect
+                               byRoundingCorners:corners
+                                     cornerRadii:CGSizeMake(kCodeBackgroundCornerRadius, kCodeBackgroundCornerRadius)];
+#else
+  // NSBezierPath doesn't support per-corner rounding — use uniform corner radius
+  CGFloat cornerRadius = (isFirst || isLast) ? kCodeBackgroundCornerRadius : 0;
+  return UIBezierPathWithRoundedRect(rect, cornerRadius);
+#endif
+}
+
+- (UIBezierPath *)openBorderPathForRect:(CGRect)rect isFirst:(BOOL)isFirst isLast:(BOOL)isLast
+{
+  UIBezierPath *path = [UIBezierPath bezierPath];
+  CGFloat r = kCodeBackgroundCornerRadius;
+  CGFloat inset = kCodeBackgroundBorderWidth / 2.0;
+  CGRect insetRect = CGRectInset(rect, inset, inset);
+
+  if (isFirst) {
+    [path moveToPoint:CGPointMake(CGRectGetMaxX(rect), insetRect.origin.y)];
+    BezierPathAddLine(path, CGPointMake(insetRect.origin.x + r, insetRect.origin.y));
+    BezierPathAddQuadCurve(path, CGPointMake(insetRect.origin.x, insetRect.origin.y + r),
+                           CGPointMake(insetRect.origin.x, insetRect.origin.y));
+    BezierPathAddLine(path, CGPointMake(insetRect.origin.x, CGRectGetMaxY(insetRect) - r));
+    BezierPathAddQuadCurve(path, CGPointMake(insetRect.origin.x + r, CGRectGetMaxY(insetRect)),
+                           CGPointMake(insetRect.origin.x, CGRectGetMaxY(insetRect)));
+    BezierPathAddLine(path, CGPointMake(CGRectGetMaxX(rect), CGRectGetMaxY(insetRect)));
+  } else if (isLast) {
+    [path moveToPoint:CGPointMake(rect.origin.x, insetRect.origin.y)];
+    BezierPathAddLine(path, CGPointMake(CGRectGetMaxX(insetRect) - r, insetRect.origin.y));
+    BezierPathAddQuadCurve(path, CGPointMake(CGRectGetMaxX(insetRect), insetRect.origin.y + r),
+                           CGPointMake(CGRectGetMaxX(insetRect), insetRect.origin.y));
+    BezierPathAddLine(path, CGPointMake(CGRectGetMaxX(insetRect), CGRectGetMaxY(insetRect) - r));
+    BezierPathAddQuadCurve(path, CGPointMake(CGRectGetMaxX(insetRect) - r, CGRectGetMaxY(insetRect)),
+                           CGPointMake(CGRectGetMaxX(insetRect), CGRectGetMaxY(insetRect)));
+    BezierPathAddLine(path, CGPointMake(rect.origin.x, CGRectGetMaxY(insetRect)));
+  } else {
+    [path moveToPoint:CGPointMake(rect.origin.x, insetRect.origin.y)];
+    BezierPathAddLine(path, CGPointMake(CGRectGetMaxX(rect), insetRect.origin.y));
+    [path moveToPoint:CGPointMake(rect.origin.x, CGRectGetMaxY(insetRect))];
+    BezierPathAddLine(path, CGPointMake(CGRectGetMaxX(rect), CGRectGetMaxY(insetRect)));
+  }
+  return path;
+}
+
+#pragma mark - Helpers
+
+- (CGFloat)findReferenceHeightForRange:(NSRange)range textStorage:(NSTextStorage *)textStorage
+{
+  if (range.location == NSNotFound || range.length == 0 || !textStorage) {
+    return [_config paragraphFontSize] * 1.2;
+  }
+  NSNumber *lineHeightValue = [textStorage attribute:@"BlockLineHeight" atIndex:range.location effectiveRange:NULL];
+  return lineHeightValue ? [lineHeightValue doubleValue] : ([_config paragraphFontSize] * 1.2);
+}
+
+@end

package/ios/utils/CodeBlockBackground.h

@@ -0,0 +1,17 @@
+#pragma once
+#import "ENRMUIKit.h"
+#import "StyleConfig.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface CodeBlockBackground : NSObject
+
+- (instancetype)initWithConfig:(StyleConfig *)config;
+- (void)drawBackgroundsForGlyphRange:(NSRange)glyphsToShow
+                       layoutManager:(NSLayoutManager *)layoutManager
+                       textContainer:(NSTextContainer *)textContainer
+                             atPoint:(CGPoint)origin;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/utils/CodeBlockBackground.m

@@ -0,0 +1,89 @@
+#import "CodeBlockBackground.h"
+#import "ENRMUIKit.h"
+#import "LastElementUtils.h"
+#import "StyleConfig.h"
+
+@implementation CodeBlockBackground {
+  StyleConfig *_config;
+}
+
+- (instancetype)initWithConfig:(StyleConfig *)config
+{
+  if (self = [super init]) {
+    _config = config;
+  }
+  return self;
+}
+
+- (void)drawBackgroundsForGlyphRange:(NSRange)glyphsToShow
+                       layoutManager:(NSLayoutManager *)layoutManager
+                       textContainer:(NSTextContainer *)textContainer
+                             atPoint:(CGPoint)origin
+{
+  NSTextStorage *textStorage = layoutManager.textStorage;
+  NSRange charRange = [layoutManager characterRangeForGlyphRange:glyphsToShow actualGlyphRange:NULL];
+
+  // Enumerate over the full storage range so each code block's full rect is drawn.
+  // Restricting to charRange causes partial rects per draw pass, which produces
+  // multiple stacked oval shapes when border radius is large.
+  // The graphics context clip ensures only the visible portion is painted.
+  [textStorage enumerateAttribute:CodeBlockAttributeName
+                          inRange:NSMakeRange(0, textStorage.length)
+                          options:0
+                       usingBlock:^(id value, NSRange range, BOOL *stop) {
+                         if (!value)
+                           return;
+                         if (NSIntersectionRange(range, charRange).length == 0)
+                           return;
+                         [self drawCodeBlockBackgroundForRange:range
+                                                 layoutManager:layoutManager
+                                                 textContainer:textContainer
+                                                       atPoint:origin];
+                       }];
+}
+
+- (void)drawCodeBlockBackgroundForRange:(NSRange)range
+                          layoutManager:(NSLayoutManager *)layoutManager
+                          textContainer:(NSTextContainer *)textContainer
+                                atPoint:(CGPoint)origin
+{
+  NSRange glyphRange = [layoutManager glyphRangeForCharacterRange:range actualCharacterRange:NULL];
+  CGRect blockRect = [layoutManager boundingRectForGlyphRange:glyphRange inTextContainer:textContainer];
+
+  if (CGRectIsEmpty(blockRect))
+    return;
+
+  blockRect.origin.x = origin.x;
+  blockRect.origin.y += origin.y;
+  blockRect.size.width = textContainer.size.width;
+
+  // We extend the background specifically to cover the bottom padding spacer,
+  // excluding any additional marginBottom applied via measurement.
+  BOOL isLastCodeBlock = (NSMaxRange(range) == layoutManager.textStorage.length);
+  if (isLastCodeBlock) {
+    blockRect.size.height += [_config codeBlockPadding];
+  }
+
+  CGFloat borderWidth = [_config codeBlockBorderWidth];
+  CGFloat borderRadius = [_config codeBlockBorderRadius];
+  CGFloat inset = borderWidth / 2.0;
+
+  CGRect insetRect = CGRectInset(blockRect, inset, inset);
+  UIBezierPath *path = UIBezierPathWithRoundedRect(insetRect, MAX(0, borderRadius - inset));
+
+  CGContextRef ctx = UIGraphicsGetCurrentContext();
+  CGContextSaveGState(ctx);
+  {
+    [[_config codeBlockBackgroundColor] setFill];
+    [path fill];
+
+    if (borderWidth > 0) {
+      [[_config codeBlockBorderColor] setStroke];
+      path.lineWidth = borderWidth;
+      BezierPathSetRoundStyle(path);
+      [path stroke];
+    }
+  }
+  CGContextRestoreGState(ctx);
+}
+@end

package/ios/utils/ContextMenuUtils.h

@@ -0,0 +1,76 @@
+#pragma once
+
+#import "ENRMUIKit.h"
+#import <Foundation/Foundation.h>
+
+#ifdef __cplusplus
+#include <string>
+#include <vector>
+
+template <typename T>
+static bool ENRMContextMenuItemsChanged(const std::vector<T> &oldItems, const std::vector<T> &newItems)
+{
+  if (newItems.size() != oldItems.size()) {
+    return true;
+  }
+  for (size_t i = 0; i < newItems.size(); i++) {
+    if (newItems[i].text != oldItems[i].text || newItems[i].icon != oldItems[i].icon) {
+      return true;
+    }
+  }
+  return false;
+}
+
+template <typename T> static NSArray<NSString *> *ENRMContextMenuTextsFromItems(const std::vector<T> &items)
+{
+  NSMutableArray<NSString *> *result = [NSMutableArray new];
+  for (const auto &item : items) {
+    [result addObject:[NSString stringWithUTF8String:item.text.c_str()]];
+  }
+  return [result copy];
+}
+
+template <typename T> static NSArray<NSString *> *_Nullable ENRMContextMenuIconsFromItems(const std::vector<T> &items)
+{
+  NSMutableArray<NSString *> *result = [NSMutableArray arrayWithCapacity:items.size()];
+  bool hasAnyIcon = false;
+  for (const auto &item : items) {
+    NSString *iconName = @(item.icon.c_str());
+    hasAnyIcon = hasAnyIcon || iconName.length > 0;
+    [result addObject:iconName];
+  }
+  return hasAnyIcon ? [result copy] : nil;
+}
+
+#endif
+
+typedef void (^ENRMContextMenuPressHandler)(NSString *_Nonnull itemText, NSString *_Nonnull selectedText,
+                                            NSUInteger selectionStart, NSUInteger selectionEnd);
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#if !TARGET_OS_OSX
+
+// TODO: Remove API_AVAILABLE(ios(16.0)) guard when the minimum iOS deployment target in RN is bumped to 16.
+NSMutableArray<UIAction *> *_Nullable ENRMBuildContextMenuActions(NSArray<NSString *> *_Nonnull itemTexts,
+                                                                  NSArray<NSString *> *_Nullable iconNames,
+                                                                  UITextView *_Nonnull textView, NSRange selectedRange,
+                                                                  ENRMContextMenuPressHandler _Nonnull handler)
+    API_AVAILABLE(ios(16.0));
+
+#else
+
+NSArray<NSMenuItem *> *_Nullable ENRMBuildContextMenuItems(NSArray<NSString *> *_Nonnull itemTexts,
+                                                           NSArray<NSString *> *_Nullable iconNames,
+                                                           NSTextView *_Nonnull textView,
+                                                           ENRMContextMenuPressHandler _Nonnull handler);
+
+void ENRMPrependMenuItems(NSMenu *_Nonnull menu, NSArray<NSMenuItem *> *_Nullable items);
+
+#endif
+
+#ifdef __cplusplus
+}
+#endif

package/ios/utils/ContextMenuUtils.mm

@@ -0,0 +1,73 @@
+#import "ContextMenuUtils.h"
+#import "ENRMMenuAction.h"
+
+#if !TARGET_OS_OSX
+
+// TODO: Remove API_AVAILABLE(ios(16.0)) guard when the minimum iOS deployment target in RN is bumped to 16.
+NSMutableArray<UIAction *> *_Nullable ENRMBuildContextMenuActions(NSArray<NSString *> *itemTexts,
+                                                                  NSArray<NSString *> *_Nullable iconNames,
+                                                                  UITextView *textView, NSRange selectedRange,
+                                                                  ENRMContextMenuPressHandler handler)
+    API_AVAILABLE(ios(16.0))
+{
+  if (itemTexts.count == 0) {
+    return nil;
+  }
+
+  NSString *selectedText = [textView.text substringWithRange:selectedRange];
+  NSUInteger selectionStart = selectedRange.location;
+  NSUInteger selectionEnd = NSMaxRange(selectedRange);
+
+  NSMutableArray<UIAction *> *actions = [NSMutableArray arrayWithCapacity:itemTexts.count];
+  [itemTexts enumerateObjectsUsingBlock:^(NSString *itemText, NSUInteger index, BOOL *_) {
+    NSString *iconName = iconNames ? iconNames[index] : nil;
+    UIImage *image = iconName.length > 0 ? [UIImage systemImageNamed:iconName] : nil;
+    [actions addObject:[UIAction actionWithTitle:itemText
+                                           image:image
+                                      identifier:nil
+                                         handler:^(__kindof UIAction *_) {
+                                           handler(itemText, selectedText, selectionStart, selectionEnd);
+                                         }]];
+  }];
+  return actions;
+}
+
+#else
+
+NSArray<NSMenuItem *> *_Nullable ENRMBuildContextMenuItems(NSArray<NSString *> *itemTexts,
+                                                           NSArray<NSString *> *_Nullable iconNames,
+                                                           NSTextView *textView, ENRMContextMenuPressHandler handler)
+{
+  if (itemTexts.count == 0) {
+    return nil;
+  }
+
+  NSRange selectedRange = textView.selectedRange;
+  NSString *selectedText = [textView.string substringWithRange:selectedRange];
+  NSUInteger selectionStart = selectedRange.location;
+  NSUInteger selectionEnd = NSMaxRange(selectedRange);
+
+  NSMutableArray<NSMenuItem *> *items = [NSMutableArray arrayWithCapacity:itemTexts.count];
+  [itemTexts enumerateObjectsUsingBlock:^(NSString *itemText, NSUInteger index, BOOL *_) {
+    NSMenuItem *item =
+        ENRMCreateMenuItem(itemText, ^{ handler(itemText, selectedText, selectionStart, selectionEnd); });
+    NSString *iconName = iconNames ? iconNames[index] : nil;
+    if (iconName.length > 0) {
+      item.image = [NSImage imageWithSystemSymbolName:iconName accessibilityDescription:nil];
+    }
+    [items addObject:item];
+  }];
+  return items;
+}
+
+void ENRMPrependMenuItems(NSMenu *menu, NSArray<NSMenuItem *> *items)
+{
+  if (items.count == 0) {
+    return;
+  }
+  [menu insertItem:[NSMenuItem separatorItem] atIndex:0];
+  [items enumerateObjectsWithOptions:NSEnumerationReverse
+                          usingBlock:^(NSMenuItem *item, NSUInteger _, BOOL *__) { [menu insertItem:item atIndex:0]; }];
+}
+
+#endif

package/ios/utils/ENRMAsyncRenderCoordinator.h

@@ -0,0 +1,24 @@
+#pragma once
+#import <Foundation/Foundation.h>
+
+/// Owns the serial render queue and render-ID counter used by async render pipelines.
+/// Handles stale-result cancellation and main-thread dispatch automatically.
+/// Set blockAsyncRender = YES before synchronous rendering to suppress queued dispatches.
+@interface ENRMAsyncRenderCoordinator : NSObject
+
+@property (nonatomic) BOOL blockAsyncRender;
+
+- (instancetype)initWithQueueLabel:(const char *)label NS_DESIGNATED_INITIALIZER;
+- (instancetype)init NS_UNAVAILABLE;
+
+/// Dispatches renderBlock on the serial queue.
+/// If renderBlock returns YES, applyBlock is dispatched on the main queue,
+/// provided the render ID has not been superseded by a newer call.
+- (void)scheduleRender:(BOOL (^)(void))renderBlock apply:(dispatch_block_t)applyBlock;
+
+/// Advances the render ID so any in-flight render's apply block is discarded
+/// by the renderId == currentRenderId check when it lands on the main queue.
+/// Use before recycling or otherwise resetting a host that owns this coordinator.
+- (void)invalidate;
+
+@end