@mathers101/react-native-render-rich-text 0.0.0-stage → 0.1.10

package/android/src/main/java/com/renderrichtext/events/ContextMenuItemPressEvent.kt

@@ -0,0 +1,28 @@
+package com.renderrichtext.events
+
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.WritableMap
+import com.facebook.react.uimanager.events.Event
+
+class ContextMenuItemPressEvent(
+  surfaceId: Int,
+  viewId: Int,
+  private val itemText: String,
+  private val selectedText: String,
+  private val selectionStart: Int,
+  private val selectionEnd: Int,
+) : Event<ContextMenuItemPressEvent>(surfaceId, viewId) {
+  override fun getEventName(): String = EVENT_NAME
+
+  override fun getEventData(): WritableMap =
+    Arguments.createMap().apply {
+      putString("itemText", itemText)
+      putString("selectedText", selectedText)
+      putInt("selectionStart", selectionStart)
+      putInt("selectionEnd", selectionEnd)
+    }
+
+  companion object {
+    const val EVENT_NAME = "onContextMenuItemPress"
+  }
+}

package/android/src/main/java/com/renderrichtext/events/CopyPressEvent.kt

@@ -0,0 +1,24 @@
+package com.renderrichtext.events
+
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.WritableMap
+import com.facebook.react.uimanager.events.Event
+
+class CopyPressEvent(
+  surfaceId: Int,
+  viewId: Int,
+  private val code: String,
+  private val language: String,
+) : Event<CopyPressEvent>(surfaceId, viewId) {
+  override fun getEventName(): String = EVENT_NAME
+
+  override fun getEventData(): WritableMap =
+    Arguments.createMap().apply {
+      putString("code", code)
+      putString("language", language)
+    }
+
+  companion object {
+    const val EVENT_NAME: String = "onCopyPress"
+  }
+}

package/android/src/main/java/com/renderrichtext/events/FactoidPressEvent.kt

@@ -0,0 +1,23 @@
+package com.renderrichtext.events
+
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.WritableMap
+import com.facebook.react.uimanager.events.Event
+
+class FactoidPressEvent(
+  surfaceId: Int,
+  viewId: Int,
+  private val factoidId: String,
+) : Event<FactoidPressEvent>(surfaceId, viewId) {
+  override fun getEventName(): String = EVENT_NAME
+
+  override fun getEventData(): WritableMap {
+    val eventData: WritableMap = Arguments.createMap()
+    eventData.putString("factoidId", factoidId)
+    return eventData
+  }
+
+  companion object {
+    const val EVENT_NAME: String = "onFactoidPress"
+  }
+}

package/android/src/main/java/com/renderrichtext/events/ImagePressEvent.kt

@@ -0,0 +1,25 @@
+package com.renderrichtext.events
+
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.WritableMap
+import com.facebook.react.uimanager.events.Event
+
+class ImagePressEvent(
+  surfaceId: Int,
+  viewId: Int,
+  private val url: String,
+  private val altText: String,
+) : Event<ImagePressEvent>(surfaceId, viewId) {
+  override fun getEventName(): String = EVENT_NAME
+
+  override fun getEventData(): WritableMap {
+    val eventData: WritableMap = Arguments.createMap()
+    eventData.putString("url", url)
+    eventData.putString("altText", altText)
+    return eventData
+  }
+
+  companion object {
+    const val EVENT_NAME: String = "onImagePress"
+  }
+}

package/android/src/main/java/com/renderrichtext/events/LatexErrorEvent.kt

@@ -0,0 +1,29 @@
+package com.renderrichtext.events
+
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.WritableMap
+import com.facebook.react.uimanager.events.Event
+
+class LatexErrorEvent(
+  surfaceId: Int,
+  viewId: Int,
+  private val source: String,
+  private val message: String?,
+  private val displayMode: Boolean,
+) : Event<LatexErrorEvent>(surfaceId, viewId) {
+  override fun getEventName(): String = EVENT_NAME
+
+  override fun canCoalesce(): Boolean = false
+
+  override fun getEventData(): WritableMap {
+    val eventData: WritableMap = Arguments.createMap()
+    eventData.putString("source", source)
+    eventData.putString("message", message)
+    eventData.putBoolean("displayMode", displayMode)
+    return eventData
+  }
+
+  companion object {
+    const val EVENT_NAME: String = "onLatexError"
+  }
+}

package/android/src/main/java/com/renderrichtext/events/LinkLongPressEvent.kt

