@mapvina-com/mapvina-react-native 1.0.0

package/LICENSE.md

@@ -0,0 +1,9 @@
+Copyright (c) 2022 MapLibre contributors
+
+Copyright (c) 2015-2020 Mapbox
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/MapVinaReactNative.podspec

@@ -0,0 +1,96 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+# Global Variable Defaults
+# $MLRN_NATIVE_VERSION matches the distribution repo tag (kept at 1.0.0 for consistency
+# with mapvina-gl-native-distribution). The distribution now resolves the native
+# xcframework via a LOCAL binaryTarget `path:` (offline), so no network release/checksum
+# is required to resolve the SPM dependency.
+#
+# Local dev option: to consume the distribution from a local checkout instead of the
+# remote repo, set $MLRN_SPM_SPEC before requiring this podspec, e.g.
+#   $MLRN_SPM_SPEC = { path: "<absolute-or-relative-path>/mapvina-gl-native-distribution",
+#                      product_name: "MapVina" }
+$MLRN_NATIVE_VERSION ||= "1.0.0"
+$MLRN_SPM_SPEC ||= {
+  url: "https://github.com/mapvina/mapvina-gl-native-distribution",
+  requirement: {
+    kind: "exactVersion",
+    version: $MLRN_NATIVE_VERSION
+  },
+  product_name: "MapVina"
+}
+
+$MLRN = Object.new
+
+def $MLRN._add_spm_to_target(project, target, url, requirement, product_name)
+  pkg_class = Xcodeproj::Project::Object::XCRemoteSwiftPackageReference
+  ref_class = Xcodeproj::Project::Object::XCSwiftPackageProductDependency
+  pkg = project.root_object.package_references.find { |p| p.class == pkg_class && p.repositoryURL == url }
+  if !pkg
+    pkg = project.new(pkg_class)
+    pkg.repositoryURL = url
+    project.root_object.package_references << pkg
+  end
+  pkg.requirement = requirement
+  ref = target.package_product_dependencies.find { |r| r.class == ref_class && r.package == pkg && r.product_name == product_name }
+  if !ref
+    ref = project.new(ref_class)
+    ref.package = pkg
+    ref.product_name = product_name
+    target.package_product_dependencies << ref
+  end
+end
+
+def $MLRN.post_install(installer)
+  spm_spec = $MLRN_SPM_SPEC
+
+  project = installer.pods_project
+  mlrn_target = project.targets.find { |t| t.name == "MapVinaReactNative" }
+  self._add_spm_to_target(
+    project,
+    mlrn_target,
+    spm_spec[:url],
+    spm_spec[:requirement],
+    spm_spec[:product_name]
+  )
+
+  installer.aggregate_targets.group_by(&:user_project).each do |project, targets|
+    targets.each do |target|
+      target.user_targets.each do |user_target|
+        self._add_spm_to_target(
+          project,
+          user_target,
+          spm_spec[:url],
+          spm_spec[:requirement],
+          spm_spec[:product_name]
+        )
+
+        phase_name = "[MapVina React Native] Remove MapVina.xcframework-ios.signature"
+        unless user_target.shell_script_build_phases.any? { |p| p.name == phase_name }
+          phase = user_target.new_shell_script_build_phase(phase_name)
+          phase.shell_script = 'rm -rf "$CONFIGURATION_BUILD_DIR/MapVina.xcframework-ios.signature"'
+          phase.always_out_of_date = "1"
+        end
+      end
+    end
+  end
+end
+
+Pod::Spec.new do |s|
+  s.name         = "MapVinaReactNative"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => min_ios_version_supported }
+  s.source       = { :git => "https://github.com/mapvina/mapvina-react-native.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm,cpp}"
+  s.private_header_files = "ios/**/*.h"
+
+ install_modules_dependencies(s)
+end

package/README.md

@@ -0,0 +1,47 @@
+<p align="center">
+  <a href="https://mapvina.com">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://avatars.githubusercontent.com/u/282217237?s=400&u=edd583b269cdb491b5775bdf10978cde217b841e&v=4">
+      <source media="(prefers-color-scheme: light)" srcset="https://avatars.githubusercontent.com/u/282217237?s=400&u=edd583b269cdb491b5775bdf10978cde217b841e&v=4">
+      <img alt="MapVina Logo" src="https://avatars.githubusercontent.com/u/282217237?s=400&u=edd583b269cdb491b5775bdf10978cde217b841e&v=4" width="200">
+    </picture>
+  </a>
+</p>
+
+# MapVina React Native
+
+[![License](https://img.shields.io/badge/License-MIT-blue.svg)](/LICENSE.md)
+[![Version](https://img.shields.io/npm/v/@mapvina/mapvina-react-native)](https://www.npmjs.com/package/@mapvina/mapvina-react-native)
+[![Actions](https://img.shields.io/github/actions/workflow/status/mapvina/mapvina-react-native/release.yml?label=Actions&branch=main)](https://github.io/github/mapvina/mapvina-react-native/actions/workflows/release.yml?query=branch:main)
+
+_React Native library for creating maps
+with [MapVina Native for Android & iOS](https://github.io/github/mapvina/mapvina-gl-native)._
+
+This project originated as a fork of [rnmapbox](https://github.com/rnmapbox/maps), a community-maintained
+React Native library for building maps with the Mapbox iOS and Android mobile SDKs. The original library
+supported both Mapbox and MapVina for some time, but as the MapVina and Mapbox SDKs have
+diverged, it has become necessary to separate the projects into specific wrappers by underlying renderer.
+
+<p align="center">
+    <img src="/docs/static/screenshots/index/device-android.png"
+         alt="Indoor Building Map Android"
+         height="320"
+          />
+    <img src="/docs/static/screenshots/index/device-ios.png"
+         alt="Indoor Building Map iOS"
+         height="320"
+          />
+</p>
+
+## Documentation
+
+https://mapvina.io/github/mapvina-react-native/
+
+## Contributing & Development
+
+Read the [CONTRIBUTING](/CONTRIBUTING.md) guide in order to get familiar with how we do things around here and
+set up your local development environment.
+
+## Community
+
+Join the [`#mapvina-react-native`](https://osmus.slack.com/archives/C065DB4T2UB) or [`#mapvina`](https://osmus.slack.com/archives/C01G3D28DAB) [on the Open Street Map Slack](https://slack.openstreetmap.us/).

package/android/build.gradle

@@ -0,0 +1,139 @@
+buildscript {
+    ext.getExtOrDefault = { name ->
+        return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties['io.github.mapvina.reactnative.' + name]
+    }
+
+    repositories {
+        mavenLocal()
+        google()
+        mavenCentral()
+    }
+
+    dependencies {
+        classpath "com.android.tools.build:gradle:8.7.2"
+        // noinspection DifferentKotlinGradleVersion
+        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
+    }
+}
+
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+
+apply plugin: "com.facebook.react"
+
+def getExtOrIntegerDefault(name) {
+    return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["io.github.mapvina.reactnative." + name]).toInteger()
+}
+
+def getConfigurableExtOrDefault(name) {
+    return rootProject.ext.has("io.github.mapvina.reactnative." + name) ? rootProject.ext.get("io.github.mapvina.reactnative." + name) : project.properties["io.github.mapvina.reactnative." + name]
+}
+
+android {
+    namespace "io.github.mapvina.reactnative"
+
+    compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
+
+    defaultConfig {
+        minSdkVersion getExtOrIntegerDefault("minSdkVersion")
+        targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
+    }
+
+    buildFeatures {
+        buildConfig true
+    }
+
+    buildTypes {
+        release {
+            minifyEnabled false
+        }
+    }
+
+    lintOptions {
+        disable "GradleCompatible"
+    }
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_1_8
+        targetCompatibility JavaVersion.VERSION_1_8
+    }
+
+    sourceSets {
+        main {
+            java.srcDirs = ['src/main/java']
+
+            if (getConfigurableExtOrDefault("locationEngine") == "default") {
+                java.srcDirs += 'src/main/location-engine-default'
+            } else if (getConfigurableExtOrDefault("locationEngine") == "google") {
+                java.srcDirs += 'src/main/location-engine-google'
+            } else {
+                throw new GradleException("io.github.mapvina.reactnative.locationEngine.locationEngine should be one of [\"default\", \"google\"]`. \"${getConfigurableExtOrDefault("locationEngine")}\" was provided.")
+            }
+
+            java.srcDirs += [
+                    "generated/java",
+                    "generated/jni"
+            ]
+        }
+    }
+}
+
+repositories {
+    mavenLocal()
+    mavenCentral()
+    google()
+}
+
+def kotlin_version = getExtOrDefault("kotlinVersion")
+
+dependencies {
+    implementation "com.facebook.react:react-android"
+    implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
+
+    // MapVina Native
+    implementation "io.github.mapvina:android-sdk-${getConfigurableExtOrDefault('nativeVariant')}:${getConfigurableExtOrDefault('nativeVersion')}"
+
+    // MapVina core dependencies (explicit to ensure Kotlin compiler classpath)
+    implementation "io.github.mapvina:android-sdk-geojson:1.0.0"
+    implementation "io.github.mapvina:mapvina-android-gestures:1.0.0"
+
+    // MapVina Plugins
+    implementation("io.github.mapvina:android-plugin-annotation-v9:${getConfigurableExtOrDefault('pluginVersion')}") {
+        exclude(group: "io.github.mapvina", module: "android-sdk")
+    }
+    implementation("io.github.mapvina:android-plugin-scalebar-v9:${getConfigurableExtOrDefault('pluginVersion')}") {
+        exclude(group: "io.github.mapvina", module: "android-sdk")
+    }
+
+    // Dependencies
+    implementation "io.github.mapvina:android-sdk-turf:${getConfigurableExtOrDefault('turfVersion')}"
+    implementation "com.squareup.okhttp3:okhttp:${getConfigurableExtOrDefault('okhttpVersion')}"
+    implementation "com.squareup.okhttp3:okhttp-urlconnection:${getConfigurableExtOrDefault('okhttpVersion')}"
+    implementation "androidx.vectordrawable:vectordrawable:1.2.0"
+    implementation "androidx.annotation:annotation:1.9.1"
+    implementation "androidx.appcompat:appcompat:1.7.1"
+
+    // Dependencies for Google Location Engine
+    if (getConfigurableExtOrDefault("locationEngine") == "google") {
+        implementation "com.google.android.gms:play-services-location:${getConfigurableExtOrDefault('googlePlayServicesLocationVersion')}"
+    }
+}
+
+react {
+    jsRootDir = file("../src/")
+    libraryName = "MapVinaReactNative"
+    codegenJavaPackageName = "io.github.mapvina.reactnative"
+}
+
+tasks.withType(org.jetbrains.kotlin.gradle.tasks.KotlinCompile).configureEach { task ->
+    task.doFirst {
+        println "=== KOTLIN_LIBS for ${task.name} ==="
+        task.libraries.files.each { f ->
+            if (f.name.contains('mapvina') || f.name.contains('geojson') || f.name.contains('gestures') || f.name.contains('annotation') || f.name.contains('scalebar') || f.name.contains('turf')) {
+                println "  ${f.name}"
+            }
+        }
+        println "=== END ==="
+    }
+}

package/android/gradle.properties

@@ -0,0 +1,16 @@
+io.github.mapvina.reactnative.kotlinVersion=2.2.10
+io.github.mapvina.reactnative.minSdkVersion=24
+io.github.mapvina.reactnative.targetSdkVersion=34
+io.github.mapvina.reactnative.compileSdkVersion=35
+io.github.mapvina.reactnative.ndkVersion=27.1.12297006
+
+# MapVina React Native
+io.github.mapvina.reactnative.nativeVersion=1.0.1
+io.github.mapvina.reactnative.nativeVariant=opengl
+io.github.mapvina.reactnative.pluginVersion=1.0.0
+io.github.mapvina.reactnative.turfVersion=1.0.0
+io.github.mapvina.reactnative.okhttpVersion=4.12.0
+# Available values: default, google
+io.github.mapvina.reactnative.locationEngine=default
+# Only applied if locationEngine=google
+io.github.mapvina.reactnative.googlePlayServicesLocationVersion=21.3.0

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,5 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <uses-permission android:name="android.permission.INTERNET" />
+    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
+    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
+</manifest>

package/android/src/main/java/io/github/mapvina/reactnative/MLRNPackage.kt

@@ -0,0 +1,163 @@
+package io.github.mapvina.reactnative
+
+import com.facebook.react.BaseReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.model.ReactModuleInfo
+import com.facebook.react.module.model.ReactModuleInfoProvider
+import com.facebook.react.uimanager.ViewManager
+import io.github.mapvina.reactnative.components.annotations.callout.MLRNCalloutManager
+import io.github.mapvina.reactnative.components.annotations.markerview.MLRNMarkerViewManager
+import io.github.mapvina.reactnative.components.annotations.pointannotation.MLRNPointAnnotationManager
+import io.github.mapvina.reactnative.components.camera.MLRNCameraManager
+import io.github.mapvina.reactnative.components.camera.MLRNCameraModule
+import io.github.mapvina.reactnative.components.images.MLRNImagesManager
+import io.github.mapvina.reactnative.components.layer.MLRNLayerManager
+import io.github.mapvina.reactnative.components.location.MLRNNativeUserLocationManager
+import io.github.mapvina.reactnative.components.mapview.MLRNAndroidTextureMapViewManager
+import io.github.mapvina.reactnative.components.mapview.MLRNMapViewManager
+import io.github.mapvina.reactnative.components.mapview.MLRNMapViewModule
+import io.github.mapvina.reactnative.components.sources.geojsonsource.MLRNGeoJSONSourceManager
+import io.github.mapvina.reactnative.components.sources.geojsonsource.MLRNGeoJSONSourceModule
+import io.github.mapvina.reactnative.components.sources.imagesource.MLRNImageSourceManager
+import io.github.mapvina.reactnative.components.sources.tilesources.rasterdemsource.MLRNRasterDEMSourceManager
+import io.github.mapvina.reactnative.components.sources.tilesources.rastersource.MLRNRasterSourceManager
+import io.github.mapvina.reactnative.components.sources.tilesources.vectorsource.MLRNVectorSourceManager
+import io.github.mapvina.reactnative.components.sources.tilesources.vectorsource.MLRNVectorSourceModule
+import io.github.mapvina.reactnative.modules.MLRNLocationModule
+import io.github.mapvina.reactnative.modules.MLRNLogModule
+import io.github.mapvina.reactnative.modules.MLRNNetworkModule
+import io.github.mapvina.reactnative.modules.MLRNOfflineModule
+import io.github.mapvina.reactnative.modules.MLRNStaticMapModule
+import io.github.mapvina.reactnative.modules.MLRNTransformRequestModule
+import io.github.mapvina.reactnative.utils.ReactTagResolver
+
+class MLRNPackage : BaseReactPackage() {
+    override fun getModule(
+        name: String,
+        reactContext: ReactApplicationContext,
+    ): NativeModule? {
+        when (name) {
+            MLRNMapViewModule.NAME -> return MLRNMapViewModule(
+                reactContext,
+                getReactTagResolver(reactContext),
+            )
+
+            MLRNCameraModule.NAME -> return MLRNCameraModule(
+                reactContext,
+                getReactTagResolver(reactContext),
+            )
+
+            MLRNGeoJSONSourceModule.NAME -> return MLRNGeoJSONSourceModule(
+                reactContext,
+                getReactTagResolver(reactContext),
+            )
+
+            MLRNVectorSourceModule.NAME -> return MLRNVectorSourceModule(
+                reactContext,
+                getReactTagResolver(reactContext),
+            )
+
+            MLRNOfflineModule.NAME -> return MLRNOfflineModule(reactContext)
+
+            MLRNStaticMapModule.NAME -> return MLRNStaticMapModule(reactContext)
+
+            MLRNLocationModule.NAME -> return MLRNLocationModule(reactContext)
+
+            MLRNLogModule.NAME -> return MLRNLogModule(reactContext)
+
+            MLRNNetworkModule.NAME -> return MLRNNetworkModule(reactContext)
+
+            MLRNTransformRequestModule.NAME -> return MLRNTransformRequestModule(reactContext)
+        }
+
+        return null
+    }
+
+    override fun getReactModuleInfoProvider(): ReactModuleInfoProvider =
+        ReactModuleInfoProvider {
+            val moduleInfos = HashMap<String, ReactModuleInfo>()
+
+            moduleInfos.put(MLRNMapViewModule.NAME,
+                ReactModuleInfo(MLRNMapViewModule.NAME, MLRNMapViewModule.NAME,
+                    false, true, false, true))
+
+            moduleInfos.put(MLRNCameraModule.NAME,
+                ReactModuleInfo(MLRNCameraModule.NAME, MLRNCameraModule.NAME,
+                    false, false, false, true))
+
+            moduleInfos.put(MLRNGeoJSONSourceModule.NAME,
+                ReactModuleInfo(MLRNGeoJSONSourceModule.NAME, MLRNGeoJSONSourceModule.NAME,
+                    false, false, false, true))
+
+            moduleInfos.put(MLRNVectorSourceModule.NAME,
+                ReactModuleInfo(MLRNVectorSourceModule.NAME, MLRNVectorSourceModule.NAME,
+                    false, false, false, true))
+
+            moduleInfos.put(MLRNOfflineModule.NAME,
+                ReactModuleInfo(MLRNOfflineModule.NAME, MLRNOfflineModule.NAME,
+                    false, false, false, true))
+
+            moduleInfos.put(MLRNStaticMapModule.NAME,
+                ReactModuleInfo(MLRNStaticMapModule.NAME, MLRNStaticMapModule.NAME,
+                    false, false, false, true))
+
+            moduleInfos.put(MLRNLocationModule.NAME,
+                ReactModuleInfo(MLRNLocationModule.NAME, MLRNLocationModule.NAME,
+                    false, false, false, true))
+
+            moduleInfos.put(MLRNLogModule.NAME,
+                ReactModuleInfo(MLRNLogModule.NAME, MLRNLogModule.NAME,
+                    false, false, false, true))
+
+            moduleInfos.put(MLRNNetworkModule.NAME,
+                ReactModuleInfo(MLRNNetworkModule.NAME, MLRNNetworkModule.NAME,
+                    false, false, false, true))
+
+            moduleInfos.put(MLRNTransformRequestModule.NAME,
+                ReactModuleInfo(MLRNTransformRequestModule.NAME, MLRNTransformRequestModule.NAME,
+                    false, false, false, true))
+
+            moduleInfos
+        }
+
+    override fun createViewManagers(reactContext: ReactApplicationContext): List<ViewManager<*, *>> {
+        val managers: MutableList<ViewManager<*, *>> = mutableListOf()
+
+        // components
+        managers.add(MLRNCameraManager(reactContext))
+        managers.add(MLRNMapViewManager(reactContext))
+        managers.add(MLRNMarkerViewManager(reactContext))
+        managers.add(MLRNAndroidTextureMapViewManager(reactContext))
+        managers.add(MLRNPointAnnotationManager(reactContext))
+        managers.add(MLRNCalloutManager())
+        managers.add(MLRNNativeUserLocationManager())
+
+        // sources
+        managers.add(MLRNImageSourceManager(reactContext))
+        managers.add(MLRNGeoJSONSourceManager(reactContext))
+        managers.add(MLRNRasterSourceManager(reactContext))
+        managers.add(MLRNRasterDEMSourceManager(reactContext))
+        managers.add(MLRNVectorSourceManager(reactContext))
+
+        // images
+        managers.add(MLRNImagesManager(reactContext))
+
+        // layers
+        managers.add(MLRNLayerManager())
+
+        return managers
+    }
+
+    private var reactTagResolver: ReactTagResolver? = null
+
+    private fun getReactTagResolver(context: ReactApplicationContext): ReactTagResolver {
+        val reactTagResolver = reactTagResolver
+        if (reactTagResolver == null) {
+            val result = ReactTagResolver(context)
+            this.reactTagResolver = result
+            return result
+        }
+        return reactTagResolver
+    }
+}

package/android/src/main/java/io/github/mapvina/reactnative/components/AbstractEvent.kt

@@ -0,0 +1,20 @@
+package io.github.mapvina.reactnative.components
+
+import com.facebook.react.bridge.WritableMap
+import com.facebook.react.uimanager.events.Event
+import com.facebook.react.uimanager.events.RCTEventEmitter
+
+class AbstractEvent(
+    viewId: Int,
+    private val mEventName: String,
+    private val mCanCoalesce: Boolean,
+    private val mEvent: WritableMap?,
+) : Event<AbstractEvent>(viewId) {
+    override fun getEventName(): String = mEventName
+
+    override fun dispatch(rctEventEmitter: RCTEventEmitter) {
+        rctEventEmitter.receiveEvent(viewTag, eventName, mEvent)
+    }
+
+    override fun canCoalesce(): Boolean = mCanCoalesce
+}

package/android/src/main/java/io/github/mapvina/reactnative/components/AbstractEventEmitter.kt

@@ -0,0 +1,80 @@
+package io.github.mapvina.reactnative.components
+
+import android.view.ViewGroup
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.common.MapBuilder
+import com.facebook.react.uimanager.ThemedReactContext
+import com.facebook.react.uimanager.UIManagerHelper
+import com.facebook.react.uimanager.ViewGroupManager
+import com.facebook.react.uimanager.common.UIManagerType
+import com.facebook.react.uimanager.events.EventDispatcher
+import io.github.mapvina.reactnative.events.IEvent
+
+abstract class AbstractEventEmitter<T : ViewGroup>(
+    private val reactContext: ReactApplicationContext,
+) : ViewGroupManager<T>() {
+    private val mRateLimitedEvents: MutableMap<String?, Long?> = HashMap()
+    private var mEventDispatcher: EventDispatcher? = null
+
+    fun handleEvent(event: IEvent) {
+        val eventCacheKey = getEventCacheKey(event)
+
+        // fail safe to protect bridge from being spammed
+        if (shouldDropEvent(eventCacheKey, event)) {
+            return
+        }
+
+        mRateLimitedEvents.put(eventCacheKey, System.currentTimeMillis())
+        mEventDispatcher!!.dispatchEvent(
+            AbstractEvent(
+                event.getID(),
+                event.getKey(),
+                event.canCoalesce(),
+                event.toJSON(),
+            ),
+        )
+    }
+
+    override fun addEventEmitters(
+        context: ThemedReactContext,
+        view: T,
+    ) {
+        mEventDispatcher =
+            UIManagerHelper.getUIManager(context, UIManagerType.Companion.FABRIC)!!.eventDispatcher
+    }
+
+    override fun getExportedCustomDirectEventTypeConstants(): MutableMap<String?, Any?>? {
+        val events = customEvents()
+
+        if (events == null) {
+            return null
+        }
+
+        val exportedEvents: MutableMap<String?, Any?> = HashMap<String?, Any?>()
+
+        for (event in events.entries) {
+            exportedEvents.put(
+                event.key,
+                MapBuilder.of<String?, String?>("registrationName", event.value!!),
+            )
+        }
+
+        return exportedEvents
+    }
+
+    abstract fun customEvents(): Map<String, String>?
+
+    private fun shouldDropEvent(
+        cacheKey: String?,
+        event: IEvent,
+    ): Boolean {
+        val lastEventTimestamp = mRateLimitedEvents.get(cacheKey)
+        return lastEventTimestamp != null && (event.getTimestamp() - lastEventTimestamp) <= BRIDGE_TIMEOUT_MS
+    }
+
+    private fun getEventCacheKey(event: IEvent): String = String.format("%s-%s", event.getKey(), event.getType())
+
+    companion object {
+        private const val BRIDGE_TIMEOUT_MS = 10.0
+    }
+}

package/android/src/main/java/io/github/mapvina/reactnative/components/AbstractMapFeature.kt

@@ -0,0 +1,13 @@
+package io.github.mapvina.reactnative.components
+
+import android.content.Context
+import com.facebook.react.views.view.ReactViewGroup
+import io.github.mapvina.reactnative.components.mapview.MLRNMapView
+
+abstract class AbstractMapFeature(
+    context: Context?,
+) : ReactViewGroup(context) {
+    abstract fun addToMap(mapView: MLRNMapView)
+
+    abstract fun removeFromMap(mapView: MLRNMapView)
+}

package/android/src/main/java/io/github/mapvina/reactnative/components/annotations/callout/MLRNCallout.kt

@@ -0,0 +1,8 @@
+package io.github.mapvina.reactnative.components.annotations.callout
+
+import android.content.Context
+import com.facebook.react.views.view.ReactViewGroup
+
+class MLRNCallout(
+    context: Context,
+) : ReactViewGroup(context)

package/android/src/main/java/io/github/mapvina/reactnative/components/annotations/callout/MLRNCalloutManager.kt

@@ -0,0 +1,26 @@
+package io.github.mapvina.reactnative.components.annotations.callout
+
+import com.facebook.react.module.annotations.ReactModule
+import com.facebook.react.uimanager.ThemedReactContext
+import com.facebook.react.uimanager.ViewGroupManager
+import com.facebook.react.uimanager.ViewManagerDelegate
+import com.facebook.react.viewmanagers.MLRNCalloutManagerDelegate
+import com.facebook.react.viewmanagers.MLRNCalloutManagerInterface
+
+@ReactModule(name = MLRNCalloutManager.REACT_CLASS)
+class MLRNCalloutManager :
+    ViewGroupManager<MLRNCallout>(),
+    MLRNCalloutManagerInterface<MLRNCallout> {
+    private val delegate: MLRNCalloutManagerDelegate<MLRNCallout, MLRNCalloutManager> =
+        MLRNCalloutManagerDelegate(this)
+
+    override fun getDelegate(): ViewManagerDelegate<MLRNCallout> = delegate
+
+    companion object {
+        const val REACT_CLASS: String = "MLRNCallout"
+    }
+
+    override fun getName(): String = REACT_CLASS
+
+    override fun createViewInstance(reactContext: ThemedReactContext): MLRNCallout = MLRNCallout(reactContext)
+}