react-native-enriched-markdown-scaffold 0.7.4-scaffold.10 → 0.7.4-scaffold.12

package/android/src/main/java/com/swmansion/enriched/markdown/utils/text/view/SelectionActionMode.kt

@@ -57,6 +57,10 @@ fun createSelectionActionModeCallback(
   textView: TextView,
   getCustomItemTexts: () -> List<String> = { emptyList() },
   getSelectionMenuConfig: () -> SelectionMenuConfig = { SelectionMenuConfig() },
+  isContextMenuHidden: () -> Boolean = { false },
+  // Lets the owning view hold the live ActionMode so it can invalidate() the
+  // toolbar when a prop changes while the menu is already on screen.
+  onActionModeChanged: (mode: ActionMode?) -> Unit = {},
   onCustomItemPress: (itemText: String, selectedText: String, selectionStart: Int, selectionEnd: Int) -> Unit =
     { _, _, _, _ -> },
 ): ActionMode.Callback =
@@ -64,7 +68,10 @@ fun createSelectionActionModeCallback(
     override fun onCreateActionMode(
       mode: ActionMode?,
       menu: Menu?,
-    ): Boolean = true
+    ): Boolean {
+      onActionModeChanged(mode)
+      return true
+    }
 
     override fun onPrepareActionMode(
       mode: ActionMode?,
@@ -72,6 +79,14 @@ fun createSelectionActionModeCallback(
     ): Boolean {
       if (menu == null) return false
 
+      // Keep the ActionMode alive (selection handles and highlighting stay
+      // usable, which is what TalkBack relies on) but ship an empty menu so
+      // the floating toolbar has nothing to show.
+      if (isContextMenuHidden()) {
+        menu.clear()
+        return true
+      }
+
       menu.removeItem(MENU_ITEM_COPY_MARKDOWN)
       menu.removeItem(MENU_ITEM_COPY_IMAGE_URL)
       menu.removeGroup(MENU_ITEM_CUSTOM_GROUP)
@@ -161,7 +176,9 @@ fun createSelectionActionModeCallback(
       return false
     }
 
-    override fun onDestroyActionMode(mode: ActionMode?) {}
+    override fun onDestroyActionMode(mode: ActionMode?) {
+      onActionModeChanged(null)
+    }
   }
 
 /** Copies selection as both plain text and HTML with inline styles. */

package/android/src/main/java/com/swmansion/enriched/markdown/views/TableContainerView.kt

@@ -63,6 +63,7 @@ class TableContainerView(
 
   var copyLabel: String = ""
   var copyAsMarkdownLabel: String = ""
+  var contextMenuHidden: Boolean = false
 
   private val scrollView =
     HorizontalScrollView(context).apply {
@@ -337,6 +338,7 @@ class TableContainerView(
   }
 
   private fun showContextMenu(anchor: View) {
+    if (contextMenuHidden) return
     val clipboard = context.getSystemService(Context.CLIPBOARD_SERVICE) as ClipboardManager
     ContextMenuPopup.show(anchor, this) {
       item(ContextMenuPopup.Icon.COPY, copyLabel) {

package/android/src/math/java/com/swmansion/enriched/markdown/views/MathContainerView.kt

@@ -41,6 +41,7 @@ class MathContainerView(
   // Set reflectively by EnrichedMarkdown (math is an optional module).
   var copyLabel: String = ""
   var copyAsMarkdownLabel: String = ""
+  var contextMenuHidden: Boolean = false
 
   override val segmentMarginTop: Int get() = mathStyle.marginTop.toInt()
   override val segmentMarginBottom: Int get() = mathStyle.marginBottom.toInt()
@@ -117,6 +118,7 @@ class MathContainerView(
   }
 
   private fun showContextMenu(anchor: View) {
+    if (contextMenuHidden) return
     val clipboard = context.getSystemService(Context.CLIPBOARD_SERVICE) as ClipboardManager
     ContextMenuPopup.show(anchor, this) {
       item(ContextMenuPopup.Icon.COPY, copyLabel) {

package/docs/API_REFERENCE.md

@@ -105,6 +105,36 @@ Whether text can be selected.
 | --------- | ------------- | -------- |
 | `boolean` | `true`         | Both     |
 
+### `contextMenuHidden`
+
+Hides the text selection context menu. Text stays selectable — only the menu is
+suppressed. This is deliberately different from `selectable={false}`, which
+disables selection altogether and, on Android, also removes the text from the
+TalkBack focus order.
+
+| Type      | Default Value | Platform    |
+| --------- | ------------- | ----------- |
+| `boolean` | `false`       | Both, macOS |
+
+```tsx
+// Text can still be selected, but long-press shows no menu
+<EnrichedMarkdownText markdown={content} contextMenuHidden />
+```
+
+Notes:
+
+- It hides the **whole** menu. The custom items from `contextMenuItems` and the
+  built-in items from `selectionMenuConfig` share that same menu, so they are
+  hidden too. To drop individual items instead, use `selectionMenuConfig`.
+- It also covers the separate copy menus on table and math blocks (which appear
+  with `flavor="github"`), not just the text selection menu.
+- It does **not** suppress the system "Save to Camera Roll / Copy" sheet that
+  UIKit shows when long-pressing an image — that sheet is owned by UIKit.
+- On macOS the menu opens on click-with-selection rather than long-press; the
+  prop suppresses it the same way.
+- Applies to `EnrichedMarkdownText` only — it does not affect
+  `EnrichedMarkdownTextInput`.
+
 ### `selectionColor`
 
 Color of the text selection highlight. On iOS, this also affects the caret and selection handle colors (they share a single tint). On macOS, only the selection background is affected. On Android, use `selectionHandleColor` to override the handle color independently.
@@ -532,6 +562,18 @@ Auto-capitalization behavior.
 | -------- | -------------- | -------- |
 | `string` | `'sentences'`  | Both     |
 
+### `interceptPaste`
+
+Reports pastes through [`onPaste`](#onpaste) instead of inserting them. Only takes effect when `onPaste` is also set — otherwise native would swallow every paste with nobody left to resolve it, so the library keeps the prop off.
+
+See [Intercepting paste](./INPUT.md#intercepting-paste).
+
+| Type      | Default Value | Platform      |
+| --------- | ------------- | ------------- |
+| `boolean` | `false`       | iOS, Android  |
+
+macOS ignores this prop and always pastes inline.
+
 ### `multiline`
 
 Whether the input supports multiple lines.
@@ -710,6 +752,18 @@ Fires when the active mention flow ends.
 | ---- | ------------- | -------- |
 | `(event: { indicator: string }) => void` | - | Both |
 
+### `onPaste`
+
+Fires instead of the insert when [`interceptPaste`](#interceptpaste) is on. Native reads the clipboard and leaves the buffer untouched, so the handler owns the paste from that point: it must call [`resolvePaste`](#resolvepastetext-string-markdown-string) exactly once, on every path including failures, or the paste is silently dropped.
+
+| Type | Default Value | Platform |
+| ---- | ------------- | -------- |
+| `(event: { text: string; markdown: string }) => void` | - | iOS, Android |
+
+`markdown` is non-empty only when the copy source was an `EnrichedMarkdownTextInput`, which the system clipboard can only carry on iOS; Android always reports `''`.
+
+See [Intercepting paste](./INPUT.md#intercepting-paste).
+
 ### `writingDirection`
 
 Paragraph writing direction in the input. iOS only — Android's `EditText` already resolves direction per paragraph via `TEXT_DIRECTION_FIRST_STRONG` and is unaffected by this prop.
@@ -942,6 +996,16 @@ Copies the input's full content to the system clipboard, matching the result of
 
 On iOS and macOS the clipboard receives both plain text and a private Markdown pasteboard type, so pasting back into an `EnrichedMarkdownTextInput` restores the formatting; external apps receive plain text only. On Android the clipboard receives plain text only — inline styles are not preserved for any paste target.
 
+### `resolvePaste(text: string, markdown?: string)`
+
+Completes a paste reported through [`onPaste`](#onpaste). Call it exactly once per event:
+
+- `resolvePaste(text, markdown)` — inserts, restoring the copied formatting when `markdown` is non-empty.
+- `resolvePaste(text)` — inserts `text` verbatim.
+- `resolvePaste('', '')` — drops the clipboard content, replacing the current selection. With an empty selection this is a no-op that still emits `onChangeText` with unchanged content.
+
+Anything that replaces a selection replaces it here too, so a paste over selected text behaves the same on every branch.
+
 ### `startMention(indicator: string)`
 
 Programmatically triggers a mention flow by inserting the indicator character at the current cursor position. The indicator must be listed in the `mentionIndicators` prop. Useful for toolbar buttons.

package/docs/COPY_OPTIONS.md

@@ -44,6 +44,19 @@ Use `selectionMenuConfig` to hide built-in selection menu actions while keeping
 />
 ```
 
+To turn the menu off entirely rather than item by item, use `contextMenuHidden`:
+
+```tsx
+// No selection menu at all — text is still selectable
+<EnrichedMarkdownText markdown={content} contextMenuHidden />
+```
+
+The two are complementary: `selectionMenuConfig` prunes individual built-in
+items and leaves the menu in place, while `contextMenuHidden` suppresses the
+menu as a whole — including `contextMenuItems` and the copy menus on table and
+math blocks. Note that `contextMenuHidden` applies to `EnrichedMarkdownText`
+only; it does not affect `EnrichedMarkdownTextInput`.
+
 `EnrichedMarkdownTextInput` supports the same `{ enabled, label }` shape. In addition to `copyAsMarkdown`, the input's `selectionMenuConfig` exposes the built-in **Format** submenu, and `formatMenuConfig` controls the items inside it:
 
 ```tsx

package/docs/INPUT.md

@@ -205,6 +205,45 @@ The input's content can be copied to the system clipboard from a ref, without re
 
 On iOS and macOS the clipboard receives both plain text and a private Markdown pasteboard type, so pasting back into an `EnrichedMarkdownTextInput` restores the formatting; external apps receive plain text only. On Android the clipboard receives plain text only — inline styles are not preserved for any paste target.
 
+## Intercepting paste
+
+By default a paste goes straight into the buffer. Set [`interceptPaste`](API_REFERENCE.md#interceptpaste) together with [`onPaste`](API_REFERENCE.md#onpaste) to decide what a paste means before any text lands — turning a long paste into an attachment chip, stripping it, or inserting it unchanged.
+
+```tsx
+const inputRef = useRef<EnrichedMarkdownTextInputInstance>(null);
+
+<EnrichedMarkdownTextInput
+  ref={inputRef}
+  interceptPaste
+  onPaste={({ text, markdown }) => {
+    if (text.length > 2000) {
+      attachAsFile(text);
+      inputRef.current?.resolvePaste('', ''); // drops it, and replaces the selection
+      return;
+    }
+    inputRef.current?.resolvePaste(text, markdown);
+  }}
+/>
+```
+
+Native reads the clipboard and **does not touch the buffer**. That makes the handler the only thing that can complete the paste, so the contract is strict:
+
+- Call [`resolvePaste`](API_REFERENCE.md#resolvepastetext-string-markdown-string) **exactly once per event, on every path including failures**. A handler that throws before resolving leaves the paste dropped — the user sees nothing happen.
+- Pass `markdown` back through when inserting. It is the copied formatting; dropping it turns a copy-then-paste inside your app into flat text.
+- `interceptPaste` is ignored unless `onPaste` is set, so switching the prop on alone cannot make the input swallow pastes.
+
+Because nothing is written until you resolve, an async decision is safe: the selection is still there, and the user sees an unchanged input rather than text that vanished.
+
+### Platform behavior
+
+| | Behavior |
+| --- | --- |
+| **iOS** | Context menu and hardware ⌘V. `markdown` is set when the copy source was an `EnrichedMarkdownTextInput`. |
+| **Android** | Context menu, hardware Ctrl+V and `KEYCODE_PASTE`. `markdown` is always `''` — the Android clipboard carries plain text only. |
+| **macOS** | `interceptPaste` is ignored, `onPaste` never fires, and pastes insert inline as usual. |
+
+Only clipboard content is intercepted. Drag-and-drop, autofill and IME content insertion bypass `onPaste` on both platforms and insert normally — on Android they are filtered out explicitly, so an autofill never arrives looking like a paste.
+
 ## Style Detection
 
 All of the above styles can be detected with the use of [onChangeState](API_REFERENCE.md#onchangestate) callback payload.

package/docs/WEB.md

@@ -41,6 +41,7 @@ The web implementation also exports `WebMarkdownTextProps` which extends `Enrich
 | `streamingConfig` | Native-only streaming table configuration. Not yet implemented on web. |
 | `contextMenuItems` | Not supported — browsers don't allow extending the native context menu. |
 | `selectionMenuConfig` | Not supported — native-only built-in selection menu actions. |
+| `contextMenuHidden` | Not supported — browsers own the context menu on selected text. |
 | `selectionHandleColor` | Android-only — desktop browsers don't render selection handles. |
 
 ## Not supported on web

package/ios/EnrichedMarkdown.mm

@@ -98,6 +98,7 @@ static char kENRMSegmentFadeAnimatorKey;
   BOOL _allowTrailingMargin;
   BOOL _selectable;
   BOOL _enableLinkPreview;
+  BOOL _contextMenuHidden;
   BOOL _streamingAnimation;
   ENRMTableStreamingMode _tableStreamingMode;
 
@@ -179,6 +180,7 @@ static char kENRMSegmentFadeAnimatorKey;
 
     _selectable = YES;
     _enableLinkPreview = YES;
+    _contextMenuHidden = NO;
     _selectionMenuConfig = (ENRMSelectionMenuConfig){.copyAsMarkdown = YES, .copyImageURL = YES};
     _resolvedLayoutDirection =
         [[RCTI18nUtil sharedInstance] isRTL] ? NSWritingDirectionRightToLeft : NSWritingDirectionLeftToRight;
@@ -450,12 +452,14 @@ static char kENRMSegmentFadeAnimatorKey;
       TableContainerView *tableView = (TableContainerView *)segment;
       tableView.copyLabel = _selectionMenuLabels.copyLabel;
       tableView.copyAsMarkdownLabel = _selectionMenuLabels.copyAsMarkdownLabel;
+      tableView.contextMenuHidden = _contextMenuHidden;
     }
 #if ENRICHED_MARKDOWN_MATH
     else if ([segment isKindOfClass:[ENRMMathContainerView class]]) {
       ENRMMathContainerView *mathView = (ENRMMathContainerView *)segment;
       mathView.copyLabel = _selectionMenuLabels.copyLabel;
       mathView.copyAsMarkdownLabel = _selectionMenuLabels.copyAsMarkdownLabel;
+      mathView.contextMenuHidden = _contextMenuHidden;
     }
 #endif
   }
@@ -647,6 +651,9 @@ static char kENRMSegmentFadeAnimatorKey;
     if (!strongSelf) {
       return baseMenu;
     }
+    if (strongSelf->_contextMenuHidden) {
+      return nil;
+    }
     NSString *segmentMarkdown = extractMarkdownFromAttributedString(textView.textStorage, textView.selectedRange);
     NSArray<NSMenuItem *> *customItems = ENRMBuildContextMenuItems(
         strongSelf->_contextMenuItemTexts, strongSelf->_contextMenuItemIcons, textView,
@@ -676,6 +683,7 @@ static char kENRMSegmentFadeAnimatorKey;
   tableView.accessibilityLabels = _accessibilityLabels;
   tableView.copyLabel = _selectionMenuLabels.copyLabel;
   tableView.copyAsMarkdownLabel = _selectionMenuLabels.copyAsMarkdownLabel;
+  tableView.contextMenuHidden = _contextMenuHidden;
 
   __weak EnrichedMarkdown *weakSelf = self;
 
@@ -715,6 +723,7 @@ static char kENRMSegmentFadeAnimatorKey;
   mathView.accessibilityLabels = _accessibilityLabels;
   mathView.copyLabel = _selectionMenuLabels.copyLabel;
   mathView.copyAsMarkdownLabel = _selectionMenuLabels.copyAsMarkdownLabel;
+  mathView.contextMenuHidden = _contextMenuHidden;
   [mathView applyLatex:mathSegment.latex];
   return mathView;
 }
@@ -838,6 +847,7 @@ static char kENRMSegmentFadeAnimatorKey;
   }
 
   _enableLinkPreview = newViewProps.enableLinkPreview;
+  _contextMenuHidden = newViewProps.contextMenuHidden;
 
   if (newViewProps.streamingAnimation != oldViewProps.streamingAnimation) {
     _streamingAnimation = newViewProps.streamingAnimation;
@@ -1132,6 +1142,10 @@ Class<RCTComponentViewProtocol> EnrichedMarkdownCls(void)
     editMenuForTextInRange:(NSRange)range
           suggestedActions:(NSArray<UIMenuElement *> *)suggestedActions API_AVAILABLE(ios(16.0))
 {
+  if (_contextMenuHidden) {
+    return nil;
+  }
+
   __weak EnrichedMarkdown *weakSelf = self;
   ENRMContextMenuPressHandler handler =
       ^(NSString *itemText, NSString *selectedText, NSUInteger selectionStart, NSUInteger selectionEnd) {

package/ios/EnrichedMarkdownText.mm

@@ -80,6 +80,7 @@ typedef NS_OPTIONS(NSUInteger, ENRMDirtyFlags) {
   CGFloat _lastElementMarginBottom;
   BOOL _allowTrailingMargin;
   BOOL _enableLinkPreview;
+  BOOL _contextMenuHidden;
   BOOL _streamingAnimation;
   BOOL _forceHeightUpdateOnNextRender;
 
@@ -231,6 +232,7 @@ typedef NS_OPTIONS(NSUInteger, ENRMDirtyFlags) {
         [[ENRMAsyncRenderCoordinator alloc] initWithQueueLabel:"com.swmansion.enriched.markdown.render"];
 
     _enableLinkPreview = YES;
+    _contextMenuHidden = NO;
     _selectionMenuConfig = (ENRMSelectionMenuConfig){.copyAsMarkdown = YES, .copyImageURL = YES};
     _resolvedLayoutDirection =
         [[RCTI18nUtil sharedInstance] isRTL] ? NSWritingDirectionRightToLeft : NSWritingDirectionLeftToRight;
@@ -280,6 +282,9 @@ typedef NS_OPTIONS(NSUInteger, ENRMDirtyFlags) {
     if (!strongSelf) {
       return baseMenu;
     }
+    if (strongSelf->_contextMenuHidden) {
+      return nil;
+    }
     NSArray<NSMenuItem *> *customItems = ENRMBuildContextMenuItems(
         strongSelf->_contextMenuItemTexts, strongSelf->_contextMenuItemIcons, textView,
         ^(NSString *itemText, NSString *selectedText, NSUInteger selectionStart, NSUInteger selectionEnd) {
@@ -566,6 +571,7 @@ typedef NS_OPTIONS(NSUInteger, ENRMDirtyFlags) {
   }
 
   _enableLinkPreview = newViewProps.enableLinkPreview;
+  _contextMenuHidden = newViewProps.contextMenuHidden;
 
   if (ENRMContextMenuItemsChanged(oldViewProps.contextMenuItems, newViewProps.contextMenuItems)) {
     _contextMenuItemTexts = ENRMContextMenuTextsFromItems(newViewProps.contextMenuItems);
@@ -790,6 +796,10 @@ Class<RCTComponentViewProtocol> EnrichedMarkdownTextCls(void)
     editMenuForTextInRange:(NSRange)range
           suggestedActions:(NSArray<UIMenuElement *> *)suggestedActions API_AVAILABLE(ios(16.0))
 {
+  if (_contextMenuHidden) {
+    return nil;
+  }
+
   __weak EnrichedMarkdownText *weakSelf = self;
   ENRMContextMenuPressHandler handler =
       ^(NSString *itemText, NSString *selectedText, NSUInteger selectionStart, NSUInteger selectionEnd) {

package/ios/generated/ReactCodegen/EnrichedMarkdownTextSpec/EventEmitters.cpp

@@ -247,6 +247,16 @@ payload.setProperty(runtime, "height", event.height);
 }
 
 
+void EnrichedMarkdownTextInputEventEmitter::onPaste(OnPaste event) const {
+  dispatchEvent("paste", [event=std::move(event)](jsi::Runtime &runtime) {
+    auto payload = jsi::Object(runtime);
+    payload.setProperty(runtime, "text", event.text);
+payload.setProperty(runtime, "markdown", event.markdown);
+    return payload;
+  });
+}
+
+
 void EnrichedMarkdownTextInputEventEmitter::onStartMention(OnStartMention event) const {
   dispatchEvent("startMention", [event=std::move(event)](jsi::Runtime &runtime) {
     auto payload = jsi::Object(runtime);

package/ios/generated/ReactCodegen/EnrichedMarkdownTextSpec/EventEmitters.h

@@ -182,6 +182,11 @@ class EnrichedMarkdownTextInputEventEmitter : public ViewEventEmitter {
     double height;
     };
 
+  struct OnPaste {
+      std::string text;
+    std::string markdown;
+    };
+
   struct OnStartMention {
       std::string indicator;
     };
@@ -218,6 +223,8 @@ class EnrichedMarkdownTextInputEventEmitter : public ViewEventEmitter {
 
   void onMathPress(OnMathPress value) const;
 
+  void onPaste(OnPaste value) const;
+
   void onStartMention(OnStartMention value) const;
 
   void onChangeMention(OnChangeMention value) const;

package/ios/generated/ReactCodegen/EnrichedMarkdownTextSpec/Props.cpp

@@ -32,6 +32,7 @@ EnrichedMarkdownProps::EnrichedMarkdownProps(
     streamingAnimation(convertRawProp(context, rawProps, "streamingAnimation", sourceProps.streamingAnimation, {false})),
     streamingConfig(convertRawProp(context, rawProps, "streamingConfig", sourceProps.streamingConfig, {})),
     spoilerOverlay(convertRawProp(context, rawProps, "spoilerOverlay", sourceProps.spoilerOverlay, {std::string{"particles"}})),
+    contextMenuHidden(convertRawProp(context, rawProps, "contextMenuHidden", sourceProps.contextMenuHidden, {false})),
     contextMenuItems(convertRawProp(context, rawProps, "contextMenuItems", sourceProps.contextMenuItems, {})),
     selectionMenuConfig(convertRawProp(context, rawProps, "selectionMenuConfig", sourceProps.selectionMenuConfig, {})),
     accessibilityLabels(convertRawProp(context, rawProps, "accessibilityLabels", sourceProps.accessibilityLabels, {})),
@@ -107,6 +108,10 @@ folly::dynamic EnrichedMarkdownProps::getDiffProps(
     result["spoilerOverlay"] = spoilerOverlay;
   }
     
+  if (contextMenuHidden != oldProps->contextMenuHidden) {
+    result["contextMenuHidden"] = contextMenuHidden;
+  }
+    
   if (contextMenuItems != oldProps->contextMenuItems) {
     result["contextMenuItems"] = toDynamic(contextMenuItems);
   }
@@ -146,6 +151,7 @@ EnrichedMarkdownTextInputProps::EnrichedMarkdownTextInputProps(
     scrollEnabled(convertRawProp(context, rawProps, "scrollEnabled", sourceProps.scrollEnabled, {false})),
     blockSyntax(convertRawProp(context, rawProps, "blockSyntax", sourceProps.blockSyntax, {false})),
     autoCapitalize(convertRawProp(context, rawProps, "autoCapitalize", sourceProps.autoCapitalize, {})),
+    interceptPaste(convertRawProp(context, rawProps, "interceptPaste", sourceProps.interceptPaste, {false})),
     multiline(convertRawProp(context, rawProps, "multiline", sourceProps.multiline, {false})),
     cursorColor(convertRawProp(context, rawProps, "cursorColor", sourceProps.cursorColor, {})),
     selectionColor(convertRawProp(context, rawProps, "selectionColor", sourceProps.selectionColor, {})),
@@ -211,6 +217,10 @@ folly::dynamic EnrichedMarkdownTextInputProps::getDiffProps(
     result["autoCapitalize"] = autoCapitalize;
   }
     
+  if (interceptPaste != oldProps->interceptPaste) {
+    result["interceptPaste"] = interceptPaste;
+  }
+    
   if (multiline != oldProps->multiline) {
     result["multiline"] = multiline;
   }
@@ -295,6 +305,7 @@ EnrichedMarkdownTextProps::EnrichedMarkdownTextProps(
     streamingAnimation(convertRawProp(context, rawProps, "streamingAnimation", sourceProps.streamingAnimation, {false})),
     streamingConfig(convertRawProp(context, rawProps, "streamingConfig", sourceProps.streamingConfig, {})),
     spoilerOverlay(convertRawProp(context, rawProps, "spoilerOverlay", sourceProps.spoilerOverlay, {std::string{"particles"}})),
+    contextMenuHidden(convertRawProp(context, rawProps, "contextMenuHidden", sourceProps.contextMenuHidden, {false})),
     contextMenuItems(convertRawProp(context, rawProps, "contextMenuItems", sourceProps.contextMenuItems, {})),
     selectionMenuConfig(convertRawProp(context, rawProps, "selectionMenuConfig", sourceProps.selectionMenuConfig, {})),
     accessibilityLabels(convertRawProp(context, rawProps, "accessibilityLabels", sourceProps.accessibilityLabels, {})),
@@ -370,6 +381,10 @@ folly::dynamic EnrichedMarkdownTextProps::getDiffProps(
     result["spoilerOverlay"] = spoilerOverlay;
   }
     
+  if (contextMenuHidden != oldProps->contextMenuHidden) {
+    result["contextMenuHidden"] = contextMenuHidden;
+  }
+    
   if (contextMenuItems != oldProps->contextMenuItems) {
     result["contextMenuItems"] = toDynamic(contextMenuItems);
   }

package/ios/generated/ReactCodegen/EnrichedMarkdownTextSpec/Props.h

@@ -2579,6 +2579,7 @@ class EnrichedMarkdownProps final : public ViewProps {
   bool streamingAnimation{false};
   EnrichedMarkdownStreamingConfigStruct streamingConfig{};
   std::string spoilerOverlay{std::string{"particles"}};
+  bool contextMenuHidden{false};
   std::vector<EnrichedMarkdownContextMenuItemsStruct> contextMenuItems{};
   EnrichedMarkdownSelectionMenuConfigStruct selectionMenuConfig{};
   EnrichedMarkdownAccessibilityLabelsStruct accessibilityLabels{};
@@ -3361,6 +3362,7 @@ class EnrichedMarkdownTextInputProps final : public ViewProps {
   bool scrollEnabled{false};
   bool blockSyntax{false};
   std::string autoCapitalize{};
+  bool interceptPaste{false};
   bool multiline{false};
   SharedColor cursorColor{};
   SharedColor selectionColor{};
@@ -5948,6 +5950,7 @@ class EnrichedMarkdownTextProps final : public ViewProps {
   bool streamingAnimation{false};
   EnrichedMarkdownTextStreamingConfigStruct streamingConfig{};
   std::string spoilerOverlay{std::string{"particles"}};
+  bool contextMenuHidden{false};
   std::vector<EnrichedMarkdownTextContextMenuItemsStruct> contextMenuItems{};
   EnrichedMarkdownTextSelectionMenuConfigStruct selectionMenuConfig{};
   EnrichedMarkdownTextAccessibilityLabelsStruct accessibilityLabels{};

package/ios/generated/ReactCodegen/EnrichedMarkdownTextSpec/RCTComponentViewHelpers.h

@@ -36,6 +36,7 @@ NS_ASSUME_NONNULL_BEGIN
 - (void)updateMath:(NSInteger)start latex:(NSString *)latex displayMode:(BOOL)displayMode;
 - (void)removeMath:(NSInteger)start;
 - (void)copyToClipboard;
+- (void)resolvePaste:(NSString *)text markdown:(NSString *)markdown;
 - (void)requestMarkdown:(NSInteger)requestId;
 - (void)requestCaretRect:(NSInteger)requestId;
 @end
@@ -399,6 +400,34 @@ if ([commandName isEqualToString:@"copyToClipboard"]) {
   return;
 }
 
+if ([commandName isEqualToString:@"resolvePaste"]) {
+#if RCT_DEBUG
+  if ([args count] != 2) {
+    RCTLogError(@"%@ command %@ received %d arguments, expected %d.", @"EnrichedMarkdownTextInput", commandName, (int)[args count], 2);
+    return;
+  }
+#endif
+
+  NSObject *arg0 = args[0];
+#if RCT_DEBUG
+  if (!RCTValidateTypeOfViewCommandArgument(arg0, [NSString class], @"string", @"EnrichedMarkdownTextInput", commandName, @"1st")) {
+    return;
+  }
+#endif
+  NSString * text = (NSString *)arg0;
+
+NSObject *arg1 = args[1];
+#if RCT_DEBUG
+  if (!RCTValidateTypeOfViewCommandArgument(arg1, [NSString class], @"string", @"EnrichedMarkdownTextInput", commandName, @"2nd")) {
+    return;
+  }
+#endif
+  NSString * markdown = (NSString *)arg1;
+
+  [componentView resolvePaste:text markdown:markdown];
+  return;
+}
+
 if ([commandName isEqualToString:@"requestMarkdown"]) {
 #if RCT_DEBUG
   if ([args count] != 1) {

package/ios/input/ENRMInputTextView.mm

@@ -46,12 +46,22 @@ NSString *const kENRMMarkdownPasteboardType = @"com.swmansion.enriched-markdown.
     markdown = [[NSString alloc] initWithData:markdownValue encoding:NSUTF8StringEncoding];
   }
 
+  NSString *plainText = pasteboard.string;
+
+  // Both flavors are read before anything is decided, then nothing is written:
+  // JS owns the paste from here and must call resolvePaste. Mutating the buffer
+  // first would mean a handler that dies mid-flight leaves the selection gone
+  // with no text to show for it — a no-op paste is the visible failure.
+  if (self.markdownTextInput.interceptPaste && (plainText.length > 0 || markdown.length > 0)) {
+    [self.markdownTextInput emitOnPasteWithText:(plainText ?: @"") markdown:(markdown ?: @"")];
+    return;
+  }
+
   if (markdown.length > 0 && self.markdownTextInput != nil) {
     [self.markdownTextInput pasteMarkdown:markdown];
     return;
   }
 
-  NSString *plainText = pasteboard.string;
   if (plainText.length > 0) {
     [self replaceRange:self.selectedTextRange withText:plainText];
   }

package/ios/input/EnrichedMarkdownTextInput.h

@@ -8,12 +8,17 @@ NS_ASSUME_NONNULL_BEGIN
 
 @interface EnrichedMarkdownTextInput : RCTViewComponentView
 @property (nonatomic, assign) BOOL blockEmitting;
+@property (nonatomic, assign) BOOL interceptPaste;
 - (CGSize)measureSize:(CGFloat)maxWidth;
 - (nullable NSString *)markdownForSelectedRange;
 - (void)copyToClipboard;
 - (void)pasteMarkdown:(NSString *)markdown;
 - (void)replaceSelectedTextWith:(NSString *)text formattingRanges:(NSArray *)ranges;
 - (void)scheduleRelayoutIfNeeded;
+// Paste interception. Declared here rather than in +Internal.h because
+// ENRMInputTextView.mm only imports that header on macOS.
+- (void)emitOnPasteWithText:(NSString *)text markdown:(NSString *)markdown;
+- (void)resolvePaste:(NSString *)text markdown:(NSString *)markdown;
 @end
 
 NS_ASSUME_NONNULL_END

package/ios/input/EnrichedMarkdownTextInput.mm

@@ -359,6 +359,35 @@ using namespace facebook::react;
 
 #endif
 
+#pragma mark - Paste
+
+- (void)emitOnPasteWithText:(NSString *)text markdown:(NSString *)markdown
+{
+  auto emitter = [self getEventEmitter];
+  if (emitter == nullptr)
+    return;
+  emitter->onPaste({
+      .text = std::string([text UTF8String] ?: ""),
+      .markdown = std::string([markdown UTF8String] ?: ""),
+  });
+}
+
+/// The single exit for an intercepted paste. One command rather than two makes
+/// "never swallow a paste" structural: the branch that turns the clipboard into
+/// something else still has to come through here, with empty strings.
+- (void)resolvePaste:(NSString *)text markdown:(NSString *)markdown
+{
+  // Round-trips the formatting when the copy came from an input of ours;
+  // without this a copy-then-paste inside the app would land as flat text.
+  if (markdown.length > 0) {
+    [self pasteMarkdown:markdown];
+    return;
+  }
+  // Empty text with an empty selection is a zero-length edit: it still emits
+  // onChangeText with unchanged content, which the caller reads as a no-op.
+  [self replaceSelectedTextWith:text formattingRanges:@[]];
+}
+
 #pragma mark - State
 
 - (void)updateState:(const facebook::react::State::Shared &)state
@@ -456,6 +485,10 @@ using namespace facebook::react;
     }
   }
 
+  if (newViewProps.interceptPaste != oldViewProps.interceptPaste) {
+    _interceptPaste = newViewProps.interceptPaste;
+  }
+
   if (newViewProps.multiline != oldViewProps.multiline) {
     _textView.textContainer.maximumNumberOfLines = newViewProps.multiline ? 0 : 1;
     _textView.textContainer.lineBreakMode =

package/ios/views/ENRMMathContainerView.h

@@ -23,6 +23,10 @@ NS_ASSUME_NONNULL_BEGIN
 @property (nonatomic, copy, nullable, getter=menuCopyLabel) NSString *copyLabel;
 @property (nonatomic, copy, nullable, getter=menuCopyAsMarkdownLabel) NSString *copyAsMarkdownLabel;
 
+/// Suppresses the long-press copy menu on this block. Mirrors the
+/// `contextMenuHidden` prop; selection and link handling are unaffected.
+@property (nonatomic, assign) BOOL contextMenuHidden;
+
 @end
 
 NS_ASSUME_NONNULL_END

package/ios/views/ENRMMathContainerView.m

@@ -117,6 +117,11 @@
 - (UIContextMenuConfiguration *)contextMenuInteraction:(UIContextMenuInteraction *)interaction
                         configurationForMenuAtLocation:(CGPoint)location
 {
+  // Returning nil is the UIKit-sanctioned way to suppress a context menu.
+  if (self.contextMenuHidden) {
+    return nil;
+  }
+
   return [UIContextMenuConfiguration
       configurationWithIdentifier:nil
                   previewProvider:nil
@@ -141,6 +146,12 @@
 #if TARGET_OS_OSX
 - (NSMenu *)menuForEvent:(NSEvent *)event
 {
+  // This override never falls through to [super menuForEvent:], so nil fully
+  // suppresses the menu rather than restoring the AppKit default.
+  if (self.contextMenuHidden) {
+    return nil;
+  }
+
   NSMenu *menu = [[NSMenu alloc] initWithTitle:@""];
   [menu addItem:ENRMCreateMenuItem(self.copyLabel, ^{ [self copyLatexToPasteboard]; })];
   [menu addItem:ENRMCreateMenuItem(self.copyAsMarkdownLabel, ^{ [self copyMarkdownToPasteboard]; })];