@apexnative/navigation 0.0.0-stage → 1.0.0-alpha.1

package/android/src/main/java/dev/apexnative/navigation/options/ScrollEdgeEffectOptions.kt

@@ -0,0 +1,98 @@
+package dev.apexnative.navigation.options
+
+import com.facebook.react.bridge.ReadableMap
+import dev.apexnative.navigation.options.params.Bool
+import dev.apexnative.navigation.options.params.NullBool
+import dev.apexnative.navigation.options.params.NullText
+import dev.apexnative.navigation.options.params.Text
+import dev.apexnative.navigation.options.parsers.BoolParser
+import dev.apexnative.navigation.options.parsers.TextParser
+
+/**
+ * `scrollEdgeEffect.top`, `bottom`, `left`, `right` (`OptionsScrollEdge`): one edge of a scrolling view, whether its
+ * effect is hidden and how it looks.
+ */
+class ScrollEdgeOptions {
+    @JvmField var hidden: Bool = NullBool()
+    @JvmField var style: Text = NullText()
+
+    fun hasValue(): Boolean = hidden.hasValue() || style.hasValue()
+
+    fun mergeWith(other: ScrollEdgeOptions) {
+        if (other.hidden.hasValue()) hidden = other.hidden
+        if (other.style.hasValue()) style = other.style
+    }
+
+    fun mergeWithDefault(defaults: ScrollEdgeOptions) {
+        if (!hidden.hasValue()) hidden = defaults.hidden
+        if (!style.hasValue()) style = defaults.style
+    }
+
+    fun copy() = ScrollEdgeOptions().also { it.mergeWith(this) }
+
+    companion object {
+        private val STYLES = setOf("automatic", "soft", "hard")
+
+        @JvmStatic
+        fun parse(map: ReadableMap?): ScrollEdgeOptions {
+            val options = ScrollEdgeOptions()
+            if (map == null) return options
+            options.hidden = BoolParser.parse(map, "hidden")
+            options.style = TextParser.parse(map, "style", STYLES)
+            return options
+        }
+    }
+}
+
+/**
+ * `scrollEdgeEffect` (`OptionsScrollEdgeEffect`): the effect at the edges of the scrolling views of a screen, for
+ * all four edges and for each on its own.
+ */
+class ScrollEdgeEffectOptions {
+    @JvmField var hidden: Bool = NullBool()
+    @JvmField var style: Text = NullText()
+    @JvmField var top = ScrollEdgeOptions()
+    @JvmField var bottom = ScrollEdgeOptions()
+    @JvmField var left = ScrollEdgeOptions()
+    @JvmField var right = ScrollEdgeOptions()
+
+    fun hasValue(): Boolean = hidden.hasValue() || style.hasValue() || top.hasValue() || bottom.hasValue() ||
+        left.hasValue() || right.hasValue()
+
+    fun mergeWith(other: ScrollEdgeEffectOptions) {
+        if (other.hidden.hasValue()) hidden = other.hidden
+        if (other.style.hasValue()) style = other.style
+        top.mergeWith(other.top)
+        bottom.mergeWith(other.bottom)
+        left.mergeWith(other.left)
+        right.mergeWith(other.right)
+    }
+
+    fun mergeWithDefault(defaults: ScrollEdgeEffectOptions) {
+        if (!hidden.hasValue()) hidden = defaults.hidden
+        if (!style.hasValue()) style = defaults.style
+        top.mergeWithDefault(defaults.top)
+        bottom.mergeWithDefault(defaults.bottom)
+        left.mergeWithDefault(defaults.left)
+        right.mergeWithDefault(defaults.right)
+    }
+
+    fun copy() = ScrollEdgeEffectOptions().also { it.mergeWith(this) }
+
+    companion object {
+        private val STYLES = setOf("automatic", "soft", "hard")
+
+        @JvmStatic
+        fun parse(map: ReadableMap?): ScrollEdgeEffectOptions {
+            val options = ScrollEdgeEffectOptions()
+            if (map == null) return options
+            options.hidden = BoolParser.parse(map, "hidden")
+            options.style = TextParser.parse(map, "style", STYLES)
+            options.top = map.group("top") { ScrollEdgeOptions.parse(it) }
+            options.bottom = map.group("bottom") { ScrollEdgeOptions.parse(it) }
+            options.left = map.group("left") { ScrollEdgeOptions.parse(it) }
+            options.right = map.group("right") { ScrollEdgeOptions.parse(it) }
+            return options
+        }
+    }
+}

