feat: add insertValue method

android/src/main/java/com/swmansion/enriched/textinput/EnrichedTextInputView.kt

@@ -9,6 +9,7 @@ import android.graphics.Color
 import android.graphics.Rect
 import android.graphics.text.LineBreaker
 import android.os.Build
+import android.text.Editable
 import android.text.InputType
 import android.text.Spannable
 import android.util.AttributeSet
@@ -359,6 +360,46 @@ class EnrichedTextInputView : AppCompatEditText {
     setSelection(actualStart, actualEnd)
   }
 
+  fun insertValue(
+    value: String,
+    start: Int,
+    end: Int,
+  ) {
+    val currentText = text as Editable
+
+    if (currentText.isEmpty()) {
+      setValue(value)
+      return
+    }
+
+    var safeStart = start.coerceAtLeast(0)
+    var safeEnd = end.coerceAtLeast(0)
+
+    val textLength = currentText.length
+    safeStart = safeStart.coerceAtMost(textLength)
+    safeEnd = safeEnd.coerceAtMost(textLength)
+
+    if (safeEnd < safeStart) {
+      return
+    }
+
+    runAsATransaction {
+      val newText = parseText(value)
+
+      currentText.replace(
+        safeStart,
+        safeEnd,
+        newText,
+      )
+
+      observeAsyncImages()
+
+      // Scroll to the last char of inserted text
+      val newCursorPos = (safeStart + newText.length).coerceAtMost(currentText.length)
+      setSelection(newCursorPos)
+    }
+  }
+
   // Helper: Walks through the string skipping ZWSPs to find the Nth visible character
   private fun getActualIndex(visibleIndex: Int): Int {
     val currentText = text as Spannable

android/src/main/java/com/swmansion/enriched/textinput/EnrichedTextInputViewManager.kt

@@ -304,6 +304,15 @@ class EnrichedTextInputViewManager :
     view?.setCustomSelection(start, end)
   }
 
+  override fun insertValue(
+    view: EnrichedTextInputView?,
+    text: String,
+    start: Int,
+    end: Int,
+  ) {
+    view?.insertValue(text, start, end)
+  }
+
   override fun toggleBold(view: EnrichedTextInputView?) {
     view?.verifyAndToggleStyle(EnrichedSpans.BOLD)
   }

ios/EnrichedTextInputView.mm

@@ -1282,6 +1282,12 @@ - (void)handleCommand:(const NSString *)commandName args:(const NSArray *)args {
   } else if ([commandName isEqualToString:@"requestHTML"]) {
     NSInteger requestId = [((NSNumber *)args[0]) integerValue];
     [self requestHTML:requestId];
+  } else if ([commandName isEqualToString:@"insertValue"]) {
+    NSString *text = (NSString *)args[0];
+    NSInteger start = [((NSNumber *)args[1]) integerValue];
+    NSInteger end = [((NSNumber *)args[2]) integerValue];
+
+    [self insertValue:text start:start end:end];
   }
 }
 
@@ -1328,6 +1334,58 @@ - (void)setCustomSelection:(NSInteger)visibleStart end:(NSInteger)visibleEnd {
   textView.selectedRange = NSMakeRange(actualStart, actualEnd - actualStart);
 }
 
+- (void)insertValue:(NSString *)value
+              start:(NSInteger)visibleStart
+                end:(NSInteger)visibleEnd {
+  if (value == nil) {
+    return;
+  }
+
+  NSString *currentText = textView.text;
+  NSInteger textLength = currentText.length;
+
+  if (textLength == 0) {
+    [self setValue:value];
+
+    return;
+  }
+
+  if (visibleStart < 0) {
+    visibleStart = 0;
+  }
+  if (visibleEnd < 0) {
+    visibleEnd = 0;
+  }
+
+  if (visibleStart > textLength) {
+    visibleStart = textLength;
+  }
+  if (visibleEnd > textLength) {
+    visibleEnd = textLength;
+  }
+
+  if (visibleEnd < visibleStart) {
+    return;
+  }
+
+  NSRange range = NSMakeRange(visibleStart, visibleEnd - visibleStart);
+
+  NSString *initiallyProcessedHtml = [parser initiallyProcessHtml:value];
+  if (initiallyProcessedHtml == nullptr) {
+    // just plain text
+    [textView.textStorage replaceCharactersInRange:range withString:value];
+
+    recentlyChangedRange = range;
+    textView.selectedRange = NSRange(range.location + value.length, 0);
+  } else {
+    // we've got some seemingly proper html
+    [parser replaceFromHtml:initiallyProcessedHtml range:range];
+  }
+
+  // set recentlyChangedRange and check for changes
+  [self anyTextMayHaveBeenModified];
+}
+
 // Helper: Walks through the string skipping ZWSPs to find the Nth visible
 // character
 - (NSUInteger)getActualIndex:(NSInteger)visibleIndex text:(NSString *)text {

src/EnrichedTextInput.tsx

@@ -51,6 +51,7 @@ export interface EnrichedTextInputInstance extends NativeMethods {
   setValue: (value: string) => void;
   setSelection: (start: number, end: number) => void;
   getHTML: () => Promise<string>;
+  insertValue: (text: string, start: number, end: number) => void;
 
   // Text formatting commands
   toggleBold: () => void;
@@ -379,6 +380,9 @@ export const EnrichedTextInput = ({
     setSelection: (start: number, end: number) => {
       Commands.setSelection(nullthrows(nativeRef.current), start, end);
     },
+    insertValue: (text, start, end) => {
+      Commands.insertValue(nullthrows(nativeRef.current), text, start, end);
+    },
   }));
 
   const handleMentionEvent = (e: NativeSyntheticEvent<OnMentionEvent>) => {

src/spec/EnrichedTextInputNativeComponent.ts

@@ -407,6 +407,12 @@ interface NativeCommands {
     start: Int32,
     end: Int32
   ) => void;
+  insertValue: (
+    viewRef: React.ElementRef<ComponentType>,
+    text: string,
+    start: Int32,
+    end: Int32
+  ) => void;
 
   // Text formatting commands
   toggleBold: (viewRef: React.ElementRef<ComponentType>) => void;
@@ -469,6 +475,7 @@ export const Commands: NativeCommands = codegenNativeCommands<NativeCommands>({
     'blur',
     'setValue',
     'setSelection',
+    'insertValue',
 
     // Text formatting commands
     'toggleBold',