react-native-enriched-html 0.0.0 → 1.0.0

package/ios/utils/StyleUtils.mm

@@ -0,0 +1,290 @@
+#import "StyleUtils.h"
+
+@implementation StyleUtils
+
++ (NSDictionary *)conflictMap {
+  return @{
+    @([BoldStyle getType]) : @[],
+    @([ItalicStyle getType]) : @[],
+    @([UnderlineStyle getType]) : @[],
+    @([StrikethroughStyle getType]) : @[],
+    @([InlineCodeStyle getType]) :
+        @[ @([LinkStyle getType]), @([MentionStyle getType]) ],
+    @([LinkStyle getType]) :
+        @[ @([LinkStyle getType]), @([MentionStyle getType]) ],
+    @([MentionStyle getType]) : @[ @([LinkStyle getType]) ],
+    @([H1Style getType]) : @[
+      @([H2Style getType]), @([H3Style getType]), @([H4Style getType]),
+      @([H5Style getType]), @([H6Style getType]),
+      @([UnorderedListStyle getType]), @([OrderedListStyle getType]),
+      @([BlockQuoteStyle getType]), @([CodeBlockStyle getType]),
+      @([CheckboxListStyle getType])
+    ],
+    @([H2Style getType]) : @[
+      @([H1Style getType]), @([H3Style getType]), @([H4Style getType]),
+      @([H5Style getType]), @([H6Style getType]),
+      @([UnorderedListStyle getType]), @([OrderedListStyle getType]),
+      @([BlockQuoteStyle getType]), @([CodeBlockStyle getType]),
+      @([CheckboxListStyle getType])
+    ],
+    @([H3Style getType]) : @[
+      @([H1Style getType]), @([H2Style getType]), @([H4Style getType]),
+      @([H5Style getType]), @([H6Style getType]),
+      @([UnorderedListStyle getType]), @([OrderedListStyle getType]),
+      @([BlockQuoteStyle getType]), @([CodeBlockStyle getType]),
+      @([CheckboxListStyle getType])
+    ],
+    @([H4Style getType]) : @[
+      @([H1Style getType]), @([H2Style getType]), @([H3Style getType]),
+      @([H5Style getType]), @([H6Style getType]),
+      @([UnorderedListStyle getType]), @([OrderedListStyle getType]),
+      @([BlockQuoteStyle getType]), @([CodeBlockStyle getType]),
+      @([CheckboxListStyle getType])
+    ],
+    @([H5Style getType]) : @[
+      @([H1Style getType]), @([H2Style getType]), @([H3Style getType]),
+      @([H4Style getType]), @([H6Style getType]),
+      @([UnorderedListStyle getType]), @([OrderedListStyle getType]),
+      @([BlockQuoteStyle getType]), @([CodeBlockStyle getType]),
+      @([CheckboxListStyle getType])
+    ],
+    @([H6Style getType]) : @[
+      @([H1Style getType]), @([H2Style getType]), @([H3Style getType]),
+      @([H4Style getType]), @([H5Style getType]),
+      @([UnorderedListStyle getType]), @([OrderedListStyle getType]),
+      @([BlockQuoteStyle getType]), @([CodeBlockStyle getType]),
+      @([CheckboxListStyle getType])
+    ],
+    @([UnorderedListStyle getType]) : @[
+      @([H1Style getType]), @([H2Style getType]), @([H3Style getType]),
+      @([H4Style getType]), @([H5Style getType]), @([H6Style getType]),
+      @([OrderedListStyle getType]), @([BlockQuoteStyle getType]),
+      @([CodeBlockStyle getType]), @([CheckboxListStyle getType])
+    ],
+    @([OrderedListStyle getType]) : @[
+      @([H1Style getType]), @([H2Style getType]), @([H3Style getType]),
+      @([H4Style getType]), @([H5Style getType]), @([H6Style getType]),
+      @([UnorderedListStyle getType]), @([BlockQuoteStyle getType]),
+      @([CodeBlockStyle getType]), @([CheckboxListStyle getType])
+    ],
+    @([CheckboxListStyle getType]) : @[
+      @([H1Style getType]), @([H2Style getType]), @([H3Style getType]),
+      @([H4Style getType]), @([H5Style getType]), @([H6Style getType]),
+      @([UnorderedListStyle getType]), @([OrderedListStyle getType]),
+      @([BlockQuoteStyle getType]), @([CodeBlockStyle getType])
+    ],
+    @([AlignmentStyle getType]) : @[],
+    @([BlockQuoteStyle getType]) : @[
+      @([H1Style getType]), @([H2Style getType]), @([H3Style getType]),
+      @([H4Style getType]), @([H5Style getType]), @([H6Style getType]),
+      @([UnorderedListStyle getType]), @([OrderedListStyle getType]),
+      @([CodeBlockStyle getType]), @([CheckboxListStyle getType])
+    ],
+    @([CodeBlockStyle getType]) : @[
+      @([H1Style getType]), @([H2Style getType]), @([H3Style getType]),
+      @([H4Style getType]), @([H5Style getType]), @([H6Style getType]),
+      @([BoldStyle getType]), @([UnderlineStyle getType]),
+      @([ItalicStyle getType]), @([StrikethroughStyle getType]),
+      @([UnorderedListStyle getType]), @([OrderedListStyle getType]),
+      @([BlockQuoteStyle getType]), @([InlineCodeStyle getType]),
+      @([MentionStyle getType]), @([LinkStyle getType]),
+      @([CheckboxListStyle getType])
+    ],
+    @([ImageStyle getType]) :
+        @[ @([LinkStyle getType]), @([MentionStyle getType]) ]
+  };
+}
+
++ (NSDictionary *)blockingMap {
+  return @{
+    @([BoldStyle getType]) : @[ @([CodeBlockStyle getType]) ],
+    @([ItalicStyle getType]) : @[ @([CodeBlockStyle getType]) ],
+    @([UnderlineStyle getType]) : @[ @([CodeBlockStyle getType]) ],
+    @([StrikethroughStyle getType]) : @[ @([CodeBlockStyle getType]) ],
+    @([InlineCodeStyle getType]) :
+        @[ @([CodeBlockStyle getType]), @([ImageStyle getType]) ],
+    @([LinkStyle getType]) : @[
+      @([CodeBlockStyle getType]), @([ImageStyle getType]),
+      @([InlineCodeStyle getType])
+    ],
+    @([MentionStyle getType]) : @[
+      @([CodeBlockStyle getType]), @([ImageStyle getType]),
+      @([InlineCodeStyle getType])
+    ],
+    @([H1Style getType]) : @[],
+    @([H2Style getType]) : @[],
+    @([H3Style getType]) : @[],
+    @([H4Style getType]) : @[],
+    @([H5Style getType]) : @[],
+    @([H6Style getType]) : @[],
+    @([UnorderedListStyle getType]) : @[],
+    @([OrderedListStyle getType]) : @[],
+    @([CheckboxListStyle getType]) : @[],
+    @([AlignmentStyle getType]) : @[],
+    @([BlockQuoteStyle getType]) : @[],
+    @([CodeBlockStyle getType]) : @[],
+    @([ImageStyle getType]) : @[ @([InlineCodeStyle getType]) ]
+  };
+}
+
++ (NSDictionary *)stylesDictForHost:(id<EnrichedViewHost>)host
+                            isInput:(BOOL)isInput {
+  NSArray<Class> *baseClasses = @[
+    [BoldStyle class],        [ItalicStyle class],
+    [UnderlineStyle class],   [StrikethroughStyle class],
+    [InlineCodeStyle class],  [LinkStyle class],
+    [MentionStyle class],     [H1Style class],
+    [H2Style class],          [H3Style class],
+    [H4Style class],          [H5Style class],
+    [H6Style class],          [UnorderedListStyle class],
+    [OrderedListStyle class], [CheckboxListStyle class],
+    [AlignmentStyle class],   [BlockQuoteStyle class],
+    [CodeBlockStyle class],   [ImageStyle class]
+  ];
+
+  NSArray<Class> *viewerClasses = @[
+    [EnrichedTextBoldStyle class],
+    [EnrichedTextItalicStyle class],
+    [EnrichedTextUnderlineStyle class],
+    [EnrichedTextStrikethroughStyle class],
+    [EnrichedTextInlineCodeStyle class],
+    [EnrichedTextLinkStyle class],
+    [EnrichedTextMentionStyle class],
+    [EnrichedTextH1Style class],
+    [EnrichedTextH2Style class],
+    [EnrichedTextH3Style class],
+    [EnrichedTextH4Style class],
+    [EnrichedTextH5Style class],
+    [EnrichedTextH6Style class],
+    [EnrichedTextUnorderedListStyle class],
+    [EnrichedTextOrderedListStyle class],
+    [EnrichedTextCheckboxListStyle class],
+    [EnrichedTextAlignmentStyle class],
+    [EnrichedTextBlockQuoteStyle class],
+    [EnrichedTextCodeBlockStyle class],
+    [EnrichedTextImageStyle class]
+  ];
+
+  NSMutableDictionary *dict = [NSMutableDictionary new];
+
+  for (NSUInteger i = 0; i < baseClasses.count; i++) {
+    // Choose the class based on the context
+    Class targetClass = isInput ? baseClasses[i] : viewerClasses[i];
+
+    // Instantiate and add to dictionary
+    // We use [baseClasses[i] getType] for the key to ensure the
+    // conflict maps (which use base types) always match.
+    StyleBase *instance = [[targetClass alloc] initWithHost:host];
+    dict[@([baseClasses[i] getType])] = instance;
+  }
+
+  return [dict copy];
+}
+
+// returns false when style shouldn't be applied and true when it can be
++ (BOOL)isStyleBlocked:(StyleType)type
+                 range:(NSRange)range
+               forHost:(id<EnrichedViewHost>)host {
+  NSArray<NSNumber *> *blocking =
+      [self getPresentStyleTypesFrom:host.blockingStyles[@(type)]
+                               range:range
+                             forHost:host];
+  return blocking.count != 0;
+}
+
+// returns false when style shouldn't be applied and true when it can be
++ (BOOL)handleStyleBlocksAndConflicts:(StyleType)type
+                                range:(NSRange)range
+                              forHost:(id<EnrichedViewHost>)host {
+  if ([self isStyleBlocked:type range:range forHost:host]) {
+    return NO;
+  }
+
+  // handle conflicting styles: remove styles within the range
+  NSArray<NSNumber *> *conflicting =
+      [self getPresentStyleTypesFrom:host.conflictingStyles[@(type)]
+                               range:range
+                             forHost:host];
+  if (conflicting.count != 0) {
+    for (NSNumber *type in conflicting) {
+      StyleBase *style = host.stylesDict[type];
+
+      if ([style isParagraph]) {
+        // for paragraph styles we can just call remove since it will pick up
+        // proper paragraph range
+        [style remove:range withDirtyRange:YES];
+      } else {
+        // for inline styles we have to differentiate betweeen normal and typing
+        // attributes removal
+        range.length >= 1 ? [style remove:range withDirtyRange:YES]
+                          : [style removeTyping];
+      }
+    }
+  }
+  return YES;
+}
+
++ (NSArray *)getPresentStyleTypesFrom:(NSArray *)types
+                                range:(NSRange)range
+                              forHost:(id<EnrichedViewHost>)host {
+  NSMutableArray<NSNumber *> *resultArray =
+      [[NSMutableArray<NSNumber *> alloc] init];
+  for (NSNumber *type in types) {
+    StyleBase *style = host.stylesDict[type];
+
+    if (range.length >= 1) {
+      if ([style any:range]) {
+        [resultArray addObject:type];
+      }
+    } else {
+      if ([style detect:range]) {
+        [resultArray addObject:type];
+      }
+    }
+  }
+  return resultArray;
+}
+
++ (void)addStyleBlock:(StyleType)blocking
+                   to:(StyleType)blocked
+              forHost:(id<EnrichedViewHost>)host {
+  NSMutableArray *blocksArr = [host.blockingStyles[@(blocked)] mutableCopy];
+  if (![blocksArr containsObject:@(blocking)]) {
+    [blocksArr addObject:@(blocking)];
+    host.blockingStyles[@(blocked)] = blocksArr;
+  }
+}
+
++ (void)removeStyleBlock:(StyleType)blocking
+                    from:(StyleType)blocked
+                 forHost:(id<EnrichedViewHost>)host {
+  NSMutableArray *blocksArr = [host.blockingStyles[@(blocked)] mutableCopy];
+  if ([blocksArr containsObject:@(blocking)]) {
+    [blocksArr removeObject:@(blocking)];
+    host.blockingStyles[@(blocked)] = blocksArr;
+  }
+}
+
++ (void)addStyleConflict:(StyleType)conflicting
+                      to:(StyleType)conflicted
+                 forHost:(id<EnrichedViewHost>)host {
+  NSMutableArray *conflictsArr =
+      [host.conflictingStyles[@(conflicted)] mutableCopy];
+  if (![conflictsArr containsObject:@(conflicting)]) {
+    [conflictsArr addObject:@(conflicting)];
+    host.conflictingStyles[@(conflicted)] = conflictsArr;
+  }
+}
+
++ (void)removeStyleConflict:(StyleType)conflicting
+                       from:(StyleType)conflicted
+                    forHost:(id<EnrichedViewHost>)host {
+  NSMutableArray *conflictsArr =
+      [host.conflictingStyles[@(conflicted)] mutableCopy];
+  if ([conflictsArr containsObject:@(conflicting)]) {
+    [conflictsArr removeObject:@(conflicting)];
+    host.conflictingStyles[@(conflicted)] = conflictsArr;
+  }
+}
+
+@end

