@apollohg/react-native-rich-text-editor 2.0.0

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

@@ -0,0 +1,650 @@
+package com.apollohg.editor
+
+import android.graphics.Color
+import android.graphics.Typeface
+import org.json.JSONObject
+
+data class EditorTextStyle(
+    val fontFamily: String? = null,
+    val fontSize: Float? = null,
+    val fontWeight: String? = null,
+    val fontStyle: String? = null,
+    val color: Int? = null,
+    val lineHeight: Float? = null,
+    val spacingAfter: Float? = null,
+    val letterSpacing: Float? = null,
+    val textAlign: String? = null,
+    val backgroundColor: Int? = null,
+    val textDecorationLine: String? = null,
+    val textDecorationColor: Int? = null,
+    val textDecorationStyle: String? = null
+) {
+    companion object {
+        fun fromJson(json: JSONObject?): EditorTextStyle? {
+            json ?: return null
+            return EditorTextStyle(
+                fontFamily = json.optNullableString("fontFamily"),
+                fontSize = json.optNullableFloat("fontSize"),
+                fontWeight = json.optNullableString("fontWeight"),
+                fontStyle = json.optNullableString("fontStyle"),
+                color = parseColor(json.optNullableString("color")),
+                lineHeight = json.optNullableFloat("lineHeight"),
+                spacingAfter = json.optNullableFloat("spacingAfter"),
+                letterSpacing = json.optNullableFloat("letterSpacing"),
+                textAlign = json.optNullableString("textAlign"),
+                backgroundColor = parseColor(json.optNullableString("backgroundColor")),
+                textDecorationLine = json.optNullableString("textDecorationLine"),
+                textDecorationColor = parseColor(json.optNullableString("textDecorationColor")),
+                textDecorationStyle = json.optNullableString("textDecorationStyle")
+            )
+        }
+    }
+
+    fun mergedWith(other: EditorTextStyle?): EditorTextStyle {
+        other ?: return this
+        return copy(
+            fontFamily = other.fontFamily ?: fontFamily,
+            fontSize = other.fontSize ?: fontSize,
+            fontWeight = other.fontWeight ?: fontWeight,
+            fontStyle = other.fontStyle ?: fontStyle,
+            color = other.color ?: color,
+            lineHeight = other.lineHeight ?: lineHeight,
+            spacingAfter = other.spacingAfter ?: spacingAfter,
+            letterSpacing = other.letterSpacing ?: letterSpacing,
+            textAlign = other.textAlign ?: textAlign,
+            backgroundColor = other.backgroundColor ?: backgroundColor,
+            textDecorationLine = mergeDecoration(textDecorationLine, other.textDecorationLine),
+            textDecorationColor = other.textDecorationColor ?: textDecorationColor,
+            textDecorationStyle = other.textDecorationStyle ?: textDecorationStyle
+        )
+    }
+
+    fun typefaceStyle(): Int {
+        val bold = fontWeight == "bold" || fontWeight?.toIntOrNull()?.let { it >= 600 } == true
+        val italic = fontStyle == "italic"
+        return when {
+            bold && italic -> Typeface.BOLD_ITALIC
+            bold -> Typeface.BOLD
+            italic -> Typeface.ITALIC
+            else -> Typeface.NORMAL
+        }
+    }
+}
+
+data class EditorListTheme(
+    val indent: Float? = null,
+    val baseIndentMultiplier: Float? = null,
+    val itemSpacing: Float? = null,
+    val spacingAfter: Float? = null,
+    val markerColor: Int? = null,
+    val markerScale: Float? = null,
+    val markerGap: Float? = null,
+    val orderedMarker: EditorOrderedListMarkerTheme? = null
+) {
+    companion object {
+        fun fromJson(json: JSONObject?): EditorListTheme? {
+            json ?: return null
+            return EditorListTheme(
+                indent = json.optNullableFloat("indent"),
+                baseIndentMultiplier = json.optNullableFloat("baseIndentMultiplier"),
+                itemSpacing = json.optNullableFloat("itemSpacing"),
+                spacingAfter = json.optNullableFloat("spacingAfter"),
+                markerColor = parseColor(json.optNullableString("markerColor")),
+                markerScale = json.optNullableFloat("markerScale"),
+                markerGap = json.optNullableFloat("markerGap"),
+                orderedMarker = EditorOrderedListMarkerTheme.fromJson(
+                    json.optJSONObject("orderedMarker")
+                )
+            )
+        }
+    }
+}
+
+data class EditorHorizontalRuleTheme(
+    val color: Int? = null,
+    val thickness: Float? = null,
+    val verticalMargin: Float? = null
+) {
+    companion object {
+        fun fromJson(json: JSONObject?): EditorHorizontalRuleTheme? {
+            json ?: return null
+            return EditorHorizontalRuleTheme(
+                color = parseColor(json.optNullableString("color")),
+                thickness = json.optNullableFloat("thickness"),
+                verticalMargin = json.optNullableFloat("verticalMargin")
+            )
+        }
+    }
+}
+
+data class EditorBlockquoteTheme(
+    val text: EditorTextStyle? = null,
+    val indent: Float? = null,
+    val borderColor: Int? = null,
+    val borderWidth: Float? = null,
+    val markerGap: Float? = null
+) {
+    companion object {
+        fun fromJson(json: JSONObject?): EditorBlockquoteTheme? {
+            json ?: return null
+            return EditorBlockquoteTheme(
+                text = EditorTextStyle.fromJson(json.optJSONObject("text")),
+                indent = json.optNullableFloat("indent"),
+                borderColor = parseColor(json.optNullableString("borderColor")),
+                borderWidth = json.optNullableFloat("borderWidth"),
+                markerGap = json.optNullableFloat("markerGap")
+            )
+        }
+    }
+}
+
+data class EditorCodeBlockTheme(
+    val text: EditorTextStyle? = null,
+    val backgroundColor: Int? = null,
+    val borderRadius: Float? = null,
+    val paddingHorizontal: Float? = null,
+    val paddingVertical: Float? = null
+) {
+    companion object {
+        fun fromJson(json: JSONObject?): EditorCodeBlockTheme? {
+            json ?: return null
+            return EditorCodeBlockTheme(
+                text = EditorTextStyle.fromJson(json.optJSONObject("text")),
+                backgroundColor = parseColor(json.optNullableString("backgroundColor")),
+                borderRadius = json.optNullableFloat("borderRadius"),
+                paddingHorizontal = json.optNullableFloat("paddingHorizontal"),
+                paddingVertical = json.optNullableFloat("paddingVertical")
+            )
+        }
+    }
+}
+
+data class EditorLinkTheme(
+    val fontFamily: String? = null,
+    val fontSize: Float? = null,
+    val fontWeight: String? = null,
+    val fontStyle: String? = null,
+    val color: Int? = null,
+    val backgroundColor: Int? = null,
+    val underline: Boolean? = null
+) {
+    companion object {
+        fun fromJson(json: JSONObject?): EditorLinkTheme? {
+            json ?: return null
+            return EditorLinkTheme(
+                fontFamily = json.optNullableString("fontFamily"),
+                fontSize = json.optNullableFloat("fontSize"),
+                fontWeight = json.optNullableString("fontWeight"),
+                fontStyle = json.optNullableString("fontStyle"),
+                color = parseColor(json.optNullableString("color")),
+                backgroundColor = parseColor(json.optNullableString("backgroundColor")),
+                underline = if (json.has("underline")) json.optBoolean("underline") else null
+            )
+        }
+    }
+
+    fun asTextStyle(): EditorTextStyle = EditorTextStyle(
+        fontFamily = fontFamily,
+        fontSize = fontSize,
+        fontWeight = fontWeight,
+        fontStyle = fontStyle,
+        color = color
+    )
+}
+
+data class EditorMentionNodeTheme(
+    val textColor: Int? = null,
+    val backgroundColor: Int? = null,
+    val borderColor: Int? = null,
+    val borderWidth: Float? = null,
+    val borderRadius: Float? = null,
+    val fontWeight: String? = null,
+    val style: EditorElementStyle? = null
+) {
+    fun mergedWith(other: EditorMentionNodeTheme?): EditorMentionNodeTheme {
+        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,
+            style = style?.mergedWith(other.style) ?: other.style
+        )
+    }
+
+    companion object {
+        fun fromJson(json: JSONObject?): EditorMentionNodeTheme? {
+            json ?: return null
+            return EditorMentionNodeTheme(
+                textColor = parseColor(json.optNullableString("textColor")),
+                backgroundColor = parseColor(json.optNullableString("backgroundColor")),
+                borderColor = parseColor(json.optNullableString("borderColor")),
+                borderWidth = json.optNullableFloat("borderWidth"),
+                borderRadius = json.optNullableFloat("borderRadius"),
+                fontWeight = json.optNullableString("fontWeight"),
+                style = json.optJSONObject("style")?.let { EditorStyleSheet.decodeElement(it) }
+            )
+        }
+    }
+}
+
+data class EditorMentionSuggestionOptionTheme(
+    val textColor: Int? = null,
+    val secondaryTextColor: Int? = null,
+    val backgroundColor: Int? = null,
+    val borderColor: Int? = null,
+    val borderWidth: Float? = null,
+    val borderRadius: Float? = null,
+    val fontWeight: String? = null,
+    val highlightedBackgroundColor: Int? = null,
+    val highlightedTextColor: Int? = null
+) {
+    fun mergedWith(other: EditorMentionSuggestionOptionTheme?): EditorMentionSuggestionOptionTheme {
+        other ?: return this
+        return copy(
+            textColor = other.textColor ?: textColor,
+            secondaryTextColor = other.secondaryTextColor ?: secondaryTextColor,
+            backgroundColor = other.backgroundColor ?: backgroundColor,
+            borderColor = other.borderColor ?: borderColor,
+            borderWidth = other.borderWidth ?: borderWidth,
+            borderRadius = other.borderRadius ?: borderRadius,
+            fontWeight = other.fontWeight ?: fontWeight,
+            highlightedBackgroundColor =
+                other.highlightedBackgroundColor ?: highlightedBackgroundColor,
+            highlightedTextColor = other.highlightedTextColor ?: highlightedTextColor
+        )
+    }
+
+    companion object {
+        fun fromJson(json: JSONObject?): EditorMentionSuggestionOptionTheme? {
+            json ?: return null
+            return EditorMentionSuggestionOptionTheme(
+                textColor = parseColor(json.optNullableString("textColor")),
+                secondaryTextColor = parseColor(json.optNullableString("secondaryTextColor")),
+                backgroundColor = parseColor(json.optNullableString("backgroundColor")),
+                borderColor = parseColor(json.optNullableString("borderColor")),
+                borderWidth = json.optNullableFloat("borderWidth"),
+                borderRadius = json.optNullableFloat("borderRadius"),
+                fontWeight = json.optNullableString("fontWeight"),
+                highlightedBackgroundColor =
+                    parseColor(json.optNullableString("highlightedBackgroundColor")),
+                highlightedTextColor = parseColor(json.optNullableString("highlightedTextColor"))
+            )
+        }
+    }
+}
+
+data class EditorMentionSuggestionsTheme(
+    val backgroundColor: Int? = null,
+    val borderColor: Int? = null,
+    val borderWidth: Float? = null,
+    val borderRadius: Float? = null,
+    val shadowColor: Int? = null,
+    val option: EditorMentionSuggestionOptionTheme? = null
+) {
+    fun mergedWith(other: EditorMentionSuggestionsTheme?): EditorMentionSuggestionsTheme {
+        other ?: return this
+        return copy(
+            backgroundColor = other.backgroundColor ?: backgroundColor,
+            borderColor = other.borderColor ?: borderColor,
+            borderWidth = other.borderWidth ?: borderWidth,
+            borderRadius = other.borderRadius ?: borderRadius,
+            shadowColor = other.shadowColor ?: shadowColor,
+            option = option?.mergedWith(other.option) ?: other.option
+        )
+    }
+
+    companion object {
+        fun fromJson(json: JSONObject?): EditorMentionSuggestionsTheme? {
+            json ?: return null
+            return EditorMentionSuggestionsTheme(
+                backgroundColor = parseColor(json.optNullableString("backgroundColor")),
+                borderColor = parseColor(json.optNullableString("borderColor")),
+                borderWidth = json.optNullableFloat("borderWidth"),
+                borderRadius = json.optNullableFloat("borderRadius"),
+                shadowColor = parseColor(json.optNullableString("shadowColor")),
+                option = EditorMentionSuggestionOptionTheme.fromJson(json.optJSONObject("option"))
+            )
+        }
+    }
+}
+
+data class EditorMentionTheme(
+    val node: EditorMentionNodeTheme? = null,
+    val suggestions: EditorMentionSuggestionsTheme? = null
+) {
+    fun mergedWith(other: EditorMentionTheme?): EditorMentionTheme {
+        other ?: return this
+        return copy(
+            node = node?.mergedWith(other.node) ?: other.node,
+            suggestions = suggestions?.mergedWith(other.suggestions) ?: other.suggestions
+        )
+    }
+
+    companion object {
+        fun fromJson(json: JSONObject?): EditorMentionTheme? {
+            json ?: return null
+            return EditorMentionTheme(
+                node = EditorMentionNodeTheme.fromJson(json.optJSONObject("node")),
+                suggestions =
+                    EditorMentionSuggestionsTheme.fromJson(json.optJSONObject("suggestions"))
+            )
+        }
+    }
+}
+
+enum class EditorToolbarAppearance {
+    CUSTOM,
+    NATIVE;
+
+    companion object {
+        fun fromRaw(raw: String?): EditorToolbarAppearance? = when (raw?.trim()?.lowercase()) {
+            "custom" -> CUSTOM
+            "native" -> NATIVE
+            else -> null
+        }
+    }
+}
+
+data class EditorToolbarButtonStyle(
+    val iconSize: Float? = null,
+    val color: Int? = null,
+    val backgroundColor: Int? = null,
+    val activeColor: Int? = null,
+    val disabledColor: Int? = null,
+    val activeBackgroundColor: Int? = null,
+    val disabledBackgroundColor: Int? = null,
+    val borderRadius: Float? = null
+) {
+    companion object {
+        fun fromJson(json: JSONObject?): EditorToolbarButtonStyle? {
+            json ?: return null
+            return EditorToolbarButtonStyle(
+                iconSize = json.optNullableFloat("iconSize"),
+                color = parseColor(json.optNullableString("color")),
+                backgroundColor = parseColor(json.optNullableString("backgroundColor")),
+                activeColor = parseColor(json.optNullableString("activeColor")),
+                disabledColor = parseColor(json.optNullableString("disabledColor")),
+                activeBackgroundColor = parseColor(
+                    json.optNullableString("activeBackgroundColor")
+                ),
+                disabledBackgroundColor = parseColor(
+                    json.optNullableString("disabledBackgroundColor")
+                ),
+                borderRadius = json.optNullableFloat("borderRadius")
+            )
+        }
+    }
+}
+
+data class EditorToolbarTheme(
+    val appearance: EditorToolbarAppearance? = null,
+    val height: Float? = null,
+    val backgroundColor: Int? = null,
+    val borderColor: Int? = null,
+    val borderWidth: Float? = null,
+    val borderRadius: Float? = null,
+    val marginTop: Float? = null,
+    val showTopBorder: Boolean? = null,
+    val keyboardOffset: Float? = null,
+    val horizontalInset: Float? = null,
+    val separatorColor: Int? = null,
+    val buttonColor: Int? = null,
+    val buttonBackgroundColor: Int? = null,
+    val buttonIconSize: Float? = null,
+    val buttonActiveColor: Int? = null,
+    val buttonDisabledColor: Int? = null,
+    val buttonActiveBackgroundColor: Int? = null,
+    val buttonDisabledBackgroundColor: Int? = null,
+    val buttonBorderRadius: Float? = null
+) {
+    fun resolvedKeyboardOffset(): Float =
+        keyboardOffset ?: if (appearance == EditorToolbarAppearance.NATIVE) 8f else 0f
+
+    fun resolvedHorizontalInset(): Float =
+        horizontalInset ?: if (appearance == EditorToolbarAppearance.NATIVE) 0f else 0f
+
+    fun resolvedBorderRadius(): Float = if (appearance ==
+        EditorToolbarAppearance.NATIVE
+    ) {
+        0f
+    } else {
+        (borderRadius ?: 0f)
+    }
+
+    fun resolvedBorderWidth(): Float =
+        borderWidth ?: if (appearance == EditorToolbarAppearance.NATIVE) 0f else 1f
+
+    fun resolvedButtonBorderRadius(): Float =
+        buttonBorderRadius ?: if (appearance == EditorToolbarAppearance.NATIVE) 20f else 6f
+
+    companion object {
+        fun fromJson(json: JSONObject?): EditorToolbarTheme? {
+            json ?: return null
+            return EditorToolbarTheme(
+                appearance = EditorToolbarAppearance.fromRaw(json.optNullableString("appearance")),
+                height = json.optNullableFloat("height"),
+                backgroundColor = parseColor(json.optNullableString("backgroundColor")),
+                borderColor = parseColor(json.optNullableString("borderColor")),
+                borderWidth = json.optNullableFloat("borderWidth"),
+                borderRadius = json.optNullableFloat("borderRadius"),
+                marginTop = json.optNullableFloat("marginTop"),
+                showTopBorder = if (json.has(
+                        "showTopBorder"
+                    )
+                ) {
+                    json.optBoolean("showTopBorder")
+                } else {
+                    null
+                },
+                keyboardOffset = json.optNullableFloat("keyboardOffset"),
+                horizontalInset = json.optNullableFloat("horizontalInset"),
+                separatorColor = parseColor(json.optNullableString("separatorColor")),
+                buttonColor = parseColor(json.optNullableString("buttonColor")),
+                buttonBackgroundColor = parseColor(json.optNullableString("buttonBackgroundColor")),
+                buttonIconSize = json.optNullableFloat("buttonIconSize"),
+                buttonActiveColor = parseColor(json.optNullableString("buttonActiveColor")),
+                buttonDisabledColor = parseColor(json.optNullableString("buttonDisabledColor")),
+                buttonActiveBackgroundColor = parseColor(
+                    json.optNullableString("buttonActiveBackgroundColor")
+                ),
+                buttonDisabledBackgroundColor = parseColor(
+                    json.optNullableString("buttonDisabledBackgroundColor")
+                ),
+                buttonBorderRadius = json.optNullableFloat("buttonBorderRadius")
+            )
+        }
+    }
+}
+
+data class EditorContentInsets(
+    val top: Float? = null,
+    val right: Float? = null,
+    val bottom: Float? = null,
+    val left: Float? = null
+) {
+    companion object {
+        fun fromJson(json: JSONObject?): EditorContentInsets? {
+            json ?: return null
+            return EditorContentInsets(
+                top = json.optNullableFloat("top"),
+                right = json.optNullableFloat("right"),
+                bottom = json.optNullableFloat("bottom"),
+                left = json.optNullableFloat("left")
+            )
+        }
+    }
+}
+
+data class EditorTheme(
+    val text: EditorTextStyle? = null,
+    val paragraph: EditorTextStyle? = null,
+    val blockquote: EditorBlockquoteTheme? = null,
+    val codeBlock: EditorCodeBlockTheme? = null,
+    val headings: Map<String, EditorTextStyle> = emptyMap(),
+    val list: EditorListTheme? = null,
+    val horizontalRule: EditorHorizontalRuleTheme? = null,
+    val mentions: EditorMentionTheme? = null,
+    val links: EditorLinkTheme? = null,
+    val toolbar: EditorToolbarTheme? = null,
+    val placeholderColor: Int? = null,
+    val backgroundColor: Int? = null,
+    val borderRadius: Float? = null,
+    val contentInsets: EditorContentInsets? = null,
+    val styleSheet: EditorStyleSheet? = null
+) {
+    companion object {
+        fun fromJson(json: String?): EditorTheme? {
+            if (json.isNullOrBlank()) return null
+            val root = try {
+                JSONObject(json)
+            } catch (_: Exception) {
+                return null
+            }
+
+            if (root.has("version")) return EditorStyleSheet.decodeTheme(root)
+
+            val headings = mutableMapOf<String, EditorTextStyle>()
+            for (level in listOf("h1", "h2", "h3", "h4", "h5", "h6")) {
+                val style = EditorTextStyle.fromJson(
+                    root.optJSONObject("headings")?.optJSONObject(level)
+                )
+                if (style != null) {
+                    headings[level] = style
+                }
+            }
+
+            return EditorTheme(
+                text = EditorTextStyle.fromJson(root.optJSONObject("text")),
+                paragraph = EditorTextStyle.fromJson(root.optJSONObject("paragraph")),
+                blockquote = EditorBlockquoteTheme.fromJson(root.optJSONObject("blockquote")),
+                codeBlock = EditorCodeBlockTheme.fromJson(root.optJSONObject("codeBlock")),
+                headings = headings,
+                list = EditorListTheme.fromJson(root.optJSONObject("list")),
+                horizontalRule = EditorHorizontalRuleTheme.fromJson(
+                    root.optJSONObject("horizontalRule")
+                ),
+                mentions = EditorMentionTheme.fromJson(root.optJSONObject("mentions")),
+                links = EditorLinkTheme.fromJson(root.optJSONObject("links")),
+                toolbar = EditorToolbarTheme.fromJson(root.optJSONObject("toolbar")),
+                placeholderColor = parseColor(root.optNullableString("placeholderColor")),
+                backgroundColor = parseColor(root.optNullableString("backgroundColor")),
+                borderRadius = root.optNullableFloat("borderRadius"),
+                contentInsets = EditorContentInsets.fromJson(root.optJSONObject("contentInsets"))
+            )
+        }
+    }
+
+    fun effectiveTextStyle(nodeType: String, inBlockquote: Boolean = false): EditorTextStyle {
+        styleSheet?.let {
+            return it.resolveText(nodeType, if (inBlockquote) listOf("blockquote") else emptyList())
+        }
+        var style = text ?: EditorTextStyle()
+        style = style.mergedWith(if (inBlockquote) blockquote?.text else null)
+        if (nodeType == "paragraph") {
+            style = style.mergedWith(paragraph)
+            if (paragraph?.lineHeight == null) {
+                style = style.copy(lineHeight = null)
+            }
+        }
+        if (nodeType == "codeBlock") {
+            style = style.mergedWith(codeBlock?.text)
+        }
+        style = style.mergedWith(headings[nodeType])
+        return style
+    }
+}
+
+internal fun parseColor(raw: String?): Int? {
+    val value = raw?.trim()?.lowercase() ?: return null
+    if (value.isEmpty()) return null
+
+    when (value) {
+        "clear", "transparent" -> return Color.TRANSPARENT
+    }
+
+    parseCssHexColor(value)?.let { return it }
+
+    try {
+        return Color.parseColor(value)
+    } catch (_: IllegalArgumentException) {
+    }
+
+    return when {
+        value.startsWith("rgb(") && value.endsWith(")") -> {
+            val parts = value.removePrefix("rgb(").removeSuffix(")")
+                .split(',')
+                .map { it.trim() }
+            if (parts.size != 3) return null
+            val red = parts[0].toDoubleOrNull() ?: return null
+            val green = parts[1].toDoubleOrNull() ?: return null
+            val blue = parts[2].toDoubleOrNull() ?: return null
+            Color.argb(255, red.toInt(), green.toInt(), blue.toInt())
+        }
+
+        value.startsWith("rgba(") && value.endsWith(")") -> {
+            val parts = value.removePrefix("rgba(").removeSuffix(")")
+                .split(',')
+                .map { it.trim() }
+            if (parts.size != 4) return null
+            val red = parts[0].toDoubleOrNull() ?: return null
+            val green = parts[1].toDoubleOrNull() ?: return null
+            val blue = parts[2].toDoubleOrNull() ?: return null
+            val alpha = parts[3].toDoubleOrNull() ?: return null
+            Color.argb((alpha * 255f).toInt(), red.toInt(), green.toInt(), blue.toInt())
+        }
+
+        else -> null
+    }
+}
+
+private fun parseCssHexColor(value: String): Int? {
+    if (!value.startsWith("#")) return null
+    val hex = value.removePrefix("#")
+
+    return when (hex.length) {
+        3 -> {
+            val red = "${hex[0]}${hex[0]}".toIntOrNull(16) ?: return null
+            val green = "${hex[1]}${hex[1]}".toIntOrNull(16) ?: return null
+            val blue = "${hex[2]}${hex[2]}".toIntOrNull(16) ?: return null
+            Color.argb(255, red, green, blue)
+        }
+
+        4 -> {
+            val red = "${hex[0]}${hex[0]}".toIntOrNull(16) ?: return null
+            val green = "${hex[1]}${hex[1]}".toIntOrNull(16) ?: return null
+            val blue = "${hex[2]}${hex[2]}".toIntOrNull(16) ?: return null
+            val alpha = "${hex[3]}${hex[3]}".toIntOrNull(16) ?: return null
+            Color.argb(alpha, red, green, blue)
+        }
+
+        6 -> {
+            val red = hex.substring(0, 2).toIntOrNull(16) ?: return null
+            val green = hex.substring(2, 4).toIntOrNull(16) ?: return null
+            val blue = hex.substring(4, 6).toIntOrNull(16) ?: return null
+            Color.argb(255, red, green, blue)
+        }
+
+        8 -> {
+            val red = hex.substring(0, 2).toIntOrNull(16) ?: return null
+            val green = hex.substring(2, 4).toIntOrNull(16) ?: return null
+            val blue = hex.substring(4, 6).toIntOrNull(16) ?: return null
+            val alpha = hex.substring(6, 8).toIntOrNull(16) ?: return null
+            Color.argb(alpha, red, green, blue)
+        }
+
+        else -> null
+    }
+}
+
+internal fun JSONObject.optNullableString(key: String): String? {
+    if (!has(key) || isNull(key)) return null
+    return optString(key).takeUnless { it == "null" }
+}
+
+internal fun JSONObject.optNullableFloat(key: String): Float? {
+    if (!has(key) || isNull(key)) return null
+    return optDouble(key).takeIf { !it.isNaN() }?.toFloat()
+}