package/android/src/main/java/dev/apexnative/navigation/options/SearchBarOptions.kt

@@ -0,0 +1,151 @@
+package dev.apexnative.navigation.options
+
+import android.content.Context
+import com.facebook.react.bridge.ReadableArray
+import com.facebook.react.bridge.ReadableMap
+import dev.apexnative.navigation.options.params.Bool
+import dev.apexnative.navigation.options.params.NullBool
+import dev.apexnative.navigation.options.params.NullText
+import dev.apexnative.navigation.options.params.NullThemeColour
+import dev.apexnative.navigation.options.params.Text
+import dev.apexnative.navigation.options.params.ThemeColour
+import dev.apexnative.navigation.options.parsers.BoolParser
+import dev.apexnative.navigation.options.parsers.IconParser
+import dev.apexnative.navigation.options.parsers.TextParser
+
+/** A segment of the scope row: chips under the search field; [testID] is the identifier tests find it by. */
+data class SearchBarScope(val id: String, val title: String, val testID: String? = null)
+
+/**
+ * A row of the suggestions under the search field; a pick sends navigationButtonPressed with its id. [testID] is the
+ * identifier tests find it by.
+ */
+data class SearchBarSuggestion(val id: String, val title: String, val icon: Text, val testID: String? = null)
+
+/**
+ * `topBar.searchBar`: the search of the screen, in its top bar. In mergeOptions only the given fields change; a list
+ * given replaces the one before, an empty one removes it.
+ */
+class SearchBarOptions {
+    @JvmField var visible: Bool = NullBool()
+    @JvmField var focus: Bool = NullBool()
+    @JvmField var hideOnScroll: Bool = NullBool()
+    @JvmField var hideTopBarOnFocus: Bool = NullBool()
+    @JvmField var obscuresBackgroundDuringPresentation: Bool = NullBool()
+    @JvmField var backgroundColor: ThemeColour = NullThemeColour()
+    @JvmField var tintColor: ThemeColour = NullThemeColour()
+    @JvmField var placeholder: Text = NullText()
+    @JvmField var text: Text = NullText()
+    @JvmField var placement: Text = NullText()
+    @JvmField var scopes: List<SearchBarScope>? = null
+    @JvmField var selectedScope: Text = NullText()
+    @JvmField var scopeBarActivation: Text = NullText()
+    @JvmField var suggestions: List<SearchBarSuggestion>? = null
+    @JvmField var resultsComponent: ComponentOptions = ComponentOptions()
+    @JvmField var resultsActivation: Text = NullText()
+    @JvmField var testID: Text = NullText()
+
+    /** `integrated`, `integratedButton` and `integratedCentered`: a magnifier in the bar instead of a field. */
+    val isIntegrated: Boolean
+        get() = placement.get("stacked").startsWith("integrated")
+
+    val hasResultsComponent: Boolean
+        get() = resultsComponent.name.hasValue()
+
+    fun mergeWith(other: SearchBarOptions) {
+        if (other.visible.hasValue()) visible = other.visible
+        if (other.focus.hasValue()) focus = other.focus
+        if (other.hideOnScroll.hasValue()) hideOnScroll = other.hideOnScroll
+        if (other.hideTopBarOnFocus.hasValue()) hideTopBarOnFocus = other.hideTopBarOnFocus
+        if (other.obscuresBackgroundDuringPresentation.hasValue())
+            obscuresBackgroundDuringPresentation = other.obscuresBackgroundDuringPresentation
+        backgroundColor = backgroundColor.mergeWith(other.backgroundColor)
+        tintColor = tintColor.mergeWith(other.tintColor)
+        if (other.placeholder.hasValue()) placeholder = other.placeholder
+        if (other.text.hasValue()) text = other.text
+        if (other.placement.hasValue()) placement = other.placement
+        other.scopes?.let { scopes = it }
+        if (other.selectedScope.hasValue()) selectedScope = other.selectedScope
+        if (other.scopeBarActivation.hasValue()) scopeBarActivation = other.scopeBarActivation
+        other.suggestions?.let { suggestions = it }
+        if (other.resultsComponent.hasValue()) resultsComponent = other.resultsComponent
+        if (other.resultsActivation.hasValue()) resultsActivation = other.resultsActivation
+        if (other.testID.hasValue()) testID = other.testID
+    }
+
+    fun mergeWithDefault(defaults: SearchBarOptions) {
+        if (!visible.hasValue()) visible = defaults.visible
+        if (!focus.hasValue()) focus = defaults.focus
+        if (!hideOnScroll.hasValue()) hideOnScroll = defaults.hideOnScroll
+        if (!hideTopBarOnFocus.hasValue()) hideTopBarOnFocus = defaults.hideTopBarOnFocus
+        if (!obscuresBackgroundDuringPresentation.hasValue())
+            obscuresBackgroundDuringPresentation = defaults.obscuresBackgroundDuringPresentation
+        backgroundColor = backgroundColor.withDefault(defaults.backgroundColor)
+        tintColor = tintColor.withDefault(defaults.tintColor)
+        if (!placeholder.hasValue()) placeholder = defaults.placeholder
+        if (!text.hasValue()) text = defaults.text
+        if (!placement.hasValue()) placement = defaults.placement
+        if (scopes == null) scopes = defaults.scopes
+        if (!selectedScope.hasValue()) selectedScope = defaults.selectedScope
+        if (!scopeBarActivation.hasValue()) scopeBarActivation = defaults.scopeBarActivation
+        if (suggestions == null) suggestions = defaults.suggestions
+        if (!resultsComponent.hasValue()) resultsComponent = defaults.resultsComponent
+        if (!resultsActivation.hasValue()) resultsActivation = defaults.resultsActivation
+        if (!testID.hasValue()) testID = defaults.testID
+    }
+
+    companion object {
+        private val PLACEMENTS =
+            setOf("stacked", "automatic", "integrated", "integratedButton", "integratedCentered")
+        private val SCOPE_BAR_ACTIVATIONS = setOf("automatic", "onTextEntry", "onSearchActivation")
+        private val RESULTS_ACTIVATIONS = setOf("onSearchActivation", "onTextEntry")
+
+        @JvmStatic
+        fun parse(context: Context?, json: ReadableMap?): SearchBarOptions {
+            val options = SearchBarOptions()
+            if (json == null) return options
+            options.visible = BoolParser.parse(json, "visible")
+            options.focus = BoolParser.parse(json, "focus")
+            options.hideOnScroll = BoolParser.parse(json, "hideOnScroll")
+            options.hideTopBarOnFocus = BoolParser.parse(json, "hideTopBarOnFocus")
+            options.obscuresBackgroundDuringPresentation =
+                BoolParser.parse(json, "obscuresBackgroundDuringPresentation")
+            options.backgroundColor = ThemeColour.parse(context, json, "backgroundColor")
+            options.tintColor = ThemeColour.parse(context, json, "tintColor")
+            options.placeholder = TextParser.parse(json, "placeholder")
+            options.text = TextParser.parse(json, "text")
+            options.placement = TextParser.parse(json, "placement", PLACEMENTS)
+            options.scopes = json.optArray("scopes")?.let { parseScopes(it) }
+            options.selectedScope = TextParser.parse(json, "selectedScope")
+            options.scopeBarActivation = TextParser.parse(json, "scopeBarActivation", SCOPE_BAR_ACTIVATIONS)
+            options.suggestions = json.optArray("suggestions")?.let { parseSuggestions(it) }
+            options.resultsComponent = ComponentOptions.parse(json.optMap("resultsComponent"))
+            options.resultsActivation = TextParser.parse(json, "resultsActivation", RESULTS_ACTIVATIONS)
+            options.testID = TextParser.parse(json, "testID")
+            return options
+        }
+
+        private fun ReadableMap.testIDOrNull(): String? = optString("testID").takeIf { it.isNotEmpty() }
+
+        private fun parseScopes(array: ReadableArray): List<SearchBarScope> =
+            (0 until array.size()).mapNotNull { index ->
+                array.optMap(index)?.let { item ->
+                    val id = item.optString("id")
+                    if (id.isEmpty()) null else SearchBarScope(id, item.optString("title", id), item.testIDOrNull())
+                }
+            }
+
+        private fun parseSuggestions(array: ReadableArray): List<SearchBarSuggestion> =
+            (0 until array.size()).mapNotNull { index ->
+                array.optMap(index)?.let { item ->
+                    val id = item.optString("id")
+                    if (id.isEmpty()) {
+                        null
+                    } else {
+                        val title = item.optString("title", id)
+                        SearchBarSuggestion(id, title, IconParser.parse(item, "icon"), item.testIDOrNull())
+                    }
+                }
+            }
+    }
+}

