react-native-enriched-markdown-scaffold 0.6.0-scaffold.4

package/android/src/main/java/com/swmansion/enriched/markdown/utils/text/conversion/MarkdownExtractor.kt

@@ -0,0 +1,419 @@
+package com.swmansion.enriched.markdown.utils.text.conversion
+
+import android.text.Spannable
+import android.text.style.UnderlineSpan
+import android.widget.TextView
+import com.swmansion.enriched.markdown.EnrichedMarkdownText
+import com.swmansion.enriched.markdown.spans.BaselineShiftSpan
+import com.swmansion.enriched.markdown.spans.BlockquoteSpan
+import com.swmansion.enriched.markdown.spans.CodeBlockSpan
+import com.swmansion.enriched.markdown.spans.CodeSpan
+import com.swmansion.enriched.markdown.spans.EmphasisSpan
+import com.swmansion.enriched.markdown.spans.HeadingSpan
+import com.swmansion.enriched.markdown.spans.HighlightSpan
+import com.swmansion.enriched.markdown.spans.ImageSpan
+import com.swmansion.enriched.markdown.spans.LinkSpan
+import com.swmansion.enriched.markdown.spans.OrderedListSpan
+import com.swmansion.enriched.markdown.spans.StrikethroughSpan
+import com.swmansion.enriched.markdown.spans.StrongSpan
+import com.swmansion.enriched.markdown.spans.TaskListSpan
+import com.swmansion.enriched.markdown.spans.ThematicBreakSpan
+import com.swmansion.enriched.markdown.spans.UnorderedListSpan
+
+/** Extracts markdown from styled text (Spannable). */
+object MarkdownExtractor {
+  /**
+   * Gets markdown for the current text selection.
+   * Full selection returns original markdown, partial reconstructs from spans.
+   */
+  fun getMarkdownForSelection(textView: TextView): String? {
+    val start = textView.selectionStart
+    val end = textView.selectionEnd
+    if (start < 0 || end < 0 || start >= end) return null
+
+    val spannable = textView.text as? Spannable ?: return null
+
+    val isFullSelection = start == 0 && end >= textView.text.length - 1
+    if (isFullSelection && textView is EnrichedMarkdownText) {
+      val original = textView.currentMarkdown
+      if (original.isNotEmpty()) return original
+    }
+
+    return extractFromSpannable(spannable, start, end)
+  }
+
+  /** Extracts markdown from a Spannable within a given range. */
+  fun extractFromSpannable(
+    spannable: Spannable,
+    start: Int,
+    end: Int,
+  ): String {
+    val result = StringBuilder()
+    val state = ExtractionState()
+    val headingAccumulator = HeadingAccumulator()
+
+    var i = start
+    while (i < end) {
+      val nextTransition = spannable.nextSpanTransition(i, end, Any::class.java)
+      val segmentText = spannable.subSequence(i, nextTransition).toString()
+
+      val handled =
+        processSegment(
+          spannable = spannable,
+          segmentText = segmentText,
+          segmentStart = i,
+          segmentEnd = nextTransition,
+          result = result,
+          state = state,
+          headingAccumulator = headingAccumulator,
+        )
+
+      if (!handled) {
+        // Regular text segment - apply inline formatting and block prefixes
+        appendFormattedSegment(spannable, segmentText, i, nextTransition, result, state)
+      }
+
+      i = nextTransition
+    }
+
+    headingAccumulator.flush(result, state)
+    return result.toString()
+  }
+
+  /** Returns true if segment was handled specially. */
+  private fun processSegment(
+    spannable: Spannable,
+    segmentText: String,
+    segmentStart: Int,
+    segmentEnd: Int,
+    result: StringBuilder,
+    state: ExtractionState,
+    headingAccumulator: HeadingAccumulator,
+  ): Boolean {
+    // Check for thematic breaks first (uses " \n" as placeholder)
+    val thematicBreakSpans = spannable.getSpans(segmentStart, segmentEnd, ThematicBreakSpan::class.java)
+    if (thematicBreakSpans.isNotEmpty()) {
+      appendThematicBreak(result, state)
+      return true
+    }
+
+    if (segmentText == "\uFFFC" || segmentText == "\u200B") {
+      val imageSpans = spannable.getSpans(segmentStart, segmentEnd, ImageSpan::class.java)
+      if (imageSpans.isNotEmpty()) {
+        appendImage(imageSpans[0], result, state)
+        return true
+      }
+
+      val mathLatex = extractMathLatex(spannable, segmentStart, segmentEnd)
+      if (mathLatex != null) {
+        result.append("$$mathLatex$")
+        return true
+      }
+    }
+
+    if (segmentText.isEmpty()) return true
+
+    if (segmentText == "\n" || segmentText == "\n\n") {
+      handleNewline(spannable, segmentStart, segmentEnd, result, state)
+      return true
+    }
+
+    val headingSpans = spannable.getSpans(segmentStart, segmentEnd, HeadingSpan::class.java)
+    if (headingSpans.isNotEmpty()) {
+      headingAccumulator.accumulate(headingSpans[0].level, segmentText, result, state)
+      return true
+    } else {
+      headingAccumulator.flush(result, state)
+    }
+
+    val codeBlockSpans = spannable.getSpans(segmentStart, segmentEnd, CodeBlockSpan::class.java)
+    if (codeBlockSpans.isNotEmpty()) {
+      appendCodeBlock(segmentText, result, state)
+      return true
+    }
+
+    return false
+  }
+
+  private fun appendFormattedSegment(
+    spannable: Spannable,
+    segmentText: String,
+    segmentStart: Int,
+    segmentEnd: Int,
+    result: StringBuilder,
+    state: ExtractionState,
+  ) {
+    val blockquotePrefix = detectBlockquote(spannable, segmentStart, segmentEnd, state)
+    val listPrefix = detectList(spannable, segmentStart, segmentEnd, state)
+    var segment = applyInlineFormatting(spannable, segmentText, segmentStart, segmentEnd)
+
+    if (result.isAtLineStart() && !segmentText.startsWith("\n")) {
+      segment = buildBlockPrefix(blockquotePrefix, listPrefix) + segment
+    }
+
+    if (state.needsBlankLine && result.isNotEmpty()) {
+      result.ensureBlankLine()
+      state.needsBlankLine = false
+    }
+
+    result.append(segment)
+  }
+
+  private fun appendImage(
+    img: ImageSpan,
+    result: StringBuilder,
+    state: ExtractionState,
+  ) {
+    if (img.isInline) {
+      result.append("![image](${img.imageUrl})")
+    } else {
+      result.ensureBlankLine()
+      result.append("![image](${img.imageUrl})\n")
+      state.needsBlankLine = true
+      state.blockquoteDepth = -1
+      state.listDepth = -1
+    }
+  }
+
+  private fun appendThematicBreak(
+    result: StringBuilder,
+    state: ExtractionState,
+  ) {
+    result.ensureBlankLine()
+    result.append("---\n")
+    state.needsBlankLine = true
+    state.blockquoteDepth = -1
+    state.listDepth = -1
+  }
+
+  private fun handleNewline(
+    spannable: Spannable,
+    start: Int,
+    end: Int,
+    result: StringBuilder,
+    state: ExtractionState,
+  ) {
+    val inBlockquote = spannable.getSpans(start, end, BlockquoteSpan::class.java).isNotEmpty()
+    val inList =
+      spannable.getSpans(start, end, OrderedListSpan::class.java).isNotEmpty() ||
+        spannable.getSpans(start, end, UnorderedListSpan::class.java).isNotEmpty() ||
+        spannable.getSpans(start, end, TaskListSpan::class.java).isNotEmpty()
+
+    when {
+      !inBlockquote && state.blockquoteDepth >= 0 -> {
+        result.ensureBlankLine()
+        state.blockquoteDepth = -1
+      }
+
+      !inList && state.listDepth >= 0 -> {
+        result.ensureBlankLine()
+        state.listDepth = -1
+      }
+
+      inBlockquote || inList -> {
+        if (!result.endsWith("\n")) result.append("\n")
+      }
+
+      else -> {
+        result.ensureBlankLine()
+      }
+    }
+  }
+
+  private fun appendCodeBlock(
+    text: String,
+    result: StringBuilder,
+    state: ExtractionState,
+  ) {
+    if (state.needsBlankLine) {
+      result.ensureBlankLine()
+      state.needsBlankLine = false
+    }
+
+    val needsFence = result.isEmpty() || result.endsWith("\n\n")
+    if (needsFence) result.append("```\n")
+
+    result.append(text)
+
+    if (text.endsWith("\n")) {
+      result.append("```\n")
+      state.needsBlankLine = true
+    }
+  }
+
+  private fun detectBlockquote(
+    spannable: Spannable,
+    start: Int,
+    end: Int,
+    state: ExtractionState,
+  ): String? {
+    val spans = spannable.getSpans(start, end, BlockquoteSpan::class.java)
+    val depth = spans.maxOfOrNull { it.depth } ?: -1
+
+    return if (depth >= 0) {
+      state.blockquoteDepth = depth
+      "> ".repeat(depth + 1)
+    } else {
+      if (state.blockquoteDepth >= 0) state.blockquoteDepth = -1
+      null
+    }
+  }
+
+  private fun detectList(
+    spannable: Spannable,
+    start: Int,
+    end: Int,
+    state: ExtractionState,
+  ): String? {
+    val orderedSpans = spannable.getSpans(start, end, OrderedListSpan::class.java)
+    val unorderedSpans = spannable.getSpans(start, end, UnorderedListSpan::class.java)
+    val taskSpans = spannable.getSpans(start, end, TaskListSpan::class.java)
+
+    val orderedDepth = orderedSpans.maxOfOrNull { it.depth } ?: -1
+    val unorderedDepth = unorderedSpans.maxOfOrNull { it.depth } ?: -1
+    val taskDepth = taskSpans.maxOfOrNull { it.depth } ?: -1
+    val depth = maxOf(orderedDepth, unorderedDepth, taskDepth)
+
+    return if (depth >= 0) {
+      state.listDepth = depth
+      val indent = "  ".repeat(depth)
+      if (taskSpans.isNotEmpty()) {
+        val checkbox = if (taskSpans[0].isChecked) "[x]" else "[ ]"
+        "$indent- $checkbox "
+      } else if (orderedSpans.isNotEmpty()) {
+        "$indent${orderedSpans[0].itemNumber}. "
+      } else {
+        "$indent- "
+      }
+    } else {
+      if (state.listDepth >= 0) state.listDepth = -1
+      null
+    }
+  }
+
+  private fun applyInlineFormatting(
+    spannable: Spannable,
+    text: String,
+    start: Int,
+    end: Int,
+  ): String {
+    val hasStrong = spannable.getSpans(start, end, StrongSpan::class.java).isNotEmpty()
+    val hasEmphasis = spannable.getSpans(start, end, EmphasisSpan::class.java).isNotEmpty()
+    val hasCode = spannable.getSpans(start, end, CodeSpan::class.java).isNotEmpty()
+    val hasStrikethrough = spannable.getSpans(start, end, StrikethroughSpan::class.java).isNotEmpty()
+    val hasUnderline = spannable.getSpans(start, end, UnderlineSpan::class.java).isNotEmpty()
+    val baselineShiftSpans = spannable.getSpans(start, end, BaselineShiftSpan::class.java)
+    val hasSuperscript = baselineShiftSpans.any { it.spanType == BaselineShiftSpan.SpanType.SUPERSCRIPT }
+    val hasSubscript = baselineShiftSpans.any { it.spanType == BaselineShiftSpan.SpanType.SUBSCRIPT }
+    val linkSpans = spannable.getSpans(start, end, LinkSpan::class.java)
+    val hasHighlight = spannable.getSpans(start, end, HighlightSpan::class.java).isNotEmpty()
+
+    var result = text
+
+    // Innermost first
+    if (hasCode && linkSpans.isEmpty()) {
+      result = "`$result`"
+    }
+    if (hasStrikethrough) {
+      result = "~~$result~~"
+    }
+    if (hasSubscript) {
+      result = "~$result~"
+    }
+    if (hasSuperscript) {
+      result = "^$result^"
+    }
+    if (hasUnderline && linkSpans.isEmpty()) {
+      result = "<u>$result</u>"
+    }
+    if (hasEmphasis) {
+      result = "*$result*"
+    }
+    if (hasStrong) {
+      result = "**$result**"
+    }
+    if (linkSpans.isNotEmpty()) {
+      result = "[$result](${linkSpans[0].url})"
+    }
+    if (hasHighlight) {
+      result = "==$result=="
+    }
+
+    return result
+  }
+
+  private fun buildBlockPrefix(
+    blockquotePrefix: String?,
+    listPrefix: String?,
+  ): String =
+    buildString {
+      blockquotePrefix?.let { append(it) }
+      listPrefix?.let { append(it) }
+    }
+
+  private data class ExtractionState(
+    var blockquoteDepth: Int = -1,
+    var listDepth: Int = -1,
+    var needsBlankLine: Boolean = false,
+  )
+
+  /** Accumulates heading content across multiple span segments. */
+  private class HeadingAccumulator {
+    private var level: Int? = null
+    private val content = StringBuilder()
+
+    fun accumulate(
+      newLevel: Int,
+      text: String,
+      result: StringBuilder,
+      state: ExtractionState,
+    ) {
+      if (level != newLevel) {
+        flush(result, state)
+        level = newLevel
+      }
+      content.append(text.trim('\n'))
+    }
+
+    fun flush(
+      result: StringBuilder,
+      state: ExtractionState,
+    ) {
+      val currentLevel = level ?: return
+      if (content.isEmpty()) return
+
+      result.ensureBlankLine()
+      result.append("#".repeat(currentLevel))
+      result.append(" ")
+      result.append(content.toString().trim())
+      result.append("\n")
+
+      level = null
+      content.clear()
+      state.needsBlankLine = true
+    }
+  }
+
+  private fun StringBuilder.ensureBlankLine() {
+    if (isEmpty() || endsWith("\n\n")) return
+    append(if (endsWith("\n")) "\n" else "\n\n")
+  }
+
+  private fun StringBuilder.isAtLineStart(): Boolean = isEmpty() || endsWith("\n")
+
+  private fun extractMathLatex(
+    spannable: Spannable,
+    start: Int,
+    end: Int,
+  ): String? {
+    return try {
+      val mathInlineSpanClass = Class.forName("com.swmansion.enriched.markdown.spans.MathInlineSpan")
+      val spans = spannable.getSpans(start, end, mathInlineSpanClass)
+      if (spans.isEmpty()) return null
+      val latexField = mathInlineSpanClass.getDeclaredField("latex").apply { isAccessible = true }
+      latexField.get(spans[0]) as? String
+    } catch (_: Exception) {
+      null
+    }
+  }
+}

