react-native-enriched-html 0.0.0 → 1.1.0-nightly-20260617-3dfd09072

package/android/src/main/java/com/swmansion/enriched/textinput/styles/ParametrizedStyles.kt

@@ -0,0 +1,408 @@
+package com.swmansion.enriched.textinput.styles
+
+import android.text.Editable
+import android.text.Spannable
+import android.text.SpannableStringBuilder
+import android.text.Spanned
+import com.swmansion.enriched.common.EnrichedConstants
+import com.swmansion.enriched.textinput.EnrichedTextInputView
+import com.swmansion.enriched.textinput.spans.EnrichedInputImageSpan
+import com.swmansion.enriched.textinput.spans.EnrichedInputLinkSpan
+import com.swmansion.enriched.textinput.spans.EnrichedInputMentionSpan
+import com.swmansion.enriched.textinput.spans.EnrichedSpans
+import com.swmansion.enriched.textinput.utils.getSafeSpanBoundaries
+import com.swmansion.enriched.textinput.utils.safelyRemoveZWS
+
+class ParametrizedStyles(
+  private val view: EnrichedTextInputView,
+) {
+  private var mentionStart: Int? = null
+  private var isSettingLinkSpan = false
+
+  var mentionIndicators: Array<String> = emptyArray<String>()
+
+  fun <T> removeSpansForRange(
+    spannable: Spannable,
+    start: Int,
+    end: Int,
+    clazz: Class<T>,
+  ): Boolean {
+    val ssb = spannable as SpannableStringBuilder
+    val spans = ssb.getSpans(start, end, clazz)
+    if (spans.isEmpty()) return false
+
+    ssb.safelyRemoveZWS(start, end)
+
+    for (span in spans) {
+      ssb.removeSpan(span)
+    }
+
+    return true
+  }
+
+  fun setLinkSpan(
+    start: Int,
+    end: Int,
+    text: String,
+    url: String,
+  ) {
+    isSettingLinkSpan = true
+
+    val spannable = view.text as SpannableStringBuilder
+    val spans = spannable.getSpans(start, end, EnrichedInputLinkSpan::class.java)
+    for (span in spans) {
+      spannable.removeSpan(span)
+    }
+
+    if (start == end) {
+      spannable.insert(start, text)
+    } else {
+      spannable.replace(start, end, text)
+    }
+
+    val spanEnd = start + text.length
+    val span = EnrichedInputLinkSpan(url, view.htmlStyle, true)
+    val (safeStart, safeEnd) = spannable.getSafeSpanBoundaries(start, spanEnd)
+    spannable.setSpan(span, safeStart, safeEnd, Spanned.SPAN_EXCLUSIVE_EXCLUSIVE)
+
+    view.selection?.validateStyles()
+    isSettingLinkSpan = false
+  }
+
+  fun removeLinkSpans(
+    start: Int,
+    end: Int,
+  ) {
+    val spannable = view.text as SpannableStringBuilder
+    val textLength = spannable.length
+    val clampedStart = minOf(start, end).coerceIn(0, textLength)
+    val clampedEnd = maxOf(start, end).coerceIn(0, textLength)
+
+    val spans = spannable.getSpans(clampedStart, clampedEnd, EnrichedInputLinkSpan::class.java)
+    for (span in spans) {
+      spannable.removeSpan(span)
+    }
+    view.selection?.validateStyles()
+  }
+
+  fun afterTextChanged(
+    s: Editable,
+    startCursorPosition: Int,
+    endCursorPosition: Int,
+  ) {
+    afterTextChangedLinks(startCursorPosition, endCursorPosition)
+    afterTextChangedMentions(s, startCursorPosition)
+  }
+
+  fun onStyleToggled(
+    name: String,
+    start: Int,
+    end: Int,
+  ) {
+    // Run afterTextChangedLinks on the range affected by the style toggle to re-detect links.
+    // For example, toggling a code block on and off will restore automatically detected links.
+    val linkConfig = EnrichedSpans.getMergingConfigForStyle(EnrichedSpans.LINK, view.htmlStyle) ?: return
+    if (name in linkConfig.blockingStyles || name in linkConfig.conflictingStyles) {
+      afterTextChangedLinks(start, end)
+    }
+  }
+
+  fun detectLinksInRange(
+    spannable: Spannable,
+    start: Int,
+    end: Int,
+  ) {
+    val regex = view.linkRegex ?: return
+    val textLength = spannable.length
+    val safeStart = minOf(start, end).coerceIn(0, textLength)
+    val safeEnd = maxOf(start, end).coerceIn(0, textLength)
+    if (safeStart >= safeEnd) return
+
+    val contextText = spannable.subSequence(safeStart, safeEnd).toString()
+
+    val spans = spannable.getSpans(safeStart, safeEnd, EnrichedInputLinkSpan::class.java)
+    for (span in spans) {
+      if (span.getIsManual()) continue
+      spannable.removeSpan(span)
+    }
+
+    val wordsRegex = Regex("\\S+")
+    for (wordMatch in wordsRegex.findAll(contextText)) {
+      var word = wordMatch.value
+      var wordStart = wordMatch.range.first
+
+      // Do not include zero-width space in link detection
+      if (word.startsWith(EnrichedConstants.ZWS_STRING)) {
+        word = word.substring(1)
+        wordStart += 1
+      }
+
+      // Loop over words and detect links
+      val matcher = regex.matcher(word)
+      while (matcher.find()) {
+        val linkStart = matcher.start()
+        val linkEnd = matcher.end()
+
+        val spanStart = start + wordStart + linkStart
+        val spanEnd = start + wordStart + linkEnd
+
+        val (safeStart, safeEnd) = spannable.getSafeSpanBoundaries(spanStart, spanEnd)
+
+        // Do not overwrite a manual link span with an auto-detected one
+        val overlappingManual =
+          spannable
+            .getSpans(safeStart, safeEnd, EnrichedInputLinkSpan::class.java)
+            .any { it.getIsManual() }
+        if (overlappingManual) continue
+
+        val span = EnrichedInputLinkSpan(matcher.group(), view.htmlStyle)
+        spannable.setSpan(
+          span,
+          safeStart,
+          safeEnd,
+          Spanned.SPAN_EXCLUSIVE_EXCLUSIVE,
+        )
+      }
+    }
+  }
+
+  private fun getWordAtIndex(
+    s: CharSequence,
+    index: Int,
+  ): TextRange? {
+    if (index < 0) return null
+
+    var start = index
+    var end = index
+
+    while (start > 0 && !Character.isWhitespace(s[start - 1])) {
+      start--
+    }
+
+    while (end < s.length && !Character.isWhitespace(s[end])) {
+      end++
+    }
+
+    val result = s.subSequence(start, end).toString()
+
+    return TextRange(result, start, end)
+  }
+
+  // After editing text we want to automatically detect links in the affected range
+  // Affected range is range + previous word + next word
+  private fun getLinksAffectedRange(
+    s: CharSequence,
+    start: Int,
+    end: Int,
+  ): IntRange {
+    var actualStart = start
+    var actualEnd = end
+
+    // Expand backward to find the start of the first affected word
+    while (actualStart > 0 && !Character.isWhitespace(s[actualStart - 1])) {
+      actualStart--
+    }
+
+    // Expand forward to find the end of the last affected word
+    while (actualEnd < s.length && !Character.isWhitespace(s[actualEnd])) {
+      actualEnd++
+    }
+
+    return actualStart..actualEnd
+  }
+
+  private fun canLinkBeApplied(): Boolean {
+    val mergingConfig = EnrichedSpans.getMergingConfigForStyle(EnrichedSpans.LINK, view.htmlStyle) ?: return true
+    val conflictingStyles = mergingConfig.conflictingStyles
+    val blockingStyles = mergingConfig.blockingStyles
+
+    for (style in blockingStyles) {
+      if (view.spanState?.getStart(style) != null) return false
+    }
+
+    for (style in conflictingStyles) {
+      if (view.spanState?.getStart(style) != null) return false
+    }
+
+    return true
+  }
+
+  private fun afterTextChangedLinks(
+    editStart: Int,
+    editEnd: Int,
+  ) {
+    // Do not detect link if it's applied manually
+    if (isSettingLinkSpan || !canLinkBeApplied()) return
+    val spannable = view.text as? Spannable ?: return
+
+    val affectedRange = getLinksAffectedRange(spannable, editStart, editEnd)
+    detectLinksInRange(spannable, affectedRange.first, affectedRange.last)
+  }
+
+  private fun afterTextChangedMentions(
+    s: CharSequence,
+    endCursorPosition: Int,
+  ) {
+    val mentionHandler = view.mentionHandler ?: return
+    val currentWord = getWordAtIndex(s, endCursorPosition) ?: return
+    val spannable = view.text as Spannable
+
+    val indicatorsPattern = mentionIndicators.joinToString("|") { Regex.escape(it) }
+    val mentionIndicatorRegex = Regex("^($indicatorsPattern)")
+    val mentionRegex = Regex("^($indicatorsPattern)\\S*")
+
+    var indicator: String
+    var finalStart: Int
+    val finalEnd = currentWord.end
+
+    // No mention in the current word, check previous one
+    if (!mentionRegex.matches(currentWord.text)) {
+      val previousWord = getWordAtIndex(spannable, currentWord.start - 1)
+
+      // No previous word -> no mention to be detected
+      if (previousWord == null) {
+        mentionHandler.endMention()
+        return
+      }
+
+      // Previous word is not a mention -> end mention
+      if (!mentionRegex.matches(previousWord.text)) {
+        mentionHandler.endMention()
+        return
+      }
+
+      // Previous word is a mention -> use it
+      finalStart = previousWord.start
+      indicator = mentionIndicatorRegex.find(previousWord.text)?.value ?: ""
+    } else {
+      // Current word is a mention -> use it
+      finalStart = currentWord.start
+      indicator = mentionIndicatorRegex.find(currentWord.text)?.value ?: ""
+    }
+
+    // Mirror iOS conflicting-styles behaviour: check the full candidate range for
+    // a finalized mention span. If the span's stored text still matches what is in
+    // the buffer the mention is intact — block the event (covers HTML-loaded
+    // mentions and typing adjacent to a freshly-selected mention).
+    // If the span is stale (user edited inside it), remove it and record mentionStart
+    // so setMentionSpan can replace text correctly when the user picks a new mention.
+    val rangeSpans = spannable.getSpans(finalStart, finalEnd, EnrichedInputMentionSpan::class.java)
+    for (span in rangeSpans) {
+      val spanStart = spannable.getSpanStart(span)
+      val spanEnd = spannable.getSpanEnd(span)
+      val currentSpanText = spannable.subSequence(spanStart, spanEnd).toString()
+      if (currentSpanText == span.getText()) {
+        mentionHandler.endMention()
+        return
+      }
+      spannable.removeSpan(span)
+      mentionStart = spanStart
+    }
+
+    // Extract text without indicator
+    val text = spannable.subSequence(finalStart, finalEnd).toString().replaceFirst(indicator, "")
+
+    // Means we are starting mention
+    if (text.isEmpty()) {
+      mentionStart = finalStart
+    }
+
+    mentionHandler.onMention(indicator, text)
+  }
+
+  fun setImageSpan(
+    src: String,
+    width: Float,
+    height: Float,
+  ) {
+    if (view.selection == null) return
+    val spannable = view.text as SpannableStringBuilder
+    val (start, originalEnd) = view.selection.getInlineSelection()
+
+    if (start == originalEnd) {
+      spannable.insert(start, EnrichedConstants.ORC_STRING)
+    } else {
+      val spans = spannable.getSpans(start, originalEnd, EnrichedInputImageSpan::class.java)
+      for (s in spans) {
+        spannable.removeSpan(s)
+      }
+
+      spannable.replace(start, originalEnd, EnrichedConstants.ORC_STRING)
+    }
+
+    val (imageStart, imageEnd) = spannable.getSafeSpanBoundaries(start, start + 1)
+    val span = EnrichedInputImageSpan.createEnrichedImageSpan(src, width.toInt(), height.toInt())
+    span.observeAsyncDrawableLoaded(view.text)
+
+    spannable.setSpan(span, imageStart, imageEnd, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE)
+  }
+
+  fun startMention(indicator: String) {
+    val selection = view.selection ?: return
+
+    val spannable = view.text as SpannableStringBuilder
+    val (start, end) = selection.getInlineSelection()
+
+    if (start == end) {
+      spannable.insert(start, indicator)
+    } else {
+      spannable.replace(start, end, indicator)
+    }
+  }
+
+  fun setMentionSpan(
+    indicator: String,
+    text: String,
+    attributes: Map<String, String>,
+  ) {
+    val selection = view.selection ?: return
+
+    val spannable = view.text as SpannableStringBuilder
+    val (selectionStart, selectionEnd) = selection.getInlineSelection()
+    val spans = spannable.getSpans(selectionStart, selectionEnd, EnrichedInputMentionSpan::class.java)
+
+    for (span in spans) {
+      spannable.removeSpan(span)
+    }
+
+    val start = mentionStart ?: selectionStart
+
+    view.runAsATransaction {
+      spannable.replace(start, selectionEnd, text)
+
+      val span = EnrichedInputMentionSpan(text, indicator, attributes, view.htmlStyle)
+      val spanEnd = start + text.length
+      val (safeStart, safeEnd) = spannable.getSafeSpanBoundaries(start, spanEnd)
+      spannable.setSpan(span, safeStart, safeEnd, Spanned.SPAN_EXCLUSIVE_EXCLUSIVE)
+
+      val hasSpaceAtTheEnd = spannable.length > safeEnd && spannable[safeEnd] == ' '
+      if (!hasSpaceAtTheEnd) {
+        spannable.insert(safeEnd, " ")
+      }
+    }
+
+    view.mentionHandler?.reset()
+    view.selection.validateStyles()
+    mentionStart = null
+  }
+
+  fun getStyleRange(): Pair<Int, Int> = view.selection?.getInlineSelection() ?: Pair(0, 0)
+
+  fun removeStyle(
+    name: String,
+    start: Int,
+    end: Int,
+  ): Boolean {
+    val config = EnrichedSpans.parametrizedStyles[name] ?: return false
+    val spannable = view.text as Spannable
+    return removeSpansForRange(spannable, start, end, config.clazz)
+  }
+
+  companion object {
+    data class TextRange(
+      val text: String,
+      val start: Int,
+      val end: Int,
+    )
+  }
+}

package/android/src/main/java/com/swmansion/enriched/textinput/utils/EnrichedEditableFactory.kt

@@ -0,0 +1,17 @@
+package com.swmansion.enriched.textinput.utils
+
+import android.text.Editable
+import android.text.Spannable
+import android.text.SpannableStringBuilder
+import com.swmansion.enriched.textinput.watchers.EnrichedSpanWatcher
+
+class EnrichedEditableFactory(
+  private val watcher: EnrichedSpanWatcher,
+) : Editable.Factory() {
+  override fun newEditable(source: CharSequence): Editable {
+    val s = source as? SpannableStringBuilder ?: SpannableStringBuilder(source)
+    s.removeSpan(watcher)
+    s.setSpan(watcher, 0, s.length, Spannable.SPAN_INCLUSIVE_INCLUSIVE)
+    return s
+  }
+}