package/android/src/main/java/dev/apexnative/navigation/options/SharedElementTransitionOptions.kt

@@ -0,0 +1,57 @@
+package dev.apexnative.navigation.options
+
+import com.facebook.react.bridge.ReadableMap
+import dev.apexnative.navigation.options.params.Fraction
+import dev.apexnative.navigation.options.params.NullFraction
+import dev.apexnative.navigation.options.params.NullText
+import dev.apexnative.navigation.options.params.Text
+import dev.apexnative.navigation.options.parsers.FractionParser
+import dev.apexnative.navigation.options.parsers.TextParser
+
+/**
+ * A shared element of a push or a pop: the view with `nativeID` [fromId] on the screen that goes moves to the place of
+ * [toId] on the screen that comes, in `duration` ms after `startDelay` ms, along `interpolation`.
+ */
+class SharedElementTransitionOptions(
+    @JvmField var fromId: Text = NullText(),
+    @JvmField var toId: Text = NullText(),
+) {
+    @JvmField var duration: Fraction = NullFraction()
+    @JvmField var startDelay: Fraction = NullFraction()
+    @JvmField var interpolation = InterpolationOptions()
+
+    fun hasValue(): Boolean = fromId.hasValue() || toId.hasValue() || duration.hasValue() || startDelay.hasValue() ||
+        interpolation.hasValue()
+
+    fun mergeWith(other: SharedElementTransitionOptions) {
+        if (other.fromId.hasValue()) fromId = other.fromId
+        if (other.toId.hasValue()) toId = other.toId
+        if (other.duration.hasValue()) duration = other.duration
+        if (other.startDelay.hasValue()) startDelay = other.startDelay
+        interpolation.mergeWith(other.interpolation)
+    }
+
+    fun mergeWithDefault(defaults: SharedElementTransitionOptions) {
+        if (!fromId.hasValue()) fromId = defaults.fromId
+        if (!toId.hasValue()) toId = defaults.toId
+        if (!duration.hasValue()) duration = defaults.duration
+        if (!startDelay.hasValue()) startDelay = defaults.startDelay
+        interpolation.mergeWithDefault(defaults.interpolation)
+    }
+
+    fun copy() = SharedElementTransitionOptions().also { it.mergeWith(this) }
+
+    companion object {
+        @JvmStatic
+        fun parse(map: ReadableMap?): SharedElementTransitionOptions {
+            val options = SharedElementTransitionOptions()
+            if (map == null) return options
+            options.fromId = TextParser.parse(map, "fromId")
+            options.toId = TextParser.parse(map, "toId")
+            options.duration = FractionParser.parseDuration(map, "duration")
+            options.startDelay = FractionParser.parseDuration(map, "startDelay")
+            options.interpolation = map.group("interpolation") { InterpolationOptions.parse(it) }
+            return options
+        }
+    }
+}