package/android/src/main/java/com/swmansion/enriched/markdown/utils/text/extensions/ParagraphUtils.kt

@@ -0,0 +1,9 @@
+package com.swmansion.enriched.markdown.utils.text.extensions
+
+import com.swmansion.enriched.markdown.parser.MarkdownASTNode
+
+fun MarkdownASTNode.containsBlockImage(): Boolean {
+  if (type != MarkdownASTNode.NodeType.Paragraph) return false
+  val firstChild = children.firstOrNull()
+  return firstChild != null && children.size == 1 && firstChild.type == MarkdownASTNode.NodeType.Image
+}

package/android/src/main/java/com/swmansion/enriched/markdown/utils/text/extensions/SpannableExtensions.kt

@@ -0,0 +1,65 @@
+package com.swmansion.enriched.markdown.utils.text.extensions
+
+import android.content.Context
+import android.text.SpannableString
+import android.text.SpannableStringBuilder
+import android.util.Log
+import com.swmansion.enriched.markdown.spans.MathMeasureRequest
+import com.swmansion.enriched.markdown.spans.MathMetrics
+import com.swmansion.enriched.markdown.utils.common.FeatureFlags
+
+fun SpannableStringBuilder.isInlineImage(): Boolean {
+  if (isEmpty()) return false
+  val lastChar = last()
+  return lastChar != '\n' && lastChar != '\u200B'
+}
+
+/** Swaps MathInlineSpans for MathInlinePlaceholderSpans safe for background-thread measurement. */
+fun SpannableString.replaceMathSpansWithPlaceholders(context: Context) {
+  if (!FeatureFlags.IS_MATH_ENABLED) return
+
+  try {
+    val spanClass = Class.forName("com.swmansion.enriched.markdown.spans.MathInlineSpan")
+    val placeholderClass = Class.forName("com.swmansion.enriched.markdown.spans.MathInlinePlaceholderSpan")
+
+    val mathSpans = getSpans(0, length, spanClass)
+    if (mathSpans.isNullOrEmpty()) return
+
+    val fontSizeField = spanClass.getDeclaredField("fontSize").apply { isAccessible = true }
+    val latexField = spanClass.getDeclaredField("latex").apply { isAccessible = true }
+
+    val requests =
+      mathSpans.map { span ->
+        MathMeasureRequest(
+          fontSize = fontSizeField.getFloat(span),
+          latex = latexField.get(span) as String,
+        )
+      }
+
+    val mathMeasureHelperClass = Class.forName("com.swmansion.enriched.markdown.spans.MathMeasureHelper")
+    val measureMethod = mathMeasureHelperClass.getMethod("measure", Context::class.java, List::class.java)
+
+    @Suppress("UNCHECKED_CAST")
+    val results = measureMethod.invoke(null, context, requests) as? List<MathMetrics> ?: return
+
+    val placeholderCtor = placeholderClass.getConstructor(MathMetrics::class.java)
+
+    mathSpans.forEachIndexed { i, oldSpan ->
+      val metrics = results.getOrNull(i) ?: return@forEachIndexed
+
+      val start = getSpanStart(oldSpan)
+      val end = getSpanEnd(oldSpan)
+      val flags = getSpanFlags(oldSpan)
+
+      if (start != -1 && end != -1) {
+        removeSpan(oldSpan)
+        val newSpan = placeholderCtor.newInstance(metrics)
+        setSpan(newSpan, start, end, flags)
+      }
+    }
+  } catch (_: ClassNotFoundException) {
+    // Expected if the module isn't linked; silent return
+  } catch (e: Exception) {
+    Log.e("MathSpan", "Failed to replace math spans", e)
+  }
+}

