feat: add insertValue method

[IslamRustamov]

Summary

Fixes: #255

• This PR solves [Feature Request] Add insertText(text) API to insert plain text at cursor #255
• This PR adds insertValue method that allows users to insert new text at specific parts of text input
• I added new method insertValue with 3 arguments (new text to insert, start index of insertion, end index of insertion), added iOS and Android implementation respectfully
• This PR impacts the main files with implementation of text input methods

Test Plan

Highly recommend to test this PR manually by adding a new button, which invokes a function that calls insertValue method.

Screenshots / Videos

Not applicable.

Compatibility

OS	Implemented
iOS	✅
Android	✅
Web	❌

Checklist

• E2E tests are passing
• Required E2E tests have been added (if applicable)

NOTE:

There are several questions I would like to ask:

1. Do we need to call getActualIndex on start and end when we insert text with specified indexes?
2. Does start and end arguments have to be non nullables?
3. The handleCommand in iOS is turning into huge if/else, maybe something should be done about it (not in this PR).

Do please share your suggestions, fixes, test cases and everything else that I may have missed. And don't hesitate to push whatever you want to this PR if you feel like it's needed.

[IslamRustamov]

@kacperzolkiewski check it out at your convenience please (there are some questions in the end of the description)

[kacperzolkiewski]

Hi @IslamRustamov,

To answer your questions:

1. No, we should not call getActualIndex when inserting text at specified indices. Because if we would use getActualIndex with start and end from onChangeSelection it won't work properly because onChangeSelection returns start end with ZWS
2. We discussed this with the team and agreed it is the right approach. If a user needs to insert text at the cursor position, they can get the start and end values from the onChangeSelection callback.
3. If you would like to work on this, please go ahead.

[IslamRustamov]

2. We discussed this with the team and agreed it is the right approach. If a user needs to insert text at the cursor position, they can get the start and end values from the onChangeSelection callback.

Some misunderstanding here sorry, so just to be sure, we want them to be optional or not?

[kacperzolkiewski]

@IslamRustamov,
we want them to not be optional :D

[IslamRustamov]

i guess its ready for review then, please take a look

[kacperzolkiewski]

On Android if we insert text in paragraph style it does not inherit styling:

Screen.Recording.2026-02-02.at.16.33.10.mov

On iOS it works properly.

[IslamRustamov]

On Android if we insert text in paragraph style it does not inherit styling:

Screen.Recording.2026-02-02.at.16.33.10.mov
On iOS it works properly.

this problem is also relevant for pasting functionality. Seems like there is something wrong with mergeSpannables which does not correctly set needed span to the inserted text (pasted or inserted) at the end of the string. Though this bug doesn't exist when we paste text at the end string for styles like italic and bold

I currently don't see that mergeSpannables actually merging spans (I mean, not adding a h1 span to the newly inserted text at the end for example).

I believe that I should copy code of the handleCustomPaste and use it in insertValue, so it will all come down to modifying mergeSpannables in such a way that this problem is solved for both pasting and inserting texts (suggestions on what should be done inside mergeSpannables are welcome).

[kacperzolkiewski]

On Android if we insert text in paragraph style it does not inherit styling:
Screen.Recording.2026-02-02.at.16.33.10.mov
On iOS it works properly.

this problem is also relevant for pasting functionality. Seems like there is something wrong with mergeSpannables which does not correctly set needed span to the inserted text (pasted or inserted) at the end of the string. Though this bug doesn't exist when we paste text at the end string for styles like italic and bold

I currently don't see that mergeSpannables actually merging spans (I mean, not adding a h1 span to the newly inserted text at the end for example).

I believe that I should copy code of the handleCustomPaste and use it in insertValue, so it will all come down to modifying mergeSpannables in such a way that this problem is solved for both pasting and inserting texts (suggestions on what should be done inside mergeSpannables are welcome).

@IslamRustamov,
Let’s not worry about this right now. It’s not an issue with your implementation but rather with how spans are merged. It should be addressed in a separate PR.

[kacperzolkiewski]

Thanks for your work!

[temlabs]

Really looking forward to this one! Any indication as to what release we might get this in?

[minhnhat165]

I hope the release comes out soon; I really need this.

[Copilot]

Pull request overview

Adds a new imperative API, insertValue(value, start, end), to let consumers insert/replace text (or HTML-ish input) at a specific range without fully resetting the editor value—addressing feature request #255.

Changes:

• Exposes insertValue on the public EnrichedTextInputInstance API and wires it through the native commands layer.
• Implements native handling for insertValue on iOS (handleCommand + insertion logic) and Android (ViewManager + View insertion logic).
• Adds a web ref handle entry for insertValue (currently implemented as a stub in this PR).

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
src/web/EnrichedTextInput.tsx	Exposes insertValue on the web imperative ref (currently a no-op).
src/types.ts	Extends the public instance interface with insertValue.
src/spec/EnrichedTextInputNativeComponent.ts	Adds insertValue to codegen native commands + supportedCommands.
src/native/EnrichedTextInput.tsx	Wires JS imperative method to native command Commands.insertValue.
ios/EnrichedTextInputView.mm	Adds iOS command dispatch and native insertion implementation.
android/src/main/java/com/swmansion/enriched/textinput/EnrichedTextInputViewManager.kt	Exposes insertValue command to the native view.
android/src/main/java/com/swmansion/enriched/textinput/EnrichedTextInputView.kt	Implements Android-side insertion/replace logic and selection update.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.