@apollohg/react-native-rich-text-editor 2.0.2 → 2.0.3

package/README.md

@@ -8,13 +8,15 @@ See the [documentation](https://github.com/apollohg/react-native-rich-text-edito
 
 ## Highlights
 
-- Native iOS and Android editing backed by a Rust document engine
-- HTML and ProseMirror JSON input and output
-- Configurable schemas, marks, blockquotes, lists, links, images, and mentions
-- Custom atom nodes rendered with your React components
-- Native toolbar, theming, selection, undo, and redo
-- `RichTextViewer`, an exact-size Fabric renderer for read-only content
-- Shared document handles for local editing and Yjs collaboration
+**⭐ Native editing on iOS and Android**  
+**⭐ Built-in Yjs collaboration**  
+**⭐ React Native components inside documents**  
+**⭐ External text composition**  
+**⭐ Dedicated Fabric viewer**  
+**⭐ Configurable document schemas** with HTML and ProseMirror JSON import/export  
+**⭐ Nested bullet and numbered lists**  
+**⭐ Optional native code syntax highlighting**  
+**⭐ Rich copy and paste**  
 
 ## Requirements
 
@@ -87,6 +89,18 @@ export function EditorScreen() {
 
 See [Getting Started](https://github.com/apollohg/react-native-rich-text-editor/wiki/Getting-Started) and the [RichTextEditor reference](https://github.com/apollohg/react-native-rich-text-editor/wiki/RichTextEditor-Reference) for the complete API.
 
+## Copy and paste
+
+Copy and cut publish an editor fragment, HTML, and plain text. Pasting between compatible editor schemas preserves selected marks, nodes, and atom attributes. External rich text imports supported HTML formatting and structure, with RTF conversion on iOS.
+
+Use `pasteMode` to control native clipboard paste:
+
+```tsx
+<RichTextEditor documentHandle={documentHandle} pasteMode="plainText" />
+```
+
+The default is `"rich"`. `"plainText"` removes source formatting and atoms, while retaining the destination's ordinary typing marks. `"disabled"` blocks paste without disabling copy or typing. Changes apply immediately. These settings govern clipboard actions; programmatic insertion and drag/drop retain their own behaviour. Unsupported external formatting is reduced to supported content, and clipboard images do not trigger uploads.
+
 ## Custom atom nodes
 
 Render interactive cards, embeds, and other custom blocks with your own React components.

package/android/src/main/java/com/apollohg/editor/EditorEditText.kt

@@ -133,6 +133,8 @@ class EditorEditText @JvmOverloads constructor(
             }
         }
 
+    internal var pasteMode: EditorPasteMode = EditorPasteMode.RICH
+
     /**
      * Guard flag to prevent re-entrant input interception while we're
      * applying state from Rust (calling [setText] or modifying text storage).
@@ -245,6 +247,7 @@ class EditorEditText @JvmOverloads constructor(
     internal var currentRenderBlocksNeedFullApply = false
     internal var authorizedVisibleTextNeedsRebuild = false
     internal var logicalSelectionSnapshot: LogicalSelectionSnapshot? = null
+    internal var authoritativeNodeSelectionRange: ImageSelectionRange? = null
     internal var lastAllowedAtomCaretSelection: Pair<Int, Int>? = null
     private var localTextDrag: LocalTextDrag? = null
     internal var lastAppliedDocumentVersion: String? = null
@@ -275,6 +278,7 @@ class EditorEditText @JvmOverloads constructor(
     internal var onSetSelectionScalarInRustForTesting: ((Int, Int) -> Unit)? = null
     internal var onDeleteAndSplitScalarInRustForTesting: ((Int, Int) -> Unit)? = null
     internal var onInsertContentHtmlInRustForTesting: ((String) -> Unit)? = null
+    internal var onSetPrimaryClipForTesting: ((android.content.ClipData) -> Unit)? = null
     internal var onResizeImageAtDocPosForTesting: ((Int, Int, Int) -> Unit)? = null
     internal var onMoveSelectionScalarForTesting: ((Int, Int, Int) -> Unit)? = null
     internal var onBeforeRenderRefresh: (() -> Unit)? = null
@@ -788,14 +792,18 @@ class EditorEditText @JvmOverloads constructor(
 
     fun performToolbarRedo() = performToolbarRedoImpl()
 
-    /**
-     * Intercept paste operations to route content through Rust.
-     *
-     * Attempts to extract HTML from the clipboard first (for rich text paste),
-     * falling back to plain text.
-     */
+    /** Routes native clipboard actions through the authoritative Rust selection. */
     override fun onTextContextMenuItem(id: Int): Boolean {
+        if (id == android.R.id.copy) {
+            handleCopy()
+            return true
+        }
         if (!isEditable && isMutatingContextMenuItem(id)) return true
+        if (pasteMode == EditorPasteMode.DISABLED &&
+            (id == android.R.id.paste || id == android.R.id.pasteAsPlainText)
+        ) {
+            return true
+        }
         if (id == android.R.id.cut) {
             handleCut()
             return true
@@ -812,6 +820,11 @@ class EditorEditText @JvmOverloads constructor(
      * Selection and copy actions remain available.
      */
     override fun performAccessibilityAction(action: Int, arguments: android.os.Bundle?): Boolean {
+        if (pasteMode == EditorPasteMode.DISABLED &&
+            action == android.view.accessibility.AccessibilityNodeInfo.ACTION_PASTE
+        ) {
+            return false
+        }
         if (!isEditable && (
                 action == android.view.accessibility.AccessibilityNodeInfo.ACTION_SET_TEXT ||
                     action == android.view.accessibility.AccessibilityNodeInfo.ACTION_PASTE ||
@@ -842,6 +855,7 @@ class EditorEditText @JvmOverloads constructor(
         }
         ensureSelectionVisible()
         if (isApplyingRustState) return
+        authoritativeNodeSelectionRange = null
         val wasExternallyComposing = externalTextComposition != null
         if (!commitExternalTextCompositionBeforeInteractionIfNeeded()) return
         if (wasExternallyComposing) {

package/android/src/main/java/com/apollohg/editor/EditorEditTextClipboard.kt

@@ -1,9 +1,94 @@
 package com.apollohg.editor
 
 import android.content.ClipData
+import android.content.ClipDescription
 import android.content.ClipboardManager
 import android.content.Context
-import android.view.accessibility.AccessibilityNodeInfo
+import android.os.PersistableBundle
+import org.json.JSONObject
+
+internal enum class EditorPasteMode {
+    RICH,
+    PLAIN_TEXT,
+    DISABLED;
+
+    companion object {
+        fun fromRaw(value: String?): EditorPasteMode = when (value) {
+            "plainText" -> PLAIN_TEXT
+            "disabled" -> DISABLED
+            else -> RICH
+        }
+    }
+}
+
+internal data class EditorClipboardPayload(
+    val fragment: String? = null,
+    val html: String? = null,
+    val text: String? = null
+)
+
+internal object EditorClipboard {
+    const val MIME_TYPE_FRAGMENT = "application/vnd.apollohg.native-editor.fragment+json"
+    const val EXTRA_FRAGMENT = "com.apollohg.editor.clipboard.FRAGMENT"
+
+    fun fromExportJson(json: String): EditorClipboardPayload? = try {
+        val value = JSONObject(json)
+        if (value.optBoolean("empty", false)) {
+            null
+        } else {
+            val fragment = value.optString("fragment").takeIf { it.isNotEmpty() }
+            val html = value.optString("html").takeIf { it.isNotEmpty() }
+            val text = value.optString("text").takeIf { it.isNotEmpty() }
+            if (fragment == null && html == null && text == null) {
+                null
+            } else {
+                EditorClipboardPayload(fragment, html, text)
+            }
+        }
+    } catch (_: Exception) {
+        null
+    }
+
+    fun create(payload: EditorClipboardPayload): ClipData {
+        val mimeTypes = buildList {
+            if (payload.html != null) add(ClipDescription.MIMETYPE_TEXT_HTML)
+            add(ClipDescription.MIMETYPE_TEXT_PLAIN)
+            if (payload.fragment != null) add(MIME_TYPE_FRAGMENT)
+        }.distinct().toTypedArray()
+        val description = ClipDescription("rich text", mimeTypes)
+        payload.fragment?.let { fragment ->
+            description.extras = PersistableBundle().apply {
+                putString(EXTRA_FRAGMENT, fragment)
+            }
+        }
+        return ClipData(
+            description,
+            ClipData.Item(payload.text ?: "", payload.html, null, null)
+        )
+    }
+
+    fun read(clip: ClipData, context: Context): EditorClipboardPayload {
+        if (clip.itemCount == 0) return EditorClipboardPayload()
+        val item = clip.getItemAt(0)
+        val hasPrivateMime = (0 until clip.description.mimeTypeCount).any {
+            clip.description.getMimeType(it) == MIME_TYPE_FRAGMENT
+        }
+        val fragment = if (hasPrivateMime) {
+            runCatching {
+                clip.description.extras?.getString(EXTRA_FRAGMENT)
+            }.getOrNull()
+        } else {
+            null
+        }
+        return EditorClipboardPayload(
+            fragment = fragment,
+            html = item.htmlText,
+            text = item.text?.toString() ?: runCatching {
+                item.coerceToText(context)?.toString()
+            }.getOrNull()
+        )
+    }
+}
 
 internal fun EditorEditText.isMutatingContextMenuItem(id: Int): Boolean =
     id == android.R.id.paste ||
@@ -14,16 +99,37 @@ internal fun EditorEditText.prepareForExternalInteractionMutation(): Boolean =
     commitExternalTextCompositionBeforeInteractionIfNeeded() &&
         prepareForExternalEditorUpdate()
 
-internal fun EditorEditText.handlePaste(plainTextOnly: Boolean) {
-    val selectionRange = normalizedUtf16SelectionRange()
-    if (selectionRange != null &&
-        isCollapsedAtomBoundarySelection(selectionRange.first, selectionRange.second)
-    ) {
-        return
+internal fun EditorEditText.publishClipboard(payload: EditorClipboardPayload): Boolean {
+    return try {
+        val clip = EditorClipboard.create(payload)
+        val testWriter = onSetPrimaryClipForTesting
+        if (testWriter != null) {
+            testWriter(clip)
+        } else {
+            val clipboard = context.getSystemService(Context.CLIPBOARD_SERVICE) as? ClipboardManager
+                ?: return false
+            clipboard.setPrimaryClip(clip)
+        }
+        true
+    } catch (_: Exception) {
+        false
     }
+}
+
+internal fun EditorEditText.handleCopy(): Boolean {
+    if (editorId == 0L || v2Driver == null) return baseTextContextMenuItem(android.R.id.copy)
+    if (discardTransientInputForDestroyedEditorIfNeeded()) return false
+    if (!prepareForExternalInteractionMutation()) return false
+    syncCurrentSelectionToRust()
+    val payload = v2Driver?.clipboardJson()?.let(EditorClipboard::fromExportJson) ?: return false
+    return publishClipboard(payload)
+}
+
+internal fun EditorEditText.handlePaste(plainTextOnly: Boolean) {
+    val forcePlainText = plainTextOnly || pasteMode == EditorPasteMode.PLAIN_TEXT
     if (editorId == 0L) {
         baseTextContextMenuItem(
-            if (plainTextOnly) android.R.id.pasteAsPlainText else android.R.id.paste
+            if (forcePlainText) android.R.id.pasteAsPlainText else android.R.id.paste
         )
         return
     }
@@ -32,21 +138,40 @@ internal fun EditorEditText.handlePaste(plainTextOnly: Boolean) {
 
     val clipboard = context.getSystemService(Context.CLIPBOARD_SERVICE) as? ClipboardManager
         ?: return
-    val clip = clipboard.primaryClip ?: return
-    if (clip.itemCount == 0) return
-
-    val item = clip.getItemAt(0)
+    val clip = runCatching { clipboard.primaryClip }.getOrNull() ?: return
+    val payload = EditorClipboard.read(clip, context)
+    if (payload.fragment == null && payload.html == null && payload.text.isNullOrEmpty()) return
 
-    val htmlText = item.htmlText
-    if (!plainTextOnly && htmlText != null) {
-        pasteHTML(htmlText)
+    if (payload.fragment == null && payload.html == null &&
+        (onInsertTextInRustForTesting != null || onReplaceTextInRustForTesting != null)
+    ) {
+        payload.text?.let(::pastePlainText)
         return
     }
-
-    val plainText = item.text?.toString() ?: item.coerceToText(context)?.toString()
-    if (plainText != null) {
-        pastePlainText(plainText)
+    val driver = v2Driver
+    if (driver == null) {
+        if (forcePlainText) {
+            payload.text?.let(::pastePlainText)
+        } else if (payload.html != null) {
+            pasteHTML(payload.html)
+        } else {
+            payload.text?.let(::pastePlainText)
+        }
+        return
     }
+    val (anchor, head) = currentScalarSelection() ?: return
+    val preserveEngineSelection = authoritativeNodeSelectionRange?.let { range ->
+        selectionStart == range.start && selectionEnd == range.end
+    } == true
+    driver.pasteAtSelection(
+        fragment = payload.fragment,
+        html = payload.html,
+        text = payload.text,
+        plainText = forcePlainText,
+        anchor = anchor,
+        head = head,
+        preserveEngineSelection = preserveEngineSelection
+    )?.let { applyUpdateJSON(it) }
 }
 
 internal fun EditorEditText.handleCut() {
@@ -56,25 +181,45 @@ internal fun EditorEditText.handleCut() {
     }
     if (discardTransientInputForDestroyedEditorIfNeeded()) return
     if (!prepareForExternalInteractionMutation()) return
+    if (v2Driver == null) {
+        val currentText = text?.toString() ?: return
+        val (selectionStart, selectionEnd) = normalizedUtf16SelectionRange(currentText) ?: return
+        val (utf16Start, utf16End) = PositionBridge.snapRangeToScalarBoundaries(
+            selectionStart,
+            selectionEnd,
+            currentText
+        )
+        if (utf16Start >= utf16End) return
+        val selectedText = currentText.substring(utf16Start, utf16End)
+        if (!publishClipboard(EditorClipboardPayload(text = selectedText))) return
+        deleteRangeInRust(
+            PositionBridge.utf16ToScalar(utf16Start, currentText),
+            PositionBridge.utf16ToScalar(utf16End, currentText)
+        )
+        return
+    }
+    syncCurrentSelectionToRust()
 
-    val currentText = text?.toString() ?: return
-    val (selectionStart, selectionEnd) = normalizedUtf16SelectionRange(currentText) ?: return
-    if (selectionStart == selectionEnd) return
-
-    val (utf16Start, utf16End) = PositionBridge.snapRangeToScalarBoundaries(
-        selectionStart,
-        selectionEnd,
-        currentText
-    )
-    if (utf16Start >= utf16End) return
-
-    val selectedText = currentText.substring(utf16Start, utf16End)
-    val clipboard = context.getSystemService(Context.CLIPBOARD_SERVICE) as? ClipboardManager
-    clipboard?.setPrimaryClip(ClipData.newPlainText(null, selectedText))
+    val payload = v2Driver?.clipboardJson()?.let(EditorClipboard::fromExportJson) ?: return
+    if (!publishClipboard(payload)) return
 
-    val scalarStart = PositionBridge.utf16ToScalar(utf16Start, currentText)
-    val scalarEnd = PositionBridge.utf16ToScalar(utf16End, currentText)
-    deleteRangeInRust(scalarStart, scalarEnd)
+    val (anchor, head) = currentScalarSelection() ?: return
+    if (onDeleteRangeInRustForTesting != null) {
+        deleteRangeInRust(minOf(anchor, head), maxOf(anchor, head))
+        return
+    }
+    val preserveEngineSelection = authoritativeNodeSelectionRange?.let { range ->
+        selectionStart == range.start && selectionEnd == range.end
+    } == true
+    v2Driver?.pasteAtSelection(
+        fragment = null,
+        html = null,
+        text = "",
+        plainText = true,
+        anchor = anchor,
+        head = head,
+        preserveEngineSelection = preserveEngineSelection
+    )?.let { applyUpdateJSON(it) }
 }
 
 internal fun EditorEditText.handleAccessibilitySetText(arguments: android.os.Bundle?): Boolean {

package/android/src/main/java/com/apollohg/editor/EditorEditTextSelection.kt

@@ -100,6 +100,10 @@ internal fun EditorEditText.canonicalListCaretOffset(selStart: Int, selEnd: Int)
 
 internal fun EditorEditText.syncCurrentSelectionToRust() {
     if (!hasLiveEditor()) return
+    authoritativeNodeSelectionRange?.let { range ->
+        if (selectionStart == range.start && selectionEnd == range.end) return
+        authoritativeNodeSelectionRange = null
+    }
 
     val currentText = text?.toString() ?: ""
     if (currentText != lastAuthorizedText) return
@@ -296,6 +300,7 @@ internal fun EditorEditText.applySelectionFromJSON(
         val currentText = text?.toString() ?: ""
         when (type) {
             "text" -> {
+                authoritativeNodeSelectionRange = null
                 val docAnchor = exactV2ScalarInt(selection.opt("anchor") as? Number) ?: return
                 val docHead = exactV2ScalarInt(selection.opt("head") as? Number) ?: return
                 // The frozen v2 update includes exact scalar positions alongside its
@@ -339,10 +344,12 @@ internal fun EditorEditText.applySelectionFromJSON(
                 val clamped = startUtf16.coerceIn(0, len)
                 val endClamped = (clamped + 1).coerceAtMost(len)
                 setSelection(clamped, endClamped)
+                authoritativeNodeSelectionRange = ImageSelectionRange(clamped, endClamped)
             }
 
             "all" -> {
                 logicalSelectionSnapshot = null
+                authoritativeNodeSelectionRange = null
                 selectAll()
             }
         }

package/android/src/main/java/com/apollohg/editor/EditorTextSurfaceInteraction.kt

@@ -391,21 +391,30 @@ internal class EditorTextSurfaceInteraction(
                         0,
                         android.R.string.copy
                     ).setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM)
-                    if ((view as? EditorEditText)?.isEditable != false) {
+                    val editor = view as? EditorEditText
+                    if (editor?.isEditable != false) {
                         menu.add(
                             0,
                             android.R.id.cut,
                             1,
                             android.R.string.cut
                         ).setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM)
-                        menu.add(
-                            0,
-                            android.R.id.paste,
-                            2,
-                            android.R.string.paste
-                        ).setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM)
+                        if (editor?.pasteMode != EditorPasteMode.DISABLED) {
+                            menu.add(
+                                0,
+                                android.R.id.paste,
+                                2,
+                                android.R.string.paste
+                            ).setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM)
+                            menu.add(
+                                0,
+                                android.R.id.pasteAsPlainText,
+                                3,
+                                android.R.string.paste_as_plain_text
+                            )
+                        }
                     }
-                    menu.add(0, android.R.id.selectAll, 3, android.R.string.selectAll)
+                    menu.add(0, android.R.id.selectAll, 4, android.R.string.selectAll)
                     return true
                 }
                 override fun onPrepareActionMode(mode: ActionMode, menu: Menu) = false
@@ -457,12 +466,20 @@ internal class EditorTextSurfaceInteraction(
     }
 
     fun onKeyDown(keyCode: Int, event: KeyEvent): Boolean {
-        if (event.isCtrlPressed) {
+        if (event.isCtrlPressed || event.isMetaPressed) {
             val action = when (keyCode) {
                 KeyEvent.KEYCODE_A -> android.R.id.selectAll
+
                 KeyEvent.KEYCODE_C -> android.R.id.copy
+
                 KeyEvent.KEYCODE_X -> android.R.id.cut
-                KeyEvent.KEYCODE_V -> android.R.id.paste
+
+                KeyEvent.KEYCODE_V -> if (event.isShiftPressed) {
+                    android.R.id.pasteAsPlainText
+                } else {
+                    android.R.id.paste
+                }
+
                 else -> 0
             }
             if (action != 0) return view.onTextContextMenuItem(action)
@@ -559,10 +576,13 @@ internal class EditorTextSurfaceInteraction(
         info.addAction(AccessibilityNodeInfo.ACTION_NEXT_AT_MOVEMENT_GRANULARITY)
         info.addAction(AccessibilityNodeInfo.ACTION_PREVIOUS_AT_MOVEMENT_GRANULARITY)
         info.addAction(AccessibilityNodeInfo.ACTION_COPY)
+        val editor = view as? EditorEditText
         if (info.isEditable) {
             info.addAction(AccessibilityNodeInfo.ACTION_SET_TEXT)
             info.addAction(AccessibilityNodeInfo.ACTION_CUT)
-            info.addAction(AccessibilityNodeInfo.ACTION_PASTE)
+            if (editor?.pasteMode != EditorPasteMode.DISABLED) {
+                info.addAction(AccessibilityNodeInfo.ACTION_PASTE)
+            }
         }
     }
 

package/android/src/main/java/com/apollohg/editor/EditorV2Adapter.kt

@@ -796,6 +796,42 @@ internal class EditorV2Adapter private constructor(
         )
     }
 
+    override fun clipboardJson(): String? {
+        if (destroyed) return null
+        return when (val result = backend.getClipboard(editorId)) {
+            is EditorV2CallResult.Ok -> result.value
+
+            is EditorV2CallResult.Err -> {
+                emit(result.error)
+                null
+            }
+        }
+    }
+
+    override fun pasteAtSelection(
+        fragment: String?,
+        html: String?,
+        text: String?,
+        plainText: Boolean,
+        anchor: Int,
+        head: Int,
+        preserveEngineSelection: Boolean
+    ): String? {
+        val command = JSONObject().put("type", "paste")
+        fragment?.let { command.put("fragment", it) }
+        html?.let { command.put("html", it) }
+        text?.let { command.put("text", it) }
+        if (plainText) command.put("plainText", true)
+        return performMutation(
+            preSelection = if (preserveEngineSelection) null else intArrayOf(anchor, head),
+            adoptEngineSelection = true
+        ) {
+            callWithEnvelope(JSONObject().put("command", command)) { requestJson ->
+                backend.applyCommand(editorId, requestJson)
+            }
+        }
+    }
+
     override fun toggleMark(markName: String, anchor: Int, head: Int): String? = commandAtSelection(
         JSONObject().put("type", "toggleMark").put("markType", markName),
         anchor,

package/android/src/main/java/com/apollohg/editor/EditorV2Backend.kt

@@ -37,6 +37,7 @@ internal interface EditorV2Backend {
     fun getDocumentJson(editorId: String): EditorV2CallResult<String>
     fun getDocumentHtml(editorId: String): EditorV2CallResult<String>
     fun getContentSnapshot(editorId: String): EditorV2CallResult<String>
+    fun getClipboard(editorId: String): EditorV2CallResult<String>
     fun applyInput(editorId: String, requestJson: String): EditorV2CallResult<String>
     fun applyCommand(editorId: String, requestJson: String): EditorV2CallResult<String>
     fun applyLocalApi(editorId: String, requestJson: String): EditorV2CallResult<String>

package/android/src/main/java/com/apollohg/editor/EditorV2Driver.kt

@@ -50,6 +50,16 @@ internal interface EditorV2Driver {
     fun insertNode(nodeType: String, anchor: Int, head: Int): String?
     fun insertContentHtmlAtSelection(html: String, anchor: Int, head: Int): String?
     fun insertContentJsonAtSelection(json: String, anchor: Int, head: Int): String?
+    fun clipboardJson(): String?
+    fun pasteAtSelection(
+        fragment: String?,
+        html: String?,
+        text: String?,
+        plainText: Boolean,
+        anchor: Int,
+        head: Int,
+        preserveEngineSelection: Boolean = false
+    ): String?
     fun toggleMark(markName: String, anchor: Int, head: Int): String?
     fun setMark(markName: String, attrsJson: String, anchor: Int, head: Int): String?
     fun unsetMark(markName: String, anchor: Int, head: Int): String?

package/android/src/main/java/com/apollohg/editor/NativeEditorExpoView.kt

@@ -388,6 +388,8 @@ class NativeEditorExpoView(context: Context, appContext: AppContext) :
 
     fun setEditable(editable: Boolean) = setEditableImpl(editable)
 
+    fun setPasteMode(rawPasteMode: String?) = setPasteModeImpl(rawPasteMode)
+
     fun beginExternalTextComposition(sessionId: String): String =
         beginExternalTextCompositionImpl(sessionId)
 

package/android/src/main/java/com/apollohg/editor/NativeEditorExpoViewProperties.kt

@@ -140,6 +140,10 @@ internal fun NativeEditorExpoView.setEditableImpl(editable: Boolean) {
     updateKeyboardToolbarVisibility()
 }
 
+internal fun NativeEditorExpoView.setPasteModeImpl(rawPasteMode: String?) {
+    richTextView.editorEditText.pasteMode = EditorPasteMode.fromRaw(rawPasteMode)
+}
+
 internal fun NativeEditorExpoView.setAccessibilityLabelImpl(label: String?) {
     richTextView.editorEditText.contentDescription = label
 }

package/android/src/main/java/com/apollohg/editor/NativeEditorModule.kt

@@ -520,6 +520,9 @@ class NativeEditorModule : Module() {
             Prop("editable") { view: NativeEditorExpoView, editable: Boolean ->
                 view.setEditable(editable)
             }
+            Prop("pasteMode") { view: NativeEditorExpoView, pasteMode: String? ->
+                view.setPasteMode(pasteMode)
+            }
             Prop("accessibilityLabel") { view: NativeEditorExpoView, label: String? ->
                 view.setAccessibilityLabel(label)
             }

package/android/src/main/java/com/apollohg/editor/UniffiEditorV2Backend.kt

@@ -20,6 +20,7 @@ import uniffi.editor_core.editorV2CollaborationSocketOpen
 import uniffi.editor_core.editorV2Create
 import uniffi.editor_core.editorV2Destroy
 import uniffi.editor_core.editorV2DocToScalar
+import uniffi.editor_core.editorV2GetClipboard
 import uniffi.editor_core.editorV2GetContentSnapshot
 import uniffi.editor_core.editorV2GetDocumentHtml
 import uniffi.editor_core.editorV2GetDocumentJson
@@ -77,6 +78,9 @@ internal object UniffiEditorV2Backend : EditorV2Backend {
     override fun getContentSnapshot(editorId: String): EditorV2CallResult<String> =
         normalize(editorV2GetContentSnapshot(editorId))
 
+    override fun getClipboard(editorId: String): EditorV2CallResult<String> =
+        normalize(editorV2GetClipboard(editorId))
+
     override fun applyInput(editorId: String, requestJson: String): EditorV2CallResult<String> =
         normalize(editorV2ApplyInput(editorId, requestJson))
 

package/dist/NativeRichTextEditor.d.ts

@@ -1,3 +1,3 @@
-export { type RichTextEditorHeightBehavior, type RichTextEditorToolbarPlacement, type RichTextEditorValueJSONUpdateMode, type RichTextEditorAutoCapitalize, type RichTextEditorKeyboardType, type RichTextEditorAndroidInputOptions, type RemoteSelectionDecoration, type LinkRequestContext, type ImageRequestContext, type RichTextEditorProps, type RichTextEditorRef, type RichTextEditorCaretRect, type NativeRichTextEditorHeightBehavior, type NativeRichTextEditorToolbarPlacement, type NativeRichTextEditorValueJSONUpdateMode, type NativeRichTextEditorAutoCapitalize, type NativeRichTextEditorKeyboardType, type NativeRichTextEditorAndroidInputOptions, type NativeRichTextEditorProps, type NativeRichTextEditorRef, type NativeRichTextEditorCaretRect, } from './RichTextEditorTypes';
+export { type RichTextEditorHeightBehavior, type RichTextEditorToolbarPlacement, type RichTextEditorValueJSONUpdateMode, type RichTextEditorPasteMode, type RichTextEditorAutoCapitalize, type RichTextEditorKeyboardType, type RichTextEditorAndroidInputOptions, type RemoteSelectionDecoration, type LinkRequestContext, type ImageRequestContext, type RichTextEditorProps, type RichTextEditorRef, type RichTextEditorCaretRect, type NativeRichTextEditorHeightBehavior, type NativeRichTextEditorToolbarPlacement, type NativeRichTextEditorValueJSONUpdateMode, type NativeRichTextEditorAutoCapitalize, type NativeRichTextEditorKeyboardType, type NativeRichTextEditorAndroidInputOptions, type NativeRichTextEditorProps, type NativeRichTextEditorRef, type NativeRichTextEditorCaretRect, } from './RichTextEditorTypes';
 export { RichTextEditor, NativeRichTextEditor } from './RichTextEditor';
 export type { NativeRichTextEditorFocusPreservingElement, NativeRichTextEditorFocusPreservingRef, NativeRichTextEditorFocusPreservingRefs, RichTextEditorFocusPreservingElement, RichTextEditorFocusPreservingRef, RichTextEditorFocusPreservingRefs, } from './useFocusPreservingFrames';

package/dist/RichTextEditorNativeTypes.d.ts

@@ -2,7 +2,7 @@ import { type ExternalTextCompositionManager, type NativeExternalTextComposition
 import { type ReactNode } from 'react';
 import { type NativeSyntheticEvent, type StyleProp, type ViewStyle } from 'react-native';
 import { type DocumentJSON, type NativeEditorDocumentHandle } from './NativeEditorBridge';
-import { type RichTextEditorAutoCapitalize, type RichTextEditorKeyboardType, type RichTextEditorToolbarPlacement, type RichTextEditorHeightBehavior } from './RichTextEditorTypes';
+import { type RichTextEditorPasteMode, type RichTextEditorAutoCapitalize, type RichTextEditorKeyboardType, type RichTextEditorToolbarPlacement, type RichTextEditorHeightBehavior } from './RichTextEditorTypes';
 export interface NativeExternalTextCompositionEvent {
     editorId: string;
     resultJson: string;
@@ -21,6 +21,7 @@ export interface NativeEditorViewProps {
     editorId: string;
     placeholder?: string;
     editable: boolean;
+    pasteMode: RichTextEditorPasteMode;
     autoFocus: boolean;
     autoCapitalize?: RichTextEditorAutoCapitalize;
     autoCorrect?: boolean;

package/dist/RichTextEditorTypes.d.ts

@@ -24,6 +24,8 @@ export type RichTextEditorToolbarPlacement = 'keyboard' | 'inline';
  * records one undoable step, `'reset'` clears history entirely.
  */
 export type RichTextEditorValueJSONUpdateMode = 'replace' | 'reset';
+/** Controls native clipboard paste. Plain text keeps destination typing marks. */
+export type RichTextEditorPasteMode = 'rich' | 'plainText' | 'disabled';
 /** Native keyboard auto-capitalization behavior. */
 export type RichTextEditorAutoCapitalize = 'none' | 'sentences' | 'words' | 'characters';
 /** Native keyboard layout. Values not supported by a platform fall back to its default. */
@@ -104,6 +106,8 @@ export interface RichTextEditorProps {
     placeholder?: string;
     /** Whether the editor is editable. Defaults to true. When false, every mutation ref method rejects with MUTATION_REJECTED; selection and controlled content still flow. */
     editable?: boolean;
+    /** Clipboard paste policy. Defaults to rich; updates apply immediately. */
+    pasteMode?: RichTextEditorPasteMode;
     /** Whether to auto-focus on mount. */
     autoFocus?: boolean;
     /** Controls native keyboard auto-capitalization. Defaults to sentences. */

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { RichTextEditor, type RichTextEditorProps, type RichTextEditorRef, type RichTextEditorCaretRect, type RichTextEditorHeightBehavior, type RichTextEditorToolbarPlacement, type RichTextEditorValueJSONUpdateMode, type RichTextEditorAutoCapitalize, type RichTextEditorKeyboardType, type RichTextEditorAndroidInputOptions, type RichTextEditorFocusPreservingElement, type RichTextEditorFocusPreservingRef, type RichTextEditorFocusPreservingRefs, type RemoteSelectionDecoration, type LinkRequestContext, type ImageRequestContext, NativeRichTextEditor, type NativeRichTextEditorProps, type NativeRichTextEditorRef, type NativeRichTextEditorCaretRect, type NativeRichTextEditorHeightBehavior, type NativeRichTextEditorToolbarPlacement, type NativeRichTextEditorValueJSONUpdateMode, type NativeRichTextEditorAutoCapitalize, type NativeRichTextEditorKeyboardType, type NativeRichTextEditorAndroidInputOptions, type NativeRichTextEditorFocusPreservingElement, type NativeRichTextEditorFocusPreservingRef, type NativeRichTextEditorFocusPreservingRefs, } from './NativeRichTextEditor';
+export { RichTextEditor, type RichTextEditorProps, type RichTextEditorRef, type RichTextEditorCaretRect, type RichTextEditorHeightBehavior, type RichTextEditorToolbarPlacement, type RichTextEditorValueJSONUpdateMode, type RichTextEditorPasteMode, type RichTextEditorAutoCapitalize, type RichTextEditorKeyboardType, type RichTextEditorAndroidInputOptions, type RichTextEditorFocusPreservingElement, type RichTextEditorFocusPreservingRef, type RichTextEditorFocusPreservingRefs, type RemoteSelectionDecoration, type LinkRequestContext, type ImageRequestContext, NativeRichTextEditor, type NativeRichTextEditorProps, type NativeRichTextEditorRef, type NativeRichTextEditorCaretRect, type NativeRichTextEditorHeightBehavior, type NativeRichTextEditorToolbarPlacement, type NativeRichTextEditorValueJSONUpdateMode, type NativeRichTextEditorAutoCapitalize, type NativeRichTextEditorKeyboardType, type NativeRichTextEditorAndroidInputOptions, type NativeRichTextEditorFocusPreservingElement, type NativeRichTextEditorFocusPreservingRef, type NativeRichTextEditorFocusPreservingRefs, } from './NativeRichTextEditor';
 export type { ExternalTextCompositionEndCause, ExternalTextCompositionEndEvent, ExternalTextCompositionOptions, ExternalTextCompositionSession, } from './ExternalTextComposition';
 export { RichTextViewer, type RichTextViewerProps, type RichTextViewerAddons, type RichTextViewerBaseProps, type RichTextViewerMentionsConfig, type RichTextViewerLinkPressEvent, type RichTextViewerMentionPressEvent, type RichTextViewerErrorEvent, type RichTextViewerAtomAttrsUpdateEvent, NativeProseViewer, type NativeProseViewerProps, type NativeProseViewerAddons, type NativeProseViewerBaseProps, type NativeProseViewerMentionsConfig, type NativeProseViewerLinkPressEvent, type NativeProseViewerMentionPressEvent, type NativeProseViewerErrorEvent, type NativeProseViewerAtomAttrsUpdateEvent, } from './NativeProseViewer';
 export { EditorToolbar, DEFAULT_EDITOR_TOOLBAR_ITEMS, type EditorToolbarProps, type EditorToolbarItem, type EditorToolbarLeafItem, type EditorToolbarGroupChildItem, type EditorToolbarGroupItem, type EditorToolbarGroupPresentation, type EditorToolbarIcon, type EditorToolbarButtonStyle, type EditorToolbarDefaultIconId, type EditorToolbarSFSymbolIcon, type EditorToolbarMaterialIcon, type EditorToolbarCommand, type EditorToolbarHeadingLevel, type EditorToolbarListType, type EditorToolbarItemPlacement, } from './EditorToolbar';