package/android/src/main/java/dev/apexnative/navigation/options/SheetOptions.kt

@@ -0,0 +1,108 @@
+package dev.apexnative.navigation.options
+
+import com.facebook.react.bridge.ReadableMap
+import dev.apexnative.navigation.options.params.Bool
+import dev.apexnative.navigation.options.params.Fraction
+import dev.apexnative.navigation.options.params.NullBool
+import dev.apexnative.navigation.options.params.NullFraction
+import dev.apexnative.navigation.options.params.NullText
+import dev.apexnative.navigation.options.params.Text
+import dev.apexnative.navigation.options.parsers.BoolParser
+import dev.apexnative.navigation.options.parsers.FractionParser
+import dev.apexnative.navigation.options.parsers.TextParser
+
+/**
+ * A height a sheet stops at: about half the screen, the full height, or a height in dp. `content` stops at half the
+ * screen on Android: the Material sheet has no height of its content.
+ */
+sealed class SheetDetent {
+    object Medium : SheetDetent()
+    object Large : SheetDetent()
+    data class Height(val dp: Double) : SheetDetent()
+
+    /** The detent as the app names it, in `sheetDetentChanged`. */
+    fun toValue(): Any = when (this) {
+        Medium -> "medium"
+        Large -> "large"
+        is Height -> dp
+    }
+
+    companion object {
+        fun parse(value: Any?): SheetDetent? = when (value) {
+            "medium", "content" -> Medium
+            "large" -> Large
+            // A number is a height only when it is finite and positive.
+            is Number -> value.toDouble().takeIf { it.isFinite() && it > 0 }?.let { Height(it) }
+            else -> null
+        }
+    }
+}
+
+/**
+ * `modal.sheet`: a modal shown as a Material bottom sheet, its detents and its look. In mergeOptions only the given
+ * fields change; `largestUndimmedDetent: null` dims at every detent again.
+ */
+class SheetOptions {
+    @JvmField var detents: List<SheetDetent>? = null
+    @JvmField var selectedDetent: SheetDetent? = null
+    @JvmField var largestUndimmedDetent: SheetDetent? = null
+    /** The options give `largestUndimmedDetent`, `null` included. */
+    @JvmField var hasLargestUndimmedDetent = false
+    @JvmField var grabber: Bool = NullBool()
+    @JvmField var expandsOnScroll: Bool = NullBool()
+    @JvmField var cornerRadius: Fraction = NullFraction()
+    @JvmField var testID: Text = NullText()
+
+    /** The options give the sheet: the modal shows as one. */
+    val hasValue: Boolean
+        get() = detents != null || selectedDetent != null || hasLargestUndimmedDetent || grabber.hasValue() ||
+            expandsOnScroll.hasValue() || cornerRadius.hasValue() ||
+            testID.hasValue()
+
+    fun mergeWith(other: SheetOptions) {
+        other.detents?.let { detents = it }
+        other.selectedDetent?.let { selectedDetent = it }
+        if (other.hasLargestUndimmedDetent) {
+            largestUndimmedDetent = other.largestUndimmedDetent
+            hasLargestUndimmedDetent = true
+        }
+        if (other.grabber.hasValue()) grabber = other.grabber
+        if (other.expandsOnScroll.hasValue()) expandsOnScroll = other.expandsOnScroll
+        if (other.cornerRadius.hasValue()) cornerRadius = other.cornerRadius
+        if (other.testID.hasValue()) testID = other.testID
+    }
+
+    fun mergeWithDefault(defaults: SheetOptions) {
+        if (detents == null) detents = defaults.detents
+        if (selectedDetent == null) selectedDetent = defaults.selectedDetent
+        if (!hasLargestUndimmedDetent && defaults.hasLargestUndimmedDetent) {
+            largestUndimmedDetent = defaults.largestUndimmedDetent
+            hasLargestUndimmedDetent = true
+        }
+        if (!grabber.hasValue()) grabber = defaults.grabber
+        if (!expandsOnScroll.hasValue()) expandsOnScroll = defaults.expandsOnScroll
+        if (!cornerRadius.hasValue()) cornerRadius = defaults.cornerRadius
+        if (!testID.hasValue()) testID = defaults.testID
+    }
+
+    companion object {
+        @JvmStatic
+        fun parse(json: ReadableMap?): SheetOptions {
+            val options = SheetOptions()
+            if (json == null) return options
+            json.optArray("detents")?.let { array ->
+                options.detents = (0 until array.size()).mapNotNull { SheetDetent.parse(array.opt(it)) }.distinct()
+            }
+            options.selectedDetent = SheetDetent.parse(json.opt("selectedDetent"))
+            if (json.has("largestUndimmedDetent")) {
+                options.hasLargestUndimmedDetent = true
+                options.largestUndimmedDetent = SheetDetent.parse(json.opt("largestUndimmedDetent"))
+            }
+            options.grabber = BoolParser.parse(json, "grabber")
+            options.expandsOnScroll = BoolParser.parse(json, "expandsOnScroll")
+            options.cornerRadius = FractionParser.parse(json, "cornerRadius")
+            options.testID = TextParser.parse(json, "testID")
+            return options
+        }
+    }
+}

