refactor(ios): simplify accessibility text element creation (#188)

* refactor(ios): simplify accessibility text element creation

* docs: enhance accessibility documentation with text announcements and known issues sections

Author: hryhoriiK97

docs/ACCESSIBILITY.md

@@ -6,6 +6,10 @@
 
 The library implements native accessibility features that enable screen readers (VoiceOver on iOS and TalkBack on Android) to properly navigate and understand Markdown content. This includes semantic labeling, custom navigation controls, and proper announcements for all supported elements.
 
+## Text Announcements
+
+Plain text paragraphs without inline links or images are announced as a single VoiceOver element per paragraph. Paragraphs containing links or images are segmented into text, link, and image parts so that each remains independently navigable. List items follow the same logic — a list item without inline specials is a single element, while one containing a link is split accordingly. Whitespace-only segments between elements are filtered out to avoid empty announcements.
+
 ## Supported Elements
 
 | Element | VoiceOver (iOS) | TalkBack (Android) |
@@ -81,3 +85,7 @@ List items are announced with their position and type:
 **Nested Lists:**
 - iOS: Proper depth handling with semantic structure
 - Android: "Nested" prefix is added for items at deeper levels (e.g., "nested bullet point", "nested list item 1")
+
+## Known Issues
+
+- **Blockquote border with inline links (iOS):** When a blockquote contains inline links, the background/border may break at link boundaries instead of spanning the full line. This is a cosmetic limitation of `NSAttributedString` drawing separate background rects per attribute run and will be addressed in a future update.

ios/utils/MarkdownAccessibilityElementBuilder.m

@@ -37,13 +37,14 @@ @implementation MarkdownAccessibilityElementBuilder
       NSDictionary *list = [self listItemInfoForRange:paragraphRange info:info];
 
       if (specials.count == 0) {
-        [self addTextElementsPerLineTo:elements
-                                 range:paragraphRange
-                              fullText:fullString
-                               heading:level
-                              listInfo:list
-                                  view:textView
-                             container:container];
+        [elements addObject:[self createElementForRange:paragraphRange
+                                                   type:ElementTypeText
+                                                   text:trimmed
+                                               isLinked:NO
+                                                heading:level
+                                               listInfo:list
+                                                   view:textView
+                                              container:container]];
       } else {
         [elements addObjectsFromArray:[self segmentedElementsForParagraph:paragraphRange
                                                                  fullText:fullString
@@ -61,6 +62,14 @@ @implementation MarkdownAccessibilityElementBuilder
 
 #pragma mark - Segmentation
 
++ (BOOL)hasAlphanumericContent:(NSString *)text
+{
+  static NSCharacterSet *alphanumericSet;
+  static dispatch_once_t onceToken;
+  dispatch_once(&onceToken, ^{ alphanumericSet = [NSCharacterSet alphanumericCharacterSet]; });
+  return [text rangeOfCharacterFromSet:alphanumericSet].location != NSNotFound;
+}
+
 + (NSArray<UIAccessibilityElement *> *)segmentedElementsForParagraph:(NSRange)paragraphRange
                                                             fullText:(NSString *)fullText
                                                         headingLevel:(NSInteger)headingLevel
@@ -80,13 +89,18 @@ @implementation MarkdownAccessibilityElementBuilder
 
     if (itemRange.location > segmentStart) {
       NSRange beforeRange = NSMakeRange(segmentStart, itemRange.location - segmentStart);
-      [self addTextElementsPerLineTo:elements
-                               range:beforeRange
-                            fullText:fullText
-                             heading:headingLevel
-                            listInfo:listInfo
-                                view:textView
-                           container:container];
+      NSString *beforeText = [[fullText substringWithRange:beforeRange]
+          stringByTrimmingCharactersInSet:[NSCharacterSet whitespaceAndNewlineCharacterSet]];
+      if (beforeText.length > 0 && [self hasAlphanumericContent:beforeText]) {
+        [elements addObject:[self createElementForRange:beforeRange
+                                                   type:ElementTypeText
+                                                   text:beforeText
+                                               isLinked:NO
+                                                heading:headingLevel
+                                               listInfo:listInfo
+                                                   view:textView
+                                              container:container]];
+      }
     }
 
     BOOL isImg = item[@"altText"] != nil;
@@ -104,18 +118,23 @@ @implementation MarkdownAccessibilityElementBuilder
 
   if (segmentStart < NSMaxRange(paragraphRange)) {
     NSRange afterRange = NSMakeRange(segmentStart, NSMaxRange(paragraphRange) - segmentStart);
-    [self addTextElementsPerLineTo:elements
-                             range:afterRange
-                          fullText:fullText
-                           heading:headingLevel
-                          listInfo:listInfo
-                              view:textView
-                         container:container];
+    NSString *afterText = [[fullText substringWithRange:afterRange]
+        stringByTrimmingCharactersInSet:[NSCharacterSet whitespaceAndNewlineCharacterSet]];
+    if (afterText.length > 0 && [self hasAlphanumericContent:afterText]) {
+      [elements addObject:[self createElementForRange:afterRange
+                                                 type:ElementTypeText
+                                                 text:afterText
+                                             isLinked:NO
+                                              heading:headingLevel
+                                             listInfo:listInfo
+                                                 view:textView
+                                            container:container]];
+    }
   }
   return elements;
 }
 
-#pragma mark - Factory & Precise Splitting
+#pragma mark - Factory
 
 + (UIAccessibilityElement *)createElementForRange:(NSRange)range
                                              type:(ElementType)type
@@ -159,41 +178,6 @@ + (UIAccessibilityElement *)createElementForRange:(NSRange)range
   return el;
 }
 
-+ (void)addTextElementsPerLineTo:(NSMutableArray *)elements
-                           range:(NSRange)range
-                        fullText:(NSString *)fullText
-                         heading:(NSInteger)level
-                        listInfo:(NSDictionary *)listInfo
-                            view:(UITextView *)tv
-                       container:(id)c
-{
-  NSLayoutManager *lm = tv.layoutManager;
-  NSRange glyphRange = [lm glyphRangeForCharacterRange:range actualCharacterRange:NULL];
-
-  [lm enumerateLineFragmentsForGlyphRange:glyphRange
-                               usingBlock:^(CGRect rect, CGRect usedRect, NSTextContainer *tc, NSRange lineGlyphRange,
-                                            BOOL *stop) {
-                                 NSRange intersection = NSIntersectionRange(glyphRange, lineGlyphRange);
-                                 if (intersection.length > 0) {
-                                   NSRange charRange = [lm characterRangeForGlyphRange:intersection
-                                                                      actualGlyphRange:NULL];
-                                   NSString *trimmed = [[fullText substringWithRange:charRange]
-                                       stringByTrimmingCharactersInSet:[NSCharacterSet
-                                                                           whitespaceAndNewlineCharacterSet]];
-                                   if (trimmed.length > 0) {
-                                     [elements addObject:[self createElementForRange:charRange
-                                                                                type:ElementTypeText
-                                                                                text:trimmed
-                                                                            isLinked:NO
-                                                                             heading:level
-                                                                            listInfo:listInfo
-                                                                                view:tv
-                                                                           container:c]];
-                                   }
-                                 }
-                               }];
-}
-
 #pragma mark - Helpers
 
 + (NSString *)formatListAnnouncement:(NSDictionary *)info