@apollohg/react-native-prose-editor 0.5.1 → 0.5.3

package/README.md

@@ -5,8 +5,8 @@
 This project is currently in `alpha` and the API, behavior, and packaging may still change.
 
 <p align="center">
-  <img src="./docs/images/example-ios.png" alt="Example editor Android" width="45%" align="top" />
-  <img src="./docs/images/example-android.png" alt="Example editor iOS" width="45%" align="top" />
+  <img src="https://raw.githubusercontent.com/wiki/apollohg/react-native-prose-editor/images/example-ios.png" alt="Example editor iOS" width="45%" align="top" />
+  <img src="https://raw.githubusercontent.com/wiki/apollohg/react-native-prose-editor/images/example-android.png" alt="Example editor Android" width="45%" align="top" />
 </p>
 
 This repository contains three main pieces:
@@ -38,7 +38,8 @@ The editor already supports:
 - [`android`](./android): Android native view, rendering bridge, and Expo module wiring
 - [`Rust Editor Core`](./rust/editor-core): document model, transforms, schema system, selection, history, serialization, and tests
 - [`example`](./example): Expo 54 app for manual QA and development
-- [`docs`](./docs): project documentation
+
+Project documentation now lives in the [GitHub Wiki](https://github.com/apollohg/react-native-prose-editor/wiki).
 
 ## Installation
 
@@ -67,7 +68,7 @@ npm --prefix example install
 npm run example:prebuild
 ```
 
-For full setup details, including peer dependencies, example app setup, and iOS pods, see the [Installation Guide](./docs/guides/installation.md).
+For full setup details, including peer dependencies, example app setup, and iOS pods, see the [Installation Guide](https://github.com/apollohg/react-native-prose-editor/wiki/Installation).
 
 ## Basic Usage
 
@@ -106,9 +107,9 @@ The main extension points today are:
 - `addons`: configure optional features like @-mentions
 - `heightBehavior`: switch between internal scrolling and auto-grow
 
-For setup and customization details, start with the [Documentation Index](./docs/README.md).
+For setup and customization details, start with the [Documentation Index](https://github.com/apollohg/react-native-prose-editor/wiki).
 
-For realtime collaboration, including the correct `useYjsCollaboration()` wiring, encoded-state persistence, remote cursors, and automatic reconnect behavior, see the [Collaboration Guide](./docs/modules/collaboration.md).
+For realtime collaboration, including the correct `useYjsCollaboration()` wiring, encoded-state persistence, remote cursors, and automatic reconnect behavior, see the [Collaboration Guide](https://github.com/apollohg/react-native-prose-editor/wiki/Collaboration).
 
 For whole-document JSON loads, `initialJSON`, controlled `valueJSON`, and `setContentJson()` will normalize an empty root document like `{ type: 'doc', content: [] }` to the active schema's empty text block so block-constrained schemas still load a valid empty document.
 
@@ -152,15 +153,17 @@ npm run ios:test:perf:device
 
 ## Documentation
 
-- [Documentation Index](./docs/README.md): main documentation index
-- [Installation Guide](./docs/guides/installation.md): installation and local setup
-- [Getting Started](./docs/guides/getting-started.md): first setup and first editor
-- [Collaboration Guide](./docs/modules/collaboration.md): Yjs collaboration wiring, source-of-truth rules, and persistence
-- [Toolbar Setup](./docs/guides/toolbar-setup.md): toolbar setup patterns and examples
-- [Mentions Guide](./docs/modules/mentions.md): @-mentions addon setup and configuration
-- [Styling Guide](./docs/guides/styling.md): content, toolbar, and mention styling
-- [NativeRichTextEditor Reference](./docs/reference/native-rich-text-editor.md): component props and ref methods
-- [Design Decisions](./docs/explanations/design-decisions.md): rationale for key API and architecture decisions
+Documentation is published in the [GitHub Wiki](https://github.com/apollohg/react-native-prose-editor/wiki).
+
+- [Documentation Index](https://github.com/apollohg/react-native-prose-editor/wiki): main documentation index
+- [Installation Guide](https://github.com/apollohg/react-native-prose-editor/wiki/Installation): installation and local setup
+- [Getting Started](https://github.com/apollohg/react-native-prose-editor/wiki/Getting-Started): first setup and first editor
+- [Collaboration Guide](https://github.com/apollohg/react-native-prose-editor/wiki/Collaboration): Yjs collaboration wiring, source-of-truth rules, and persistence
+- [Toolbar Setup](https://github.com/apollohg/react-native-prose-editor/wiki/Toolbar-Setup): toolbar setup patterns and examples
+- [Mentions Guide](https://github.com/apollohg/react-native-prose-editor/wiki/Mentions): @-mentions addon setup and configuration
+- [Styling Guide](https://github.com/apollohg/react-native-prose-editor/wiki/Styling): content, toolbar, and mention styling
+- [NativeRichTextEditor Reference](https://github.com/apollohg/react-native-prose-editor/wiki/NativeRichTextEditor-Reference): component props and ref methods
+- [Design Decisions](https://github.com/apollohg/react-native-prose-editor/wiki/Design-Decisions): rationale for key API and architecture decisions
 
 ## Project Status
 

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

@@ -30,7 +30,8 @@ data class NativeMentionSuggestion(
 data class NativeMentionsAddonConfig(
     val trigger: String,
     val suggestions: List<NativeMentionSuggestion>,
-    val theme: EditorMentionTheme?
+    val theme: EditorMentionTheme?,
+    val resolveSelectionAttrs: Boolean
 ) {
     companion object {
         fun fromJson(json: JSONObject?): NativeMentionsAddonConfig? {
@@ -51,7 +52,8 @@ data class NativeMentionsAddonConfig(
             return NativeMentionsAddonConfig(
                 trigger = trigger,
                 suggestions = suggestions,
-                theme = EditorMentionTheme.fromJson(json.optJSONObject("theme"))
+                theme = EditorMentionTheme.fromJson(json.optJSONObject("theme")),
+                resolveSelectionAttrs = json.optBoolean("resolveSelectionAttrs", false)
             )
         }
     }

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

@@ -77,6 +77,11 @@ class EditorEditText @JvmOverloads constructor(
         val label: String
     )
 
+    data class LinkHit(
+        val href: String,
+        val text: String
+    )
+
     private data class ParsedRenderPatch(
         val startIndex: Int,
         val deleteCount: Int,
@@ -1583,7 +1588,7 @@ class EditorEditText @JvmOverloads constructor(
         }
     }
 
-    fun mentionHitAt(x: Float, y: Float): MentionHit? {
+    private fun textOffsetHitAt(x: Float, y: Float): Pair<Spanned, Int>? {
         val spannable = text as? Spanned ?: return null
         val layout = layout ?: return null
         if (spannable.isEmpty()) return null
@@ -1603,6 +1608,11 @@ class EditorEditText @JvmOverloads constructor(
 
         val offset = layout.getOffsetForHorizontal(line, localX)
             .coerceIn(0, maxOf(spannable.length - 1, 0))
+        return spannable to offset
+    }
+
+    fun mentionHitAt(x: Float, y: Float): MentionHit? {
+        val (spannable, offset) = textOffsetHitAt(x, y) ?: return null
         val annotations = spannable.getSpans(
             offset,
             (offset + 1).coerceAtMost(spannable.length),
@@ -1626,6 +1636,28 @@ class EditorEditText @JvmOverloads constructor(
         )
     }
 
+    fun linkHitAt(x: Float, y: Float): LinkHit? {
+        val (spannable, offset) = textOffsetHitAt(x, y) ?: return null
+        val annotations = spannable.getSpans(
+            offset,
+            (offset + 1).coerceAtMost(spannable.length),
+            Annotation::class.java
+        )
+        val linkAnnotation = annotations.firstOrNull {
+            it.key == RenderBridge.NATIVE_LINK_HREF_ANNOTATION && it.value.isNotBlank()
+        } ?: return null
+        val start = spannable.getSpanStart(linkAnnotation)
+        val end = spannable.getSpanEnd(linkAnnotation)
+        if (start < 0 || end <= start) {
+            return null
+        }
+
+        return LinkHit(
+            href = linkAnnotation.value,
+            text = spannable.subSequence(start, end).toString()
+        )
+    }
+
     private fun handleImageTap(event: MotionEvent): Boolean {
         if (!imageResizingEnabled) {
             return false

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

@@ -127,6 +127,29 @@ data class EditorMentionTheme(
     val optionHighlightedBackgroundColor: Int? = null,
     val optionHighlightedTextColor: Int? = null
 ) {
+    fun mergedWith(other: EditorMentionTheme?): EditorMentionTheme {
+        other ?: return this
+        return copy(
+            textColor = other.textColor ?: textColor,
+            backgroundColor = other.backgroundColor ?: backgroundColor,
+            borderColor = other.borderColor ?: borderColor,
+            borderWidth = other.borderWidth ?: borderWidth,
+            borderRadius = other.borderRadius ?: borderRadius,
+            fontWeight = other.fontWeight ?: fontWeight,
+            popoverBackgroundColor = other.popoverBackgroundColor ?: popoverBackgroundColor,
+            popoverBorderColor = other.popoverBorderColor ?: popoverBorderColor,
+            popoverBorderWidth = other.popoverBorderWidth ?: popoverBorderWidth,
+            popoverBorderRadius = other.popoverBorderRadius ?: popoverBorderRadius,
+            popoverShadowColor = other.popoverShadowColor ?: popoverShadowColor,
+            optionTextColor = other.optionTextColor ?: optionTextColor,
+            optionSecondaryTextColor = other.optionSecondaryTextColor ?: optionSecondaryTextColor,
+            optionHighlightedBackgroundColor =
+                other.optionHighlightedBackgroundColor ?: optionHighlightedBackgroundColor,
+            optionHighlightedTextColor =
+                other.optionHighlightedTextColor ?: optionHighlightedTextColor
+        )
+    }
+
     companion object {
         fun fromJson(json: JSONObject?): EditorMentionTheme? {
             json ?: return null

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

@@ -529,12 +529,42 @@ class NativeEditorExpoView(
         onAddonEvent(mapOf("eventJson" to eventJson))
     }
 
-    private fun emitMentionSelect(trigger: String, suggestion: NativeMentionSuggestion) {
+    private fun resolvedMentionAttrs(
+        trigger: String,
+        suggestion: NativeMentionSuggestion
+    ): JSONObject {
+        val attrs = JSONObject(suggestion.attrs.toString())
+        if (!attrs.has("label")) {
+            attrs.put("label", suggestion.label)
+        }
+        if (!attrs.has("mentionSuggestionChar")) {
+            attrs.put("mentionSuggestionChar", trigger)
+        }
+        return attrs
+    }
+
+    private fun emitMentionSelect(trigger: String, suggestion: NativeMentionSuggestion, attrs: JSONObject) {
         val eventJson = JSONObject()
             .put("type", "mentionsSelect")
             .put("trigger", trigger)
             .put("suggestionKey", suggestion.key)
-            .put("attrs", suggestion.attrs)
+            .put("attrs", attrs)
+            .toString()
+        onAddonEvent(mapOf("eventJson" to eventJson))
+    }
+
+    private fun emitMentionSelectRequest(
+        trigger: String,
+        suggestion: NativeMentionSuggestion,
+        attrs: JSONObject,
+        range: MentionQueryState
+    ) {
+        val eventJson = JSONObject()
+            .put("type", "mentionsSelectRequest")
+            .put("trigger", trigger)
+            .put("suggestionKey", suggestion.key)
+            .put("attrs", attrs)
+            .put("range", JSONObject().put("anchor", range.anchor).put("head", range.head))
             .toString()
         onAddonEvent(mapOf("eventJson" to eventJson))
     }
@@ -542,9 +572,12 @@ class NativeEditorExpoView(
     private fun insertMentionSuggestion(suggestion: NativeMentionSuggestion) {
         val mentions = addons.mentions ?: return
         val queryState = mentionQueryState ?: return
-        val attrs = JSONObject(suggestion.attrs.toString())
-        if (!attrs.has("label")) {
-            attrs.put("label", suggestion.label)
+        val attrs = resolvedMentionAttrs(mentions.trigger, suggestion)
+        if (mentions.resolveSelectionAttrs) {
+            emitMentionSelectRequest(mentions.trigger, suggestion, attrs, queryState)
+            lastMentionEventJson = null
+            clearMentionQueryState()
+            return
         }
         val docJson = JSONObject()
             .put("type", "doc")
@@ -564,7 +597,7 @@ class NativeEditorExpoView(
             docJson.toString()
         )
         richTextView.editorEditText.applyUpdateJSON(updateJson)
-        emitMentionSelect(mentions.trigger, suggestion)
+        emitMentionSelect(mentions.trigger, suggestion, attrs)
         lastMentionEventJson = null
         clearMentionQueryState()
     }

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

@@ -295,6 +295,14 @@ class NativeEditorModule : Module() {
                 editorDestroy(editorId)
             }
         }
+        Function("renderDocumentHtml") { configJson: String, html: String ->
+            val editorId = editorCreate(configJson)
+            try {
+                editorSetHtml(editorId, html)
+            } finally {
+                editorDestroy(editorId)
+            }
+        }
 
         View(NativeEditorExpoView::class) {
             Events(
@@ -370,7 +378,7 @@ class NativeEditorModule : Module() {
 
         View(NativeProseViewerExpoView::class) {
             Name("NativeProseViewer")
-            Events("onContentHeightChange", "onPressMention")
+            Events("onContentHeightChange", "onPressLink", "onPressMention")
 
             Prop("renderJson") { view: NativeProseViewerExpoView, renderJson: String? ->
                 view.setRenderJson(renderJson)
@@ -378,6 +386,12 @@ class NativeEditorModule : Module() {
             Prop("themeJson") { view: NativeProseViewerExpoView, themeJson: String? ->
                 view.setThemeJson(themeJson)
             }
+            Prop("enableLinkTaps") { view: NativeProseViewerExpoView, enableLinkTaps: Boolean? ->
+                view.setEnableLinkTaps(enableLinkTaps)
+            }
+            Prop("interceptLinkTaps") { view: NativeProseViewerExpoView, interceptLinkTaps: Boolean? ->
+                view.setInterceptLinkTaps(interceptLinkTaps)
+            }
         }
     }
 }

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

@@ -1,7 +1,9 @@
 package com.apollohg.editor
 
+import android.content.Intent
 import android.content.Context
 import android.graphics.Color
+import android.net.Uri
 import android.view.MotionEvent
 import android.view.View
 import android.view.ViewGroup
@@ -17,11 +19,15 @@ class NativeProseViewerExpoView(
     private val proseView = EditorEditText(context)
     private val onContentHeightChange by EventDispatcher<Map<String, Any>>()
     @Suppress("unused")
+    private val onPressLink by EventDispatcher<Map<String, Any>>()
+    @Suppress("unused")
     private val onPressMention by EventDispatcher<Map<String, Any>>()
 
     private var lastRenderJson: String? = null
     private var lastThemeJson: String? = null
     private var lastEmittedContentHeight = 0
+    private var enableLinkTaps = true
+    private var interceptLinkTaps = false
 
     init {
         proseView.setBaseStyle(
@@ -43,14 +49,27 @@ class NativeProseViewerExpoView(
                 return@setOnTouchListener false
             }
 
-            val mention = proseView.mentionHitAt(event.x, event.y) ?: return@setOnTouchListener false
-            onPressMention(
-                mapOf(
-                    "docPos" to mention.docPos,
-                    "label" to mention.label
+            proseView.mentionHitAt(event.x, event.y)?.let { mention ->
+                onPressMention(mapOf("docPos" to mention.docPos, "label" to mention.label))
+                return@setOnTouchListener true
+            }
+
+            if (!enableLinkTaps) {
+                return@setOnTouchListener false
+            }
+
+            val link = proseView.linkHitAt(event.x, event.y) ?: return@setOnTouchListener false
+            if (interceptLinkTaps) {
+                onPressLink(
+                    mapOf(
+                        "href" to link.href,
+                        "text" to link.text
+                    )
                 )
-            )
-            true
+                return@setOnTouchListener true
+            }
+
+            return@setOnTouchListener openLink(link.href)
         }
 
         addView(
@@ -83,6 +102,14 @@ class NativeProseViewerExpoView(
         }
     }
 
+    fun setEnableLinkTaps(enableLinkTaps: Boolean?) {
+        this.enableLinkTaps = enableLinkTaps ?: true
+    }
+
+    fun setInterceptLinkTaps(interceptLinkTaps: Boolean?) {
+        this.interceptLinkTaps = interceptLinkTaps ?: false
+    }
+
     override fun onMeasure(widthMeasureSpec: Int, heightMeasureSpec: Int) {
         val childWidthSpec = getChildMeasureSpec(
             widthMeasureSpec,
@@ -154,4 +181,14 @@ class NativeProseViewerExpoView(
 
         return (resources.displayMetrics.widthPixels - paddingLeft - paddingRight).coerceAtLeast(1)
     }
+
+    private fun openLink(href: String): Boolean {
+        val intent = Intent(Intent.ACTION_VIEW, Uri.parse(href)).apply {
+            addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
+        }
+        return runCatching {
+            context.startActivity(intent)
+            true
+        }.getOrDefault(false)
+    }
 }

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

@@ -752,6 +752,7 @@ class CenteredBulletSpan(
 object RenderBridge {
     internal const val NATIVE_BLOCKQUOTE_ANNOTATION = "nativeBlockquote"
     internal const val NATIVE_TOP_LEVEL_CHILD_INDEX_ANNOTATION = "nativeTopLevelChildIndex"
+    internal const val NATIVE_LINK_HREF_ANNOTATION = "nativeLinkHref"
     private const val NATIVE_SYNTHETIC_PLACEHOLDER_ANNOTATION = "nativeSyntheticPlaceholder"
 
     private data class RenderBuildState(
@@ -909,6 +910,9 @@ object RenderBridge {
                     val nodeType = element.optString("nodeType", "")
                     val label = element.optString("label", "?")
                     val docPos = element.optInt("docPos", 0)
+                    val mentionTheme = EditorMentionTheme.fromJson(
+                        element.optJSONObject("mentionTheme")
+                    )
                     appendOpaqueInlineAtom(
                         state.result,
                         nodeType,
@@ -919,6 +923,7 @@ object RenderBridge {
                         state.blockStack,
                         state.pendingLeadingMargins,
                         theme,
+                        mentionTheme,
                         density
                     )
                 }
@@ -1170,6 +1175,15 @@ object RenderBridge {
                             end,
                             Spanned.SPAN_EXCLUSIVE_EXCLUSIVE
                         )
+                        val href = mark.optString("href", "")
+                        if (href.isNotBlank()) {
+                            builder.setSpan(
+                                Annotation(NATIVE_LINK_HREF_ANNOTATION, href),
+                                start,
+                                end,
+                                Spanned.SPAN_EXCLUSIVE_EXCLUSIVE
+                            )
+                        }
                     }
                 }
             }
@@ -1353,6 +1367,7 @@ object RenderBridge {
         blockStack: MutableList<BlockContext>,
         pendingLeadingMargins: MutableMap<Int, PendingLeadingMargin>,
         theme: EditorTheme?,
+        mentionTheme: EditorMentionTheme?,
         density: Float
     ) {
         val isMention = nodeType == "mention"
@@ -1360,8 +1375,13 @@ object RenderBridge {
         val start = builder.length
         builder.append(text)
         val end = builder.length
+        val resolvedMentionTheme = if (isMention) {
+            theme?.mentions?.mergedWith(mentionTheme) ?: mentionTheme
+        } else {
+            null
+        }
         val inlineTextColor = if (isMention) {
-            theme?.mentions?.textColor ?: resolveInlineTextColor(blockStack, textColor, theme)
+            resolvedMentionTheme?.textColor ?: resolveInlineTextColor(blockStack, textColor, theme)
         } else {
             resolveInlineTextColor(blockStack, textColor, theme)
         }
@@ -1372,7 +1392,7 @@ object RenderBridge {
         builder.setSpan(
             BackgroundColorSpan(
                 if (isMention) {
-                    theme?.mentions?.backgroundColor ?: 0x1f1d4ed8
+                    resolvedMentionTheme?.backgroundColor ?: 0x1f1d4ed8
                 } else {
                     0x20000000
                 }
@@ -1387,8 +1407,8 @@ object RenderBridge {
             Annotation("nativeDocPos", docPos.toString()),
             start, end, Spanned.SPAN_EXCLUSIVE_EXCLUSIVE
         )
-        if (isMention && (theme?.mentions?.fontWeight == "bold" ||
-                theme?.mentions?.fontWeight?.toIntOrNull()?.let { it >= 600 } == true)
+        if (isMention && (resolvedMentionTheme?.fontWeight == "bold" ||
+                resolvedMentionTheme?.fontWeight?.toIntOrNull()?.let { it >= 600 } == true)
         ) {
             builder.setSpan(
                 StyleSpan(Typeface.BOLD),

package/dist/NativeEditorBridge.d.ts

@@ -1,3 +1,4 @@
+import type { EditorMentionTheme } from './EditorTheme';
 import { type SchemaDefinition } from './schemas';
 export interface NativeEditorModule {
     editorCreate(configJson: string): number;
@@ -93,6 +94,7 @@ export interface RenderElement {
     docPos?: number;
     label?: string;
     attrs?: Record<string, unknown>;
+    mentionTheme?: EditorMentionTheme;
     listContext?: ListContext;
 }
 interface RenderBlocksPatch {
@@ -194,6 +196,8 @@ export declare class NativeEditorBridge {
     toggleMark(markType: string): EditorUpdate | null;
     /** Set a mark with attrs on the current selection. */
     setMark(markType: string, attrs: Record<string, unknown>): EditorUpdate | null;
+    /** Set a mark with attrs at an explicit scalar selection. */
+    setMarkAtSelectionScalar(scalarAnchor: number, scalarHead: number, markType: string, attrs: Record<string, unknown>): EditorUpdate | null;
     /** Remove a mark from the current selection. */
     unsetMark(markType: string): EditorUpdate | null;
     /** Toggle blockquote wrapping for the current block selection. */
@@ -202,6 +206,10 @@ export declare class NativeEditorBridge {
     toggleHeading(level: number): EditorUpdate | null;
     /** Set the document selection by anchor and head positions. */
     setSelection(anchor: number, head: number): void;
+    /** Convert a document position to a scalar position used by native text views. */
+    docToScalar(docPos: number): number;
+    /** Convert a native scalar position back to a document position. */
+    scalarToDoc(scalar: number): number;
     /** Get the current selection from the Rust engine (synchronous native call).
      *  Always returns the live selection, not a stale cache. */
     getSelection(): Selection;

package/dist/NativeEditorBridge.js

@@ -433,6 +433,12 @@ class NativeEditorBridge {
             : getNativeModule().editorSetMark(this._editorId, markType, attrsJson);
         return this.parseAndNoteUpdate(json);
     }
+    /** Set a mark with attrs at an explicit scalar selection. */
+    setMarkAtSelectionScalar(scalarAnchor, scalarHead, markType, attrs) {
+        this.assertNotDestroyed();
+        const json = getNativeModule().editorSetMarkAtSelectionScalar(this._editorId, scalarAnchor, scalarHead, markType, JSON.stringify(attrs));
+        return this.parseAndNoteUpdate(json);
+    }
     /** Remove a mark from the current selection. */
     unsetMark(markType) {
         this.assertNotDestroyed();
@@ -469,6 +475,16 @@ class NativeEditorBridge {
         getNativeModule().editorSetSelection(this._editorId, anchor, head);
         this._lastSelection = { type: 'text', anchor, head };
     }
+    /** Convert a document position to a scalar position used by native text views. */
+    docToScalar(docPos) {
+        this.assertNotDestroyed();
+        return getNativeModule().editorDocToScalar(this._editorId, docPos);
+    }
+    /** Convert a native scalar position back to a document position. */
+    scalarToDoc(scalar) {
+        this.assertNotDestroyed();
+        return getNativeModule().editorScalarToDoc(this._editorId, scalar);
+    }
     /** Get the current selection from the Rust engine (synchronous native call).
      *  Always returns the live selection, not a stale cache. */
     getSelection() {

package/dist/NativeProseViewer.d.ts

@@ -1,21 +1,41 @@
 import { type StyleProp, type ViewStyle } from 'react-native';
-import { type EditorTheme } from './EditorTheme';
+import { type EditorMentionTheme, type EditorTheme } from './EditorTheme';
 import type { DocumentJSON } from './NativeEditorBridge';
 import { type SchemaDefinition } from './schemas';
-export interface NativeProseViewerMentionPressEvent {
+export interface NativeProseViewerMentionRenderContext {
     docPos: number;
     label: string;
     attrs: Record<string, unknown>;
 }
+export interface NativeProseViewerMentionPressEvent extends NativeProseViewerMentionRenderContext {
+}
+export interface NativeProseViewerLinkPressEvent {
+    href: string;
+    text: string;
+}
 type NativeProseViewerContent = DocumentJSON | string;
-export interface NativeProseViewerProps {
-    contentJSON: NativeProseViewerContent;
+interface NativeProseViewerBaseProps {
+    contentRevision?: string | number;
     contentJSONRevision?: string | number;
     schema?: SchemaDefinition;
     theme?: EditorTheme;
     style?: StyleProp<ViewStyle>;
     allowBase64Images?: boolean;
+    collapseTrailingEmptyParagraphs?: boolean;
+    enableLinkTaps?: boolean;
+    mentionPrefix?: string | ((mention: NativeProseViewerMentionRenderContext) => string | null | undefined);
+    resolveMentionTheme?: (mention: NativeProseViewerMentionRenderContext) => EditorMentionTheme | null | undefined;
+    onPressLink?: (event: NativeProseViewerLinkPressEvent) => void;
     onPressMention?: (event: NativeProseViewerMentionPressEvent) => void;
 }
-export declare function NativeProseViewer({ contentJSON, contentJSONRevision, schema, theme, style, allowBase64Images, onPressMention, }: NativeProseViewerProps): import("react/jsx-runtime").JSX.Element;
+interface NativeProseViewerJsonProps extends NativeProseViewerBaseProps {
+    contentJSON: NativeProseViewerContent;
+    contentHTML?: never;
+}
+interface NativeProseViewerHtmlProps extends NativeProseViewerBaseProps {
+    contentHTML: string;
+    contentJSON?: never;
+}
+export type NativeProseViewerProps = NativeProseViewerJsonProps | NativeProseViewerHtmlProps;
+export declare function NativeProseViewer({ ...props }: NativeProseViewerProps): import("react/jsx-runtime").JSX.Element;
 export {};