package/android/src/main/java/com/swmansion/enriched/markdown/utils/text/extensions/TextPaintExtensions.kt

@@ -0,0 +1,53 @@
+package com.swmansion.enriched.markdown.utils.text.extensions
+
+import android.content.Context
+import android.graphics.Typeface
+import android.text.TextPaint
+import com.facebook.react.common.ReactConstants
+import com.facebook.react.views.text.ReactTypefaceUtils.applyStyles
+import com.facebook.react.views.text.ReactTypefaceUtils.parseFontWeight
+import com.swmansion.enriched.markdown.renderer.BlockStyle
+
+fun TextPaint.applyColorPreserving(
+  color: Int,
+  vararg preserveColors: Int,
+) {
+  if (this.color !in preserveColors) {
+    this.color = color
+  }
+}
+
+private val typefaceCache = mutableMapOf<String, Typeface>()
+private val fontWeightCache = mutableMapOf<String?, Int>()
+
+fun TextPaint.applyBlockStyleFont(
+  blockStyle: BlockStyle,
+  context: Context,
+) {
+  val cacheKey = "${blockStyle.fontFamily}|${blockStyle.fontWeight}"
+
+  val cachedTypeface = typefaceCache[cacheKey]
+  if (cachedTypeface != null) {
+    this.typeface = cachedTypeface
+    return
+  }
+
+  val fontWeight =
+    fontWeightCache.getOrPut(blockStyle.fontWeight) {
+      parseFontWeight(blockStyle.fontWeight)
+    }
+
+  // Pass null as base typeface - this matches React Native Text behavior
+  // applyStyles will use ReactFontManager to load custom fonts from assets
+  val newTypeface =
+    applyStyles(
+      null, // Let applyStyles handle font loading from assets
+      ReactConstants.UNSET,
+      fontWeight,
+      blockStyle.fontFamily.takeIf { it.isNotEmpty() },
+      context.assets,
+    )
+
+  typefaceCache[cacheKey] = newTypeface
+  this.typeface = newTypeface
+}

