react-native-nitro-country-picker 0.1.0

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2025 Quan Pham
+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/NitroCountryPicker.podspec

@@ -0,0 +1,37 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "NitroCountryPicker"
+  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/Doko-Demo-Doa/react-native-nitro-country-picker.git", :tag => "#{s.version}" }
+
+
+  s.source_files = [
+    "ios/**/*.{swift}",
+    "ios/**/*.{m,mm}",
+    "cpp/**/*.{hpp,cpp}",
+  ]
+
+  s.dependency 'React-jsi'
+  s.dependency 'React-callinvoker'
+  s.dependency 'CountryPickerAKS'
+
+  load 'nitrogen/generated/ios/NitroCountryPicker+autolinking.rb'
+  add_nitrogen_files(s)
+
+  # Ensure generated shared C++ headers are exported to Pods/Headers/Public.
+  current_public_headers = Array(s.attributes_hash['public_header_files'])
+  s.public_header_files = current_public_headers + [
+    'nitrogen/generated/shared/c++/*.hpp',
+  ]
+
+  install_modules_dependencies(s)
+end

package/README.md

@@ -0,0 +1,164 @@
+# react-native-nitro-country-picker
+
+A native country picker for React Native, powered by Nitro Modules.
+
+This library provides a single async API that opens a native picker and returns structured country data.
+
+- Android native implementation: [CountryCodePickerCompose](https://github.com/ahmmedrejowan/CountryCodePickerCompose)
+- iOS native implementation: [CountryPickerAKS](https://github.com/aksamitsah/CountryPickerAKS)
+
+## Features
+
+- Native picker UI on both iOS and Android
+- Promise-based API: `pickCountry(options?)`
+- Typed result object with `name`, `dialCode`, and `code`
+- `null` result when user dismisses without selection
+- Last selection cache via `getLastPickedCountry()`
+- Optional picker title input: `headerTitle` (currently applied on Android)
+
+## Requirements
+
+| Platform | Minimum |
+| -------- | ------- |
+| iOS      | 15.1+   |
+| Android  | API 24+ |
+
+> Note: This package depends on [react-native-nitro-modules](https://nitro.margelo.com/).
+
+## Installation
+
+```bash
+npm install react-native-nitro-country-picker react-native-nitro-modules
+```
+
+or
+
+```bash
+yarn add react-native-nitro-country-picker react-native-nitro-modules
+```
+
+### iOS setup
+
+```bash
+cd ios && pod install
+```
+
+## Usage
+
+```tsx
+import { pickCountry } from 'react-native-nitro-country-picker';
+
+const country = await pickCountry();
+```
+
+### With options
+
+```tsx
+import { pickCountry } from 'react-native-nitro-country-picker';
+
+const country = await pickCountry({
+  headerTitle: 'Select your country',
+});
+```
+
+## Returned Data Examples
+
+### 1) Handle selected vs dismissed
+
+```tsx
+import { pickCountry } from 'react-native-nitro-country-picker';
+
+const picked = await pickCountry();
+
+if (picked) {
+  console.log('Country name:', picked.name);
+  console.log('Dial code:', picked.dialCode);
+  console.log('ISO code:', picked.code);
+} else {
+  console.log('Picker dismissed without selection');
+}
+```
+
+### 2) Build display text from returned data
+
+```tsx
+import { pickCountry } from 'react-native-nitro-country-picker';
+
+const picked = await pickCountry();
+const label = picked
+  ? `${picked.name} (${picked.dialCode}, ${picked.code})`
+  : 'No country selected';
+
+console.log(label);
+```
+
+### 3) Read last picked country
+
+```tsx
+import {
+  getLastPickedCountry,
+  pickCountry,
+} from 'react-native-nitro-country-picker';
+
+await pickCountry();
+
+const last = getLastPickedCountry();
+if (last) {
+  console.log('Last picked:', last.name, last.dialCode, last.code);
+}
+```
+
+## API
+
+### `pickCountry(options?) => Promise<IPickedCountry | null>`
+
+Opens the native picker and resolves with:
+
+- `IPickedCountry` when user selects a country
+- `null` when user dismisses/cancels
+
+Options:
+
+- `headerTitle?: string`
+
+### `getLastPickedCountry() => IPickedCountry | null`
+
+Returns the most recent selected country for the current app runtime session.
+
+## Type Shapes
+
+```ts
+type IPickedCountry = {
+  name: string;
+  dialCode: string;
+  code: string;
+};
+
+type PickCountryOptions = {
+  headerTitle?: string;
+};
+```
+
+## Example App
+
+To run the included example app:
+
+```bash
+cd example
+yarn install
+yarn ios
+# or
+yarn android
+```
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development workflow and contribution guidelines.
+
+## License
+
+MIT
+
+---
+
+Made with [create-react-native-library](https://github.com/callstack/react-native-builder-bob)

package/android/CMakeLists.txt

@@ -0,0 +1,24 @@
+project(nitrocountrypicker)
+cmake_minimum_required(VERSION 3.9.0)
+
+set(PACKAGE_NAME nitrocountrypicker)
+set(CMAKE_VERBOSE_MAKEFILE ON)
+set(CMAKE_CXX_STANDARD 20)
+
+# Define C++ library and add all sources
+add_library(${PACKAGE_NAME} SHARED src/main/cpp/cpp-adapter.cpp)
+
+# Add Nitrogen specs :)
+include(${CMAKE_SOURCE_DIR}/../nitrogen/generated/android/nitrocountrypicker+autolinking.cmake)
+
+# Set up local includes
+include_directories("src/main/cpp" "../cpp")
+
+find_library(LOG_LIB log)
+
+# Link all libraries together
+target_link_libraries(
+        ${PACKAGE_NAME}
+        ${LOG_LIB}
+        android # <-- Android core
+)

package/android/build.gradle

@@ -0,0 +1,149 @@
+buildscript {
+  ext.getExtOrDefault = {name ->
+    return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties['NitroCountryPicker_' + name]
+  }
+
+  repositories {
+    google()
+    mavenCentral()
+    maven { url 'https://jitpack.io' }
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:8.7.2"
+    // noinspection DifferentKotlinGradleVersion
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
+    classpath "org.jetbrains.kotlin:compose-compiler-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
+  }
+}
+
+def reactNativeArchitectures() {
+  def value = rootProject.getProperties().get("reactNativeArchitectures")
+  return value ? value.split(",") : ["armeabi-v7a", "x86", "x86_64", "arm64-v8a"]
+}
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+apply plugin: "org.jetbrains.kotlin.plugin.compose"
+apply from: '../nitrogen/generated/android/nitrocountrypicker+autolinking.gradle'
+
+apply plugin: "com.facebook.react"
+
+def getExtOrIntegerDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["NitroCountryPicker_" + name]).toInteger()
+}
+
+android {
+  namespace "com.margelo.nitro.nitrocountrypicker"
+
+  compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrIntegerDefault("minSdkVersion")
+    targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
+
+    externalNativeBuild {
+      cmake {
+        cppFlags "-frtti -fexceptions -Wall -fstack-protector-all"
+        arguments "-DANDROID_STL=c++_shared", "-DANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES=ON"
+        abiFilters (*reactNativeArchitectures())
+
+        buildTypes {
+          debug {
+            cppFlags "-O1 -g"
+          }
+          release {
+            cppFlags "-O2"
+          }
+        }
+      }
+    }
+  }
+
+  externalNativeBuild {
+    cmake {
+      path "CMakeLists.txt"
+    }
+  }
+
+  packagingOptions {
+    excludes = [
+            "META-INF",
+            "META-INF/**",
+            "**/libc++_shared.so",
+            "**/libfbjni.so",
+            "**/libjsi.so",
+            "**/libfolly_json.so",
+            "**/libfolly_runtime.so",
+            "**/libglog.so",
+            "**/libhermes.so",
+            "**/libhermes-executor-debug.so",
+            "**/libhermes_executor.so",
+            "**/libreactnative.so",
+            "**/libreactnativejni.so",
+            "**/libturbomodulejsijni.so",
+            "**/libreact_nativemodule_core.so",
+            "**/libjscexecutor.so"
+    ]
+  }
+
+  buildFeatures {
+    buildConfig true
+    prefab true
+    compose true
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  lintOptions {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_17
+    targetCompatibility JavaVersion.VERSION_17
+  }
+
+  kotlinOptions {
+    jvmTarget = "17"
+  }
+
+  sourceSets {
+    main {
+      java.srcDirs += [
+        "generated/java",
+        "generated/jni"
+      ]
+    }
+  }
+}
+
+repositories {
+  mavenCentral()
+  maven { url 'https://jitpack.io' }
+  google()
+}
+
+def kotlin_version = getExtOrDefault("kotlinVersion")
+def appcompat_version = "1.7.1"
+def compose_bom_version = "2024.12.01"
+def activity_compose_version = "1.13.0"
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+  implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
+  implementation project(":react-native-nitro-modules")
+
+  implementation "com.rejowan:ccpc:1.0.1"
+  implementation platform("androidx.compose:compose-bom:$compose_bom_version")
+  implementation "androidx.activity:activity-compose:$activity_compose_version"
+  implementation "androidx.compose.ui:ui"
+  implementation "androidx.compose.runtime:runtime"
+  implementation "androidx.compose.material3:material3"
+  implementation "androidx.appcompat:appcompat:$appcompat_version"
+  implementation "com.google.android.material:material:1.12.0"
+}

package/android/gradle.properties

@@ -0,0 +1,5 @@
+NitroCountryPicker_kotlinVersion=2.0.21
+NitroCountryPicker_minSdkVersion=24
+NitroCountryPicker_targetSdkVersion=34
+NitroCountryPicker_compileSdkVersion=36
+NitroCountryPicker_ndkVersion=27.1.12297006

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,8 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+  <application>
+    <activity
+      android:name=".CountryPickerActivity"
+      android:exported="false"
+      android:theme="@android:style/Theme.Translucent.NoTitleBar" />
+  </application>
+</manifest>

package/android/src/main/cpp/cpp-adapter.cpp

@@ -0,0 +1,6 @@
+#include <jni.h>
+#include "nitrocountrypickerOnLoad.hpp"
+
+JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM* vm, void*) {
+  return margelo::nitro::nitrocountrypicker::initialize(vm);
+}