@@ -0,0 +1,23 @@
+package com.renderrichtext.events
+
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.WritableMap
+import com.facebook.react.uimanager.events.Event
+
+class LinkLongPressEvent(
+  surfaceId: Int,
+  viewId: Int,
+  private val url: String,
+) : Event<LinkLongPressEvent>(surfaceId, viewId) {
+  override fun getEventName(): String = EVENT_NAME
+
+  override fun getEventData(): WritableMap {
+    val eventData: WritableMap = Arguments.createMap()
+    eventData.putString("url", url)
+    return eventData
+  }
+
+  companion object {
+    const val EVENT_NAME: String = "onLinkLongPress"
+  }
+}

package/android/src/main/java/com/renderrichtext/events/LinkPressEvent.kt

@@ -0,0 +1,23 @@
+package com.renderrichtext.events
+
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.WritableMap
+import com.facebook.react.uimanager.events.Event
+
+class LinkPressEvent(
+  surfaceId: Int,
+  viewId: Int,
+  private val url: String,
+) : Event<LinkPressEvent>(surfaceId, viewId) {
+  override fun getEventName(): String = EVENT_NAME
+
+  override fun getEventData(): WritableMap {
+    val eventData: WritableMap = Arguments.createMap()
+    eventData.putString("url", url)
+    return eventData
+  }
+
+  companion object {
+    const val EVENT_NAME: String = "onLinkPress"
+  }
+}

package/android/src/main/java/com/renderrichtext/events/MentionLongPressEvent.kt

@@ -0,0 +1,25 @@
+package com.renderrichtext.events
+
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.WritableMap
+import com.facebook.react.uimanager.events.Event
+
+class MentionLongPressEvent(
+  surfaceId: Int,
+  viewId: Int,
+  private val mentionId: String,
+  private val label: String,
+) : Event<MentionLongPressEvent>(surfaceId, viewId) {
+  override fun getEventName(): String = EVENT_NAME
+
+  override fun getEventData(): WritableMap {
+    val eventData: WritableMap = Arguments.createMap()
+    eventData.putString("mentionId", mentionId)
+    eventData.putString("label", label)
+    return eventData
+  }
+
+  companion object {
+    const val EVENT_NAME: String = "onMentionLongPress"
+  }
+}

package/android/src/main/java/com/renderrichtext/events/MentionPressEvent.kt

@@ -0,0 +1,25 @@
+package com.renderrichtext.events
+
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.WritableMap
+import com.facebook.react.uimanager.events.Event
+
+class MentionPressEvent(
+  surfaceId: Int,
+  viewId: Int,
+  private val mentionId: String,
+  private val label: String,
+) : Event<MentionPressEvent>(surfaceId, viewId) {
+  override fun getEventName(): String = EVENT_NAME
+
+  override fun getEventData(): WritableMap {
+    val eventData: WritableMap = Arguments.createMap()
+    eventData.putString("mentionId", mentionId)
+    eventData.putString("label", label)
+    return eventData
+  }
+
+  companion object {
+    const val EVENT_NAME: String = "onMentionPress"
+  }
+}

package/android/src/main/java/com/renderrichtext/events/TaskListItemPressEvent.kt

@@ -0,0 +1,26 @@
+package com.renderrichtext.events
+
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.WritableMap
+import com.facebook.react.uimanager.events.Event
+
+class TaskListItemPressEvent(
+  surfaceId: Int,
+  viewId: Int,
+  private val taskIndex: Int,
+  private val checked: Boolean,
+  private val itemText: String,
+) : Event<TaskListItemPressEvent>(surfaceId, viewId) {
+  override fun getEventName(): String = EVENT_NAME
+
+  override fun getEventData(): WritableMap =
+    Arguments.createMap().apply {
+      putInt("index", taskIndex)
+      putBoolean("checked", checked)
+      putString("text", itemText)
+    }
+
+  companion object {
+    const val EVENT_NAME: String = "onTaskListItemPress"
+  }
+}

package/android/src/main/java/com/renderrichtext/math/LatexErrorReporter.kt

@@ -0,0 +1,9 @@
+package com.renderrichtext.math
+
+fun interface LatexErrorReporter {
+  fun report(
+    source: String,
+    message: String,
+    displayMode: Boolean,
+  )
+}

package/android/src/main/java/com/renderrichtext/parser/Parser.kt