package/android/src/main/java/com/swmansion/enriched/markdown/utils/text/interaction/CheckboxTouchHelper.kt

@@ -0,0 +1,54 @@
+package com.swmansion.enriched.markdown.utils.text.interaction
+
+import android.view.MotionEvent
+import android.view.ViewConfiguration
+import android.widget.TextView
+import com.swmansion.enriched.markdown.utils.text.interaction.TaskListHitTestResult
+import com.swmansion.enriched.markdown.utils.text.interaction.TaskListTapUtils
+import kotlin.math.abs
+
+class CheckboxTouchHelper(
+  private val textView: TextView,
+) {
+  var onCheckboxTap: ((taskIndex: Int, checked: Boolean, itemText: String) -> Unit)? = null
+
+  private var touchDownX = 0f
+  private var touchDownY = 0f
+  private var pendingHit: TaskListHitTestResult? = null
+  private val touchSlop: Int by lazy { ViewConfiguration.get(textView.context).scaledTouchSlop }
+
+  /** Returns `true` if the event was consumed by a checkbox gesture. */
+  fun onTouchEvent(event: MotionEvent): Boolean {
+    when (event.actionMasked) {
+      MotionEvent.ACTION_DOWN -> {
+        val hit = TaskListTapUtils.hitTest(textView, event.x, event.y) ?: return false
+        touchDownX = event.x
+        touchDownY = event.y
+        pendingHit = hit
+        return true
+      }
+
+      MotionEvent.ACTION_MOVE -> {
+        if (pendingHit != null && isExceedingSlop(event)) {
+          pendingHit = null
+        }
+      }
+
+      MotionEvent.ACTION_UP -> {
+        val hit = pendingHit ?: return false
+        pendingHit = null
+        if (!isExceedingSlop(event)) {
+          onCheckboxTap?.invoke(hit.taskIndex, hit.checked, hit.itemText)
+        }
+        return true
+      }
+
+      MotionEvent.ACTION_CANCEL -> {
+        pendingHit = null
+      }
+    }
+    return pendingHit != null
+  }
+
+  private fun isExceedingSlop(event: MotionEvent): Boolean = abs(event.x - touchDownX) > touchSlop || abs(event.y - touchDownY) > touchSlop
+}