package/android/src/main/java/com/margelo/nitro/nitrocountrypicker/CountryPickerActivity.kt

@@ -0,0 +1,95 @@
+package com.margelo.nitro.nitrocountrypicker
+
+import android.app.Activity
+import android.content.Intent
+import android.os.Bundle
+import android.widget.Toast
+import androidx.activity.ComponentActivity
+import androidx.activity.compose.setContent
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.runtime.getValue
+import androidx.compose.runtime.mutableStateOf
+import androidx.compose.runtime.remember
+import androidx.compose.runtime.setValue
+import com.rejowan.ccpc.CCPUtils
+import com.rejowan.ccpc.Country
+import com.rejowan.ccpc.CountryPickerDialog
+import com.rejowan.ccpc.PickerCustomization
+
+class CountryPickerActivity : ComponentActivity() {
+  companion object {
+    const val EXTRA_HEADER_TITLE = "com.margelo.nitro.nitrocountrypicker.HEADER_TITLE"
+    private const val EXTRA_RESULT_NAME = "com.margelo.nitro.nitrocountrypicker.RESULT_NAME"
+    private const val EXTRA_RESULT_DIAL_CODE = "com.margelo.nitro.nitrocountrypicker.RESULT_DIAL_CODE"
+    private const val EXTRA_RESULT_CODE = "com.margelo.nitro.nitrocountrypicker.RESULT_CODE"
+
+    fun intentResultToPickedCountry(resultCode: Int, data: Intent?): IPickedCountry? {
+      if (resultCode != Activity.RESULT_OK || data == null) {
+        return null
+      }
+
+      val name = data.getStringExtra(EXTRA_RESULT_NAME) ?: return null
+      val dialCode = data.getStringExtra(EXTRA_RESULT_DIAL_CODE) ?: return null
+      val code = data.getStringExtra(EXTRA_RESULT_CODE) ?: return null
+      return IPickedCountry(name = name, dialCode = dialCode, code = code)
+    }
+  }
+
+  private var hasCompletedPick = false
+
+  override fun onCreate(savedInstanceState: Bundle?) {
+    super.onCreate(savedInstanceState)
+    val headerTitle = intent.getStringExtra(EXTRA_HEADER_TITLE)?.trim()?.takeIf { it.isNotEmpty() }
+    val pickerCustomization = if (headerTitle == null) {
+      PickerCustomization()
+    } else {
+      PickerCustomization(headerTitleText = headerTitle)
+    }
+
+    setContent {
+      MaterialTheme {
+        var selectedCountry by remember {
+          mutableStateOf(
+            CCPUtils.getCountryAutomatically(this@CountryPickerActivity)
+              ?: Country.UnitedStates
+          )
+        }
+
+        CountryPickerDialog(
+          onDismissRequest = {
+            hasCompletedPick = true
+            setResult(Activity.RESULT_CANCELED)
+            finish()
+          },
+          onItemClicked = { country ->
+            selectedCountry = country
+            hasCompletedPick = true
+            val resultIntent = Intent().apply {
+              putExtra(EXTRA_RESULT_NAME, country.countryName)
+              putExtra(EXTRA_RESULT_DIAL_CODE, country.countryCode)
+              putExtra(EXTRA_RESULT_CODE, country.countryIso)
+            }
+            setResult(Activity.RESULT_OK, resultIntent)
+            Toast.makeText(
+              this@CountryPickerActivity,
+              country.countryName,
+              Toast.LENGTH_SHORT
+            ).show()
+            finish()
+          },
+          listOfCountry = Country.getAllCountries(),
+          selectedCountry = selectedCountry,
+          pickerCustomization = pickerCustomization
+        )
+      }
+    }
+  }
+
+  override fun onDestroy() {
+    super.onDestroy()
+    if (!hasCompletedPick) {
+      setResult(Activity.RESULT_CANCELED)
+      hasCompletedPick = true
+    }
+  }
+}