@@ -0,0 +1,59 @@
+package com.renderrichtext.parser
+
+import android.util.Log
+import com.renderrichtext.utils.common.LinkRegexConfig
+
+data class Md4cFlags(
+  val underline: Boolean = false,
+  val latexMath: Boolean = false,
+  val superscript: Boolean = false,
+  val subscript: Boolean = false,
+  val highlight: Boolean = false,
+  val permissiveAutolinks: Boolean = true,
+  val hardSoftBreaks: Boolean = false,
+  val preserveBlankLines: Boolean = false,
+  val admonitions: Boolean = false,
+) {
+  companion object {
+    val DEFAULT = Md4cFlags()
+  }
+}
+
+class Parser {
+  companion object {
+    init {
+      try {
+        System.loadLibrary("react_codegen_RichTextSpec")
+      } catch (e: UnsatisfiedLinkError) {
+        Log.e("TiptapParser", "Failed to load native library", e)
+      }
+    }
+
+    @JvmStatic
+    private external fun nativeParseDocument(document: String): TiptapASTNode?
+
+    val shared: Parser = Parser()
+  }
+
+  /**
+   * Parses a Tiptap document JSON string. Flag and regex arguments are kept so
+   * copied call sites compile; the Tiptap parser ignores them.
+   */
+  fun parseTiptap(
+    tiptap: String,
+    flags: Md4cFlags = Md4cFlags.DEFAULT,
+    isGFM: Boolean = true,
+    linkRegex: LinkRegexConfig? = null,
+    inlineCodeLinkRegex: LinkRegexConfig? = null,
+  ): TiptapASTNode? {
+    if (tiptap.isBlank()) {
+      return null
+    }
+    try {
+      return nativeParseDocument(tiptap)
+    } catch (e: Exception) {
+      Log.e("TiptapParser", "Tiptap parsing failed: ${e.message}", e)
+      return null
+    }
+  }
+}

package/android/src/main/java/com/renderrichtext/parser/TextLinkMatching.kt

@@ -0,0 +1,35 @@
+package com.renderrichtext.parser
+
+import com.renderrichtext.utils.common.LinkRegexConfig
+
+/** Host matchers the native parser calls back into; offsets are UTF-16 code units, as the core expects. */
+internal object TextLinkMatching {
+  /** Flat (run index, start, end) triples for every nonempty match, in order. */
+  @JvmStatic
+  fun matchText(
+    runs: Array<String>,
+    config: LinkRegexConfig,
+  ): IntArray {
+    val pattern = config.compiled ?: return IntArray(0)
+    val result = ArrayList<Int>()
+    runs.forEachIndexed { index, run ->
+      val matcher = pattern.matcher(run)
+      while (matcher.find()) {
+        if (matcher.end() == matcher.start()) continue
+        result.add(index)
+        result.add(matcher.start())
+        result.add(matcher.end())
+      }
+    }
+    return result.toIntArray()
+  }
+
+  @JvmStatic
+  fun matchWholeCode(
+    spans: Array<String>,
+    config: LinkRegexConfig,
+  ): BooleanArray {
+    val pattern = config.compiledWholeSpan ?: return BooleanArray(spans.size)
+    return BooleanArray(spans.size) { index -> pattern.matcher(spans[index]).find() }
+  }
+}

package/android/src/main/java/com/renderrichtext/parser/TiptapASTNode.kt

@@ -0,0 +1,69 @@
+package com.renderrichtext.parser
+
+data class TiptapASTNode(
+  val type: NodeType,
+  val content: String = "",
+  val attributes: Map<String, String> = emptyMap(),
+  val children: List<TiptapASTNode> = emptyList(),
+) {
+  enum class NodeType {
+    Document,
+    Paragraph,
+    Text,
+    Link,
+    Heading,
+    LineBreak,
+    Strong,
+    Emphasis,
+    Strikethrough,
+    Underline,
+    Code,
+    Image,
+    Blockquote,
+    UnorderedList,
+    OrderedList,
+    ListItem,
+    CodeBlock,
+    ThematicBreak,
+    Table,
+    TableHead,
+    TableBody,
+    TableRow,
+    TableHeaderCell,
+    TableCell,
+    LatexMathInline,
+    LatexMathDisplay,
+    Spoiler,
+    Superscript,
+    Subscript,
+    Highlight,
+    SoftBreak,
+    BlankLine,
+    Admonition,
+    Video,
+    Factoid,
+    Mention,
+  }
+
+  fun getAttribute(key: String): String? = attributes[key]
+}
+
+// A node type that md4c emits as a standalone block stacked vertically, as opposed to an inline span.
+internal fun TiptapASTNode.NodeType.isTopLevelBlock(): Boolean =
+  when (this) {
+    TiptapASTNode.NodeType.Paragraph,
+    TiptapASTNode.NodeType.Heading,
+    TiptapASTNode.NodeType.Blockquote,
+    TiptapASTNode.NodeType.Admonition,
+    TiptapASTNode.NodeType.UnorderedList,
+    TiptapASTNode.NodeType.OrderedList,
+    TiptapASTNode.NodeType.CodeBlock,
+    TiptapASTNode.NodeType.ThematicBreak,
+    TiptapASTNode.NodeType.BlankLine,
+    TiptapASTNode.NodeType.Table,
+    TiptapASTNode.NodeType.LatexMathDisplay,
+    TiptapASTNode.NodeType.Video,
+    -> true
+
+    else -> false
+  }