package/android/src/main/java/dev/apexnative/navigation/options/SideMenuOptions.kt

@@ -0,0 +1,130 @@
+package dev.apexnative.navigation.options
+
+import com.facebook.react.bridge.ReadableMap
+import dev.apexnative.navigation.options.params.Bool
+import dev.apexnative.navigation.options.params.Fraction
+import dev.apexnative.navigation.options.params.NullBool
+import dev.apexnative.navigation.options.params.NullFraction
+import dev.apexnative.navigation.options.params.NullText
+import dev.apexnative.navigation.options.params.Text
+import dev.apexnative.navigation.options.parsers.BoolParser
+import dev.apexnative.navigation.options.parsers.FractionParser
+import dev.apexnative.navigation.options.parsers.TextParser
+
+/**
+ * `sideMenu`: the sides of a side menu and how they open. `left.visible` and `right.visible` act once and are never
+ * kept in a node's own options.
+ */
+class SideMenuOptions {
+    @JvmField var left = SideMenuSideOptions()
+    @JvmField var right = SideMenuSideOptions()
+    @JvmField var openGestureMode: Text = NullText()
+    @JvmField var animationType: Text = NullText()
+    @JvmField var testID: Text = NullText()
+
+    fun hasValue(): Boolean = left.hasValue() || right.hasValue() || openGestureMode.hasValue() ||
+        animationType.hasValue() || testID.hasValue()
+
+    fun mergeWith(other: SideMenuOptions) {
+        left.mergeWith(other.left)
+        right.mergeWith(other.right)
+        if (other.openGestureMode.hasValue()) openGestureMode = other.openGestureMode
+        if (other.animationType.hasValue()) animationType = other.animationType
+        if (other.testID.hasValue()) testID = other.testID
+    }
+
+    fun mergeWithDefault(defaults: SideMenuOptions) {
+        left.mergeWithDefault(defaults.left)
+        right.mergeWithDefault(defaults.right)
+        if (!openGestureMode.hasValue()) openGestureMode = defaults.openGestureMode
+        if (!animationType.hasValue()) animationType = defaults.animationType
+        if (!testID.hasValue()) testID = defaults.testID
+    }
+
+    fun copy() = SideMenuOptions().also { it.mergeWith(this) }
+
+    companion object {
+        private val OPEN_GESTURE_MODES = setOf("bezel", "entireScreen")
+        private val ANIMATION_TYPES = setOf("parallax", "slide", "slide-and-scale", "door")
+
+        @JvmStatic
+        fun parse(map: ReadableMap?): SideMenuOptions {
+            val options = SideMenuOptions()
+            if (map == null) return options
+            options.left = map.group("left") { SideMenuSideOptions.parse(it) }
+            options.right = map.group("right") { SideMenuSideOptions.parse(it) }
+            options.openGestureMode = TextParser.parse(map, "openGestureMode", OPEN_GESTURE_MODES)
+            options.animationType = TextParser.parse(map, "animationType", ANIMATION_TYPES)
+            options.testID = TextParser.parse(map, "testID")
+            return options
+        }
+    }
+}
+
+/** `sideMenu.left`, `sideMenu.right`: one side of a side menu. */
+class SideMenuSideOptions {
+    /** Opens or closes the side once: never kept in a node's own options. */
+    @JvmField var visible: Bool = NullBool()
+    @JvmField var animate: Bool = NullBool()
+    @JvmField var enabled: Bool = NullBool()
+    @JvmField var width: Fraction = NullFraction()
+    @JvmField var height: Fraction = NullFraction()
+    @JvmField var shouldStretchDrawer: Bool = NullBool()
+    @JvmField var animationVelocity: Fraction = NullFraction()
+    @JvmField var openMode: Text = NullText()
+    @JvmField var glass: Bool = NullBool()
+    @JvmField var testID: Text = NullText()
+
+    fun hasValue(): Boolean = visible.hasValue() || animate.hasValue() || enabled.hasValue() || width.hasValue() ||
+        height.hasValue() || shouldStretchDrawer.hasValue() || animationVelocity.hasValue() || openMode.hasValue() ||
+        glass.hasValue() || testID.hasValue()
+
+    fun mergeWith(other: SideMenuSideOptions) {
+        if (other.visible.hasValue()) visible = other.visible
+        if (other.animate.hasValue()) animate = other.animate
+        if (other.enabled.hasValue()) enabled = other.enabled
+        if (other.width.hasValue()) width = other.width
+        if (other.height.hasValue()) height = other.height
+        if (other.shouldStretchDrawer.hasValue()) shouldStretchDrawer = other.shouldStretchDrawer
+        if (other.animationVelocity.hasValue()) animationVelocity = other.animationVelocity
+        if (other.openMode.hasValue()) openMode = other.openMode
+        if (other.glass.hasValue()) glass = other.glass
+        if (other.testID.hasValue()) testID = other.testID
+    }
+
+    fun mergeWithDefault(defaults: SideMenuSideOptions) {
+        if (!visible.hasValue()) visible = defaults.visible
+        if (!animate.hasValue()) animate = defaults.animate
+        if (!enabled.hasValue()) enabled = defaults.enabled
+        if (!width.hasValue()) width = defaults.width
+        if (!height.hasValue()) height = defaults.height
+        if (!shouldStretchDrawer.hasValue()) shouldStretchDrawer = defaults.shouldStretchDrawer
+        if (!animationVelocity.hasValue()) animationVelocity = defaults.animationVelocity
+        if (!openMode.hasValue()) openMode = defaults.openMode
+        if (!glass.hasValue()) glass = defaults.glass
+        if (!testID.hasValue()) testID = defaults.testID
+    }
+
+    fun copy() = SideMenuSideOptions().also { it.mergeWith(this) }
+
+    companion object {
+        private val OPEN_MODES = setOf("aboveContent", "pushContent")
+
+        @JvmStatic
+        fun parse(map: ReadableMap?): SideMenuSideOptions {
+            val options = SideMenuSideOptions()
+            if (map == null) return options
+            options.visible = BoolParser.parse(map, "visible")
+            options.animate = BoolParser.parse(map, "animate")
+            options.enabled = BoolParser.parse(map, "enabled")
+            options.width = FractionParser.parse(map, "width")
+            options.height = FractionParser.parse(map, "height")
+            options.shouldStretchDrawer = BoolParser.parse(map, "shouldStretchDrawer")
+            options.animationVelocity = FractionParser.parse(map, "animationVelocity")
+            options.openMode = TextParser.parse(map, "openMode", OPEN_MODES)
+            options.glass = BoolParser.parse(map, "glass")
+            options.testID = TextParser.parse(map, "testID")
+            return options
+        }
+    }
+}