package/android/src/main/java/com/margelo/nitro/nitrocountrypicker/NitroCountryPicker.kt

@@ -0,0 +1,132 @@
+package com.margelo.nitro.nitrocountrypicker
+
+import android.content.Intent
+import androidx.activity.ComponentActivity
+import androidx.activity.result.ActivityResultLauncher
+import androidx.activity.result.contract.ActivityResultContracts
+import com.facebook.proguard.annotations.DoNotStrip
+import com.facebook.react.bridge.UiThreadUtil
+import com.margelo.nitro.NitroModules
+import com.margelo.nitro.core.NullType
+import com.margelo.nitro.core.Promise
+import java.util.concurrent.atomic.AtomicInteger
+
+
+@DoNotStrip
+class NitroCountryPicker : HybridNitroCountryPickerSpec() {
+  companion object {
+    const val NAME = "NitroCountryPicker"
+
+    @Volatile
+    private var lastPickedCountry: IPickedCountry? = null
+
+    @Volatile
+    private var pendingPickPromise: Promise<Variant_NullType_IPickedCountry>? = null
+
+    private val launcherCounter = AtomicInteger(0)
+
+    private fun setLastPickedCountry(country: IPickedCountry) {
+      lastPickedCountry = country
+    }
+
+    @Synchronized
+    private fun resolvePendingPick(country: IPickedCountry?) {
+      val promise = pendingPickPromise ?: return
+      pendingPickPromise = null
+      val result = if (country == null) {
+        Variant_NullType_IPickedCountry.create(NullType.NULL)
+      } else {
+        Variant_NullType_IPickedCountry.create(country)
+      }
+      promise.resolve(result)
+    }
+
+    @Synchronized
+    private fun setPendingPickPromise(promise: Promise<Variant_NullType_IPickedCountry>): Boolean {
+      if (pendingPickPromise != null) {
+        return false
+      }
+      pendingPickPromise = promise
+      return true
+    }
+
+    @Synchronized
+    private fun rejectPendingPick(error: Throwable) {
+      val promise = pendingPickPromise ?: return
+      pendingPickPromise = null
+      promise.reject(error)
+    }
+
+    private fun nextLauncherKey(): String {
+      return "NitroCountryPicker#${launcherCounter.incrementAndGet()}"
+    }
+  }
+
+  override fun pickCountry(options: PickCountryOptions?): Promise<Variant_NullType_IPickedCountry> {
+    val activity = NitroModules.applicationContext?.currentActivity
+      ?: return Promise.rejected<Variant_NullType_IPickedCountry>(
+        IllegalStateException("No current Activity available to present country picker.")
+      )
+    val componentActivity = activity as? ComponentActivity
+      ?: return Promise.rejected<Variant_NullType_IPickedCountry>(
+        IllegalStateException("Current Activity must be a ComponentActivity to register for activity results.")
+      )
+
+    val promise = Promise<Variant_NullType_IPickedCountry>()
+    val accepted = setPendingPickPromise(promise)
+    if (!accepted) {
+      return Promise.rejected<Variant_NullType_IPickedCountry>(
+        IllegalStateException("Country picker is already open.")
+      )
+    }
+
+    UiThreadUtil.runOnUiThread {
+      var launcher: ActivityResultLauncher<Intent>? = null
+      try {
+        val intent = Intent(activity, CountryPickerActivity::class.java)
+        val headerTitle = options?.headerTitle?.trim()?.takeIf { it.isNotEmpty() }
+        if (headerTitle != null) {
+          intent.putExtra(CountryPickerActivity.EXTRA_HEADER_TITLE, headerTitle)
+        }
+
+        launcher = componentActivity.activityResultRegistry.register(
+          nextLauncherKey(),
+          ActivityResultContracts.StartActivityForResult()
+        ) { result ->
+          try {
+            val picked = CountryPickerActivity.intentResultToPickedCountry(result.resultCode, result.data)
+            if (picked != null) {
+              setLastPickedCountry(picked)
+            }
+            resolvePendingPick(picked)
+          } catch (error: Throwable) {
+            rejectPendingPick(error)
+          } finally {
+            launcher?.unregister()
+            launcher = null
+          }
+        }
+
+        launcher?.launch(intent)
+      } catch (error: Throwable) {
+        try {
+          launcher?.unregister()
+        } catch (_: Throwable) {
+          // Ignore cleanup errors while handling the original failure.
+        }
+        rejectPendingPick(error)
+      }
+    }
+
+    return promise
+  }
+
+  override fun getLastPickedCountry(): Variant_NullType_IPickedCountry {
+    val picked = lastPickedCountry
+    return if (picked == null) {
+      Variant_NullType_IPickedCountry.create(NullType.NULL)
+    } else {
+      Variant_NullType_IPickedCountry.create(picked)
+    }
+  }
+}

package/android/src/main/java/com/margelo/nitro/nitrocountrypicker/NitroCountryPickerPackage.kt

@@ -0,0 +1,36 @@
+package com.margelo.nitro.nitrocountrypicker
+
+import android.util.Log
+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
+
+class NitroCountryPickerPackage : BaseReactPackage() {
+    override fun getModule(name: String, reactContext: ReactApplicationContext): NativeModule? {
+        return null
+    }
+
+    override fun getReactModuleInfoProvider(): ReactModuleInfoProvider {
+        return ReactModuleInfoProvider {
+          val moduleInfos: MutableMap<String, ReactModuleInfo> = HashMap()
+          moduleInfos[NitroCountryPicker.NAME] = ReactModuleInfo(
+            NitroCountryPicker.NAME,
+            NitroCountryPicker.NAME,
+            false,
+            needsEagerInit = true,
+            isCxxModule = false,
+            isTurboModule = true
+          )
+          moduleInfos
+        }
+    }
+
+    companion object {
+        init {
+            System.loadLibrary("nitrocountrypicker")
+            Log.d(NitroCountryPicker.NAME, "Hello from init")
+        }
+    }
+}