package/android/src/main/java/com/renderrichtext/renderer/BaselineShiftRenderer.kt

@@ -0,0 +1,45 @@
+package com.renderrichtext.renderer
+
+import android.text.SpannableStringBuilder
+import com.renderrichtext.parser.TiptapASTNode
+import com.renderrichtext.spans.BaselineShiftSpan
+
+abstract class BaselineShiftRenderer : NodeRenderer {
+  abstract fun fontScale(factory: RendererFactory): Float
+
+  abstract fun baselineOffsetScale(factory: RendererFactory): Float
+
+  abstract fun spanType(): BaselineShiftSpan.SpanType
+
+  override fun render(
+    node: TiptapASTNode,
+    builder: SpannableStringBuilder,
+    onLinkPress: ((String) -> Unit)?,
+    onLinkLongPress: ((String) -> Unit)?,
+    onFactoidPress: ((String) -> Unit)?,
+    factory: RendererFactory,
+  ) {
+    val start = builder.length
+    factory.renderChildren(node, builder, onLinkPress, onLinkLongPress, onFactoidPress)
+    val end = builder.length
+
+    if (end > start) {
+      // Block renderers (ListItemRenderer, BlockquoteRenderer, …) add their
+      // MetricAffectingSpan AFTER rendering children because they need the full range.
+      // Android applies spans in insertion order, so block spans that set tp.textSize
+      // absolutely always run last and override fontScale. Deferring this span ensures
+      // it is inserted after all block spans and wins.
+      //
+      // TODO: consider pre-registering each block span with an empty range before
+      // renderChildren(), then update the range in-place with a second setSpan() call.
+      // SpannableStringBuilder updates the range without moving the span in the array,
+      // so block spans stay first and inline spans naturally follow. Once done, remove
+      // the deferredSpans mechanism.
+      factory.registerDeferredSpan(
+        BaselineShiftSpan(fontScale(factory), baselineOffsetScale(factory), spanType()),
+        start,
+        end,
+      )
+    }
+  }
+}

package/android/src/main/java/com/renderrichtext/renderer/BlankLineRenderer.kt

@@ -0,0 +1,39 @@
+package com.renderrichtext.renderer
+
+import android.text.SpannableStringBuilder
+import com.renderrichtext.parser.TiptapASTNode
+import com.renderrichtext.utils.text.span.applyLineHeightSkippingImages
+
+// Renders a run of consecutive blank lines emitted when preserveBlankLines is
+// enabled. Each blank line in the source is drawn as one empty line, using the
+// paragraph line height so its vertical rhythm matches the surrounding
+// paragraphs. Any extra block spacing comes from the paragraph style and is left
+// to the caller to configure.
+class BlankLineRenderer(
+  private val config: RendererConfig,
+) : NodeRenderer {
+  override fun render(
+    node: TiptapASTNode,
+    builder: SpannableStringBuilder,
+    onLinkPress: ((String) -> Unit)?,
+    onLinkLongPress: ((String) -> Unit)?,
+    onFactoidPress: ((String) -> Unit)?,
+    factory: RendererFactory,
+  ) {
+    val count = node.getAttribute("count")?.toIntOrNull() ?: 0
+    if (count <= 0) {
+      return
+    }
+
+    builder.ensureNewline()
+    val start = builder.length
+    builder.append("\n".repeat(count))
+    applyLineHeightSkippingImages(builder, start, builder.length, config.style.paragraphStyle.lineHeight)
+  }
+
+  private fun SpannableStringBuilder.ensureNewline() {
+    if (isNotEmpty() && this[length - 1] != '\n') {
+      append('\n')
+    }
+  }
+}