package/ios/utils/TextBlockTapGestureRecognizer.h

@@ -0,0 +1,17 @@
+typedef NS_ENUM(NSInteger, TextBlockTapKind) {
+  TextBlockTapKindNone = 0,
+  TextBlockTapKindCheckbox,
+};
+
+@class EnrichedTextInputView;
+
+@interface TextBlockTapGestureRecognizer : UITapGestureRecognizer
+- (instancetype _Nonnull)initWithInput:(id _Nonnull)input
+                                action:(SEL _Nonnull)action;
+
+@property(nonatomic, weak) EnrichedTextInputView *input;
+
+@property(nonatomic, assign, readonly) TextBlockTapKind tapKind;
+@property(nonatomic, assign, readonly) NSInteger characterIndex;
+
+@end

package/ios/utils/TextBlockTapGestureRecognizer.mm

@@ -0,0 +1,56 @@
+#import "TextBlockTapGestureRecognizer.h"
+#import "CheckboxHitTestUtils.h"
+#import "EnrichedTextInputView.h"
+
+@implementation TextBlockTapGestureRecognizer {
+  TextBlockTapKind _tapKind;
+  NSInteger _characterIndex;
+}
+
+- (instancetype)initWithInput:(id)input action:(SEL)action {
+  self = [super initWithTarget:input action:action];
+  _input = input;
+
+  self.cancelsTouchesInView = YES;
+  self.delaysTouchesBegan = YES;
+  self.delaysTouchesEnded = YES;
+
+  for (UIGestureRecognizer *gr in _input->textView.gestureRecognizers) {
+    [gr requireGestureRecognizerToFail:self];
+  }
+
+  return self;
+}
+
+- (TextBlockTapKind)tapKind {
+  return _tapKind;
+}
+
+- (NSInteger)characterIndex {
+  return _characterIndex;
+}
+
+- (void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event {
+  _tapKind = TextBlockTapKindNone;
+  _characterIndex = NSNotFound;
+
+  if (!self.input) {
+    self.state = UIGestureRecognizerStateFailed;
+    return;
+  }
+
+  UITouch *touch = touches.anyObject;
+  CGPoint point = [touch locationInView:self.input->textView];
+  NSInteger checkboxIndex =
+      [CheckboxHitTestUtils hitTestCheckboxAtPoint:point inInput:self.input];
+
+  if (checkboxIndex >= 0) {
+    _tapKind = TextBlockTapKindCheckbox;
+    _characterIndex = checkboxIndex;
+    [super touchesBegan:touches withEvent:event];
+    return;
+  }
+  self.state = UIGestureRecognizerStateFailed;
+}
+
+@end

package/ios/utils/TextInsertionUtils.h

@@ -0,0 +1,17 @@
+#import "EnrichedViewHost.h"
+#import <UIKit/UIKit.h>
+
+@interface TextInsertionUtils : NSObject
++ (void)insertText:(NSString *)text
+                      at:(NSInteger)index
+    additionalAttributes:
+        (NSDictionary<NSAttributedStringKey, id> *)additionalAttrs
+                    host:(id<EnrichedViewHost>)host
+           withSelection:(BOOL)withSelection;
++ (void)replaceText:(NSString *)text
+                      at:(NSRange)range
+    additionalAttributes:
+        (NSDictionary<NSAttributedStringKey, id> *)additionalAttrs
+                    host:(id<EnrichedViewHost>)host
+           withSelection:(BOOL)withSelection;
+@end

package/ios/utils/TextInsertionUtils.mm

@@ -0,0 +1,60 @@
+#import "TextInsertionUtils.h"
+#import "UIView+React.h"
+
+@implementation TextInsertionUtils
++ (void)insertText:(NSString *)text
+                      at:(NSInteger)index
+    additionalAttributes:
+        (NSDictionary<NSAttributedStringKey, id> *)additionalAttrs
+                    host:(id<EnrichedViewHost>)host
+           withSelection:(BOOL)withSelection {
+  if (host == nullptr) {
+    return;
+  }
+
+  UITextView *textView = host.textView;
+
+  NSMutableDictionary<NSAttributedStringKey, id> *copiedAttrs =
+      [textView.typingAttributes mutableCopy];
+  if (additionalAttrs != nullptr) {
+    [copiedAttrs addEntriesFromDictionary:additionalAttrs];
+  }
+
+  NSAttributedString *newAttrStr =
+      [[NSAttributedString alloc] initWithString:text attributes:copiedAttrs];
+  [textView.textStorage insertAttributedString:newAttrStr atIndex:index];
+
+  if (withSelection) {
+    if (![textView isFirstResponder]) {
+      [textView reactFocus];
+    }
+    textView.selectedRange = NSMakeRange(index + text.length, 0);
+  }
+}
+
++ (void)replaceText:(NSString *)text
+                      at:(NSRange)range
+    additionalAttributes:
+        (NSDictionary<NSAttributedStringKey, id> *)additionalAttrs
+                    host:(id<EnrichedViewHost>)host
+           withSelection:(BOOL)withSelection {
+  if (host == nullptr) {
+    return;
+  }
+
+  UITextView *textView = host.textView;
+  [textView.textStorage replaceCharactersInRange:range withString:text];
+  if (additionalAttrs != nullptr) {
+    [textView.textStorage
+        addAttributes:additionalAttrs
+                range:NSMakeRange(range.location, [text length])];
+  }
+
+  if (withSelection) {
+    if (![textView isFirstResponder]) {
+      [textView reactFocus];
+    }
+    textView.selectedRange = NSMakeRange(range.location + text.length, 0);
+  }
+}
+@end

package/ios/utils/TextListsUtils.h

@@ -0,0 +1,40 @@
+#pragma once
+#import <UIKit/UIKit.h>
+
+@interface TextListsUtils : NSObject
+
+// Appends value to the array. If exclusivePrefix is non-nil, any existing
+// entry whose markerFormat starts with that prefix is evicted first, ensuring
+// only one value from the family is present at a time.
++ (NSArray<NSTextList *> *_Nonnull)
+      textListsByAdding:(NSString *_Nonnull)value
+    withExclusivePrefix:(NSString *_Nullable)prefix
+                toArray:(NSArray<NSTextList *> *_Nullable)existing;
+
+// Returns a new array without entries whose markerFormat equals value removed
+// or whose markerFormat starts with prefix
++ (NSArray<NSTextList *> *_Nonnull)
+    textListsByRemoving:(NSString *_Nonnull)value
+             withPrefix:(NSString *_Nullable)prefix
+              fromArray:(NSArray<NSTextList *> *_Nullable)existing;
+
+// Returns a new array without entries whose markerFormat starts with prefix
++ (NSArray<NSTextList *> *_Nonnull)
+    textListsByRemovingPrefix:(NSString *_Nullable)prefix
+                    fromArray:(NSArray<NSTextList *> *_Nullable)existing;
+
+// Returns YES if any entry's markerFormat equals value exactly.
++ (BOOL)textLists:(NSArray<NSTextList *> *_Nullable)textLists
+    containsValue:(NSString *_Nonnull)value;
+
+// Returns YES if any entry's markerFormat starts with prefix.
++ (BOOL)textLists:(NSArray<NSTextList *> *_Nullable)textLists
+    containsPrefix:(NSString *_Nullable)prefix;
+
+// Returns the first entry with a markerFormat that starts with prefix,
+// otherwise nil.
++ (NSTextList *_Nullable)
+    firstTextListWithPrefix:(NSString *_Nullable)prefix
+                    inArray:(NSArray<NSTextList *> *_Nullable)textLists;
+
+@end

package/ios/utils/TextListsUtils.mm

@@ -0,0 +1,93 @@
+#import "TextListsUtils.h"
+
+@implementation TextListsUtils
+
++ (NSArray<NSTextList *> *_Nonnull)
+      textListsByAdding:(NSString *_Nonnull)value
+    withExclusivePrefix:(NSString *_Nullable)prefix
+                toArray:(NSArray<NSTextList *> *_Nullable)existing {
+  NSMutableArray<NSTextList *> *updated =
+      existing ? [existing mutableCopy] : [NSMutableArray array];
+
+  if (prefix != nil) {
+    NSUInteger i = 0;
+    while (i < updated.count) {
+      if ([updated[i].markerFormat hasPrefix:prefix]) {
+        if ([updated[i].markerFormat isEqualToString:value]) {
+          return updated;
+        }
+        [updated removeObjectAtIndex:i];
+      } else {
+        i++;
+      }
+    }
+  } else {
+    for (NSTextList *list in updated) {
+      if ([list.markerFormat isEqualToString:value]) {
+        return updated;
+      }
+    }
+  }
+
+  [updated addObject:[[NSTextList alloc] initWithMarkerFormat:value options:0]];
+  return updated;
+}
+
++ (NSArray<NSTextList *> *_Nonnull)
+    textListsByRemoving:(NSString *_Nonnull)value
+             withPrefix:(NSString *_Nullable)prefix
+              fromArray:(NSArray<NSTextList *> *_Nullable)existing {
+  NSMutableArray<NSTextList *> *updated = [NSMutableArray array];
+  for (NSTextList *list in existing) {
+    if ((prefix == nullptr && ![list.markerFormat isEqualToString:value]) ||
+        (prefix != nullptr && ![list.markerFormat hasPrefix:prefix])) {
+      [updated addObject:list];
+    }
+  }
+  return updated;
+}
+
++ (NSArray<NSTextList *> *_Nonnull)
+    textListsByRemovingPrefix:(NSString *_Nullable)prefix
+                    fromArray:(NSArray<NSTextList *> *_Nullable)existing {
+  NSMutableArray<NSTextList *> *updated = [NSMutableArray array];
+  for (NSTextList *list in existing) {
+    if (![list.markerFormat hasPrefix:prefix]) {
+      [updated addObject:list];
+    }
+  }
+  return updated;
+}
+
++ (BOOL)textLists:(NSArray<NSTextList *> *_Nullable)textLists
+    containsValue:(NSString *_Nonnull)value {
+  for (NSTextList *list in textLists) {
+    if ([list.markerFormat isEqualToString:value]) {
+      return YES;
+    }
+  }
+  return NO;
+}
+
++ (BOOL)textLists:(NSArray<NSTextList *> *_Nullable)textLists
+    containsPrefix:(NSString *_Nullable)prefix {
+  for (NSTextList *list in textLists) {
+    if ([list.markerFormat hasPrefix:prefix]) {
+      return YES;
+    }
+  }
+  return NO;
+}
+
++ (NSTextList *_Nullable)
+    firstTextListWithPrefix:(NSString *_Nullable)prefix
+                    inArray:(NSArray<NSTextList *> *_Nullable)textLists {
+  for (NSTextList *list in textLists) {
+    if ([list.markerFormat hasPrefix:prefix]) {
+      return list;
+    }
+  }
+  return nil;
+}
+
+@end

package/ios/utils/WeakBox.h

@@ -0,0 +1,3 @@
+@interface WeakBox : NSObject
+@property(nonatomic, weak) id value;
+@end

package/ios/utils/WeakBox.m

@@ -0,0 +1,4 @@
+#import "WeakBox.h"
+
+@implementation WeakBox
+@end

package/ios/utils/WordsUtils.h

@@ -0,0 +1,7 @@
+#import <UIKit/UIKit.h>
+
+@interface WordsUtils : NSObject
++ (NSArray<NSDictionary *> *)getAffectedWordsFromText:(NSString *)text
+                                    modificationRange:(NSRange)range;
++ (NSDictionary *)getCurrentWord:(NSString *)text range:(NSRange)range;
+@end

package/ios/utils/WordsUtils.mm

@@ -0,0 +1,98 @@
+#import "WordsUtils.h"
+
+@implementation WordsUtils
+
++ (NSArray<NSDictionary *> *)getAffectedWordsFromText:(NSString *)text
+                                    modificationRange:(NSRange)range {
+  if (text.length == 0) {
+    return [[NSArray alloc] init];
+  }
+
+  NSInteger leftIt = range.location - 1;
+  leftIt = MIN(leftIt, NSInteger(text.length - 1));
+  if (leftIt > 0) {
+    while (leftIt >= 0) {
+      unichar charAtIndex = [text characterAtIndex:leftIt];
+      if ([[NSCharacterSet whitespaceAndNewlineCharacterSet]
+              characterIsMember:charAtIndex]) {
+        leftIt += 1;
+        break;
+      }
+      leftIt -= 1;
+    }
+  }
+  leftIt = MAX(0, leftIt);
+  leftIt = MIN(NSInteger(text.length - 1), leftIt);
+
+  NSInteger rightIt = range.location + range.length;
+  if (rightIt < text.length - 1) {
+    while (rightIt <= text.length - 1) {
+      unichar charAtIndex = [text characterAtIndex:rightIt];
+      if ([[NSCharacterSet whitespaceAndNewlineCharacterSet]
+              characterIsMember:charAtIndex]) {
+        rightIt -= 1;
+        break;
+      }
+      rightIt += 1;
+    }
+  }
+  rightIt = MIN(NSInteger(text.length - 1), rightIt);
+
+  if (leftIt > rightIt) {
+    return [[NSArray alloc] init];
+  }
+
+  NSMutableArray<NSDictionary *> *separatedWords =
+      [[NSMutableArray<NSDictionary *> alloc] init];
+  NSMutableString *currentWord = [[NSMutableString alloc] init];
+  NSInteger currentRangeStart = leftIt;
+  NSInteger currentIdx = leftIt;
+
+  while (currentIdx <= rightIt) {
+    unichar charAtIndex = [text characterAtIndex:currentIdx];
+    if ([[NSCharacterSet whitespaceAndNewlineCharacterSet]
+            characterIsMember:charAtIndex]) {
+      if (currentWord.length > 0) {
+        [separatedWords addObject:@{
+          @"word" : [currentWord copy],
+          @"range" : [NSValue
+              valueWithRange:NSMakeRange(currentRangeStart, currentWord.length)]
+        }];
+        [currentWord setString:@""];
+      }
+      currentRangeStart = currentIdx + 1;
+    } else {
+      [currentWord appendFormat:@"%C", charAtIndex];
+    }
+    currentIdx += 1;
+  }
+
+  if (currentWord.length > 0) {
+    [separatedWords addObject:@{
+      @"word" : [currentWord copy],
+      @"range" :
+          [NSValue valueWithRange:NSMakeRange(currentRangeStart,
+                                              rightIt - currentRangeStart + 1)]
+    }];
+  }
+
+  return separatedWords;
+}
+
++ (NSDictionary *)getCurrentWord:(NSString *)text range:(NSRange)range {
+  // we just get current word at the cursor
+  if (range.length > 0) {
+    return nullptr;
+  }
+
+  NSArray<NSDictionary *> *words = [WordsUtils getAffectedWordsFromText:text
+                                                      modificationRange:range];
+  if (words != nullptr && [words count] == 1 &&
+      [words firstObject] != nullptr) {
+    return [words firstObject];
+  }
+
+  return nullptr;
+}
+
+@end