@themobilefirstcompany/react-native-data-detector 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pablo Giraud-Carrier
+
+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/README.md

@@ -0,0 +1,133 @@
+# react-native-data-detector
+
+Cross-platform text data detection for React Native. Uses **NSDataDetector** on iOS and **ML Kit Entity Extraction** on Android to detect phone numbers, URLs, emails, dates, and addresses — returning structured results to JavaScript.
+
+## Features
+
+- **Phone numbers** — Detect and extract phone numbers
+- **URLs** — Detect web links
+- **Emails** — Detect email addresses
+- **Addresses** — Detect street addresses with parsed components (iOS)
+- **Dates** — Detect dates and times with ISO 8601 output
+- **Native accuracy** — Uses battle-tested platform APIs instead of regex
+- **Expo Modules API** — Built with the modern Expo native module system
+
+## Installation
+
+```bash
+npm install react-native-data-detector
+```
+
+### iOS
+
+```bash
+npx pod-install
+```
+
+### Android
+
+The ML Kit entity extraction model (~5.6MB) is downloaded on the user's device at runtime. You can control when this happens using [`downloadModel()`](#downloadmodel) — for example, calling it at app startup to ensure `detect()` works offline later. If you don't call it explicitly, the model will be downloaded automatically on the first `detect()` call.
+
+## Usage
+
+```typescript
+import { detect, downloadModel } from 'react-native-data-detector';
+
+// Pre-download the ML Kit model at app startup (Android only, no-op on iOS)
+await downloadModel();
+
+// Detect all entity types
+const entities = await detect('Call me at 555-1234 or email john@example.com');
+// [
+//   { type: 'phoneNumber', text: '555-1234', start: 14, end: 22, data: { phoneNumber: '555-1234' } },
+//   { type: 'email', text: 'john@example.com', start: 32, end: 48, data: { email: 'john@example.com' } }
+// ]
+
+// Detect only specific types
+const phones = await detect('Call 555-1234 or visit https://example.com', {
+  types: ['phoneNumber'],
+});
+// [
+//   { type: 'phoneNumber', text: '555-1234', start: 5, end: 13, data: { phoneNumber: '555-1234' } }
+// ]
+```
+
+## API
+
+### `downloadModel()`
+
+Pre-downloads the ML Kit entity extraction model on Android. On iOS, this is a no-op that resolves immediately — `NSDataDetector` is built into the OS and requires no model download.
+
+Call this at app startup or before the first `detect()` call to ensure the model is available offline.
+
+**Returns:** `Promise<boolean>` — `true` when the model is ready.
+
+| Platform | Behavior |
+|----------|----------|
+| **iOS** | No-op, resolves `true` immediately |
+| **Android** | Downloads the ML Kit model (~5.6MB) if not already cached. Requires internet on first call. |
+
+### `detect(text, options?)`
+
+Detects entities in the given text using native platform APIs.
+
+**Parameters:**
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `text` | `string` | The text to analyze |
+| `options` | `DetectOptions` | Optional configuration |
+
+**DetectOptions:**
+
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| `types` | `DetectionType[]` | All types | Which entity types to detect |
+
+**DetectionType:** `'phoneNumber' | 'link' | 'email' | 'address' | 'date'`
+
+**Returns:** `Promise<DetectedEntity[]>`
+
+### `DetectedEntity`
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `type` | `DetectionType` | The type of detected entity |
+| `text` | `string` | The matched text substring |
+| `start` | `number` | Start index in the original string |
+| `end` | `number` | End index (exclusive) in the original string |
+| `data` | `Record<string, string>` | Additional structured data (see below) |
+
+### Entity Data by Type
+
+| Type | Data fields |
+|------|-------------|
+| `phoneNumber` | `{ phoneNumber }` |
+| `link` | `{ url }` |
+| `email` | `{ email }` |
+| `address` | `{ street, city, state, zip, country }` (iOS) / `{ address }` (Android) |
+| `date` | `{ date }` ISO 8601 string |
+
+## Platform Differences
+
+| Feature | iOS | Android |
+|---------|-----|---------|
+| Engine | NSDataDetector | ML Kit Entity Extraction |
+| Offline | Always | After `downloadModel()` or first `detect()` call |
+| Model download | Not needed | ~5.6MB, on-device at runtime |
+| Address parsing | Structured components | Raw string |
+| Date output | ISO 8601 | ISO 8601 |
+
+## Requirements
+
+- iOS 15.1+
+- Android API 24+ (minSdk)
+- Expo SDK 50+ or bare React Native with `expo-modules-core`
+
+## Contributing
+
+Contributions are welcome! Please open an issue or submit a pull request.
+
+## License
+
+MIT

package/android/build.gradle

@@ -0,0 +1,28 @@
+apply plugin: 'com.android.library'
+apply plugin: 'org.jetbrains.kotlin.android'
+
+group = 'expo.modules.datadetector'
+version = '0.1.0'
+
+android {
+  namespace 'expo.modules.datadetector'
+  compileSdkVersion safeExtGet("compileSdkVersion", 34)
+
+  defaultConfig {
+    minSdkVersion safeExtGet("minSdkVersion", 24)
+    targetSdkVersion safeExtGet("targetSdkVersion", 34)
+  }
+
+  lintOptions {
+    abortOnError false
+  }
+}
+
+dependencies {
+  implementation project(':expo-modules-core')
+  implementation "com.google.mlkit:entity-extraction:16.0.0-beta5"
+}
+
+def safeExtGet(prop, fallback) {
+  rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android" />

package/android/src/main/java/expo/modules/datadetector/ReactNativeDataDetectorModule.kt

@@ -0,0 +1,115 @@
+package expo.modules.datadetector
+
+import com.google.mlkit.nl.entityextraction.Entity
+import com.google.mlkit.nl.entityextraction.EntityExtraction
+import com.google.mlkit.nl.entityextraction.EntityExtractionParams
+import com.google.mlkit.nl.entityextraction.EntityExtractorOptions
+import expo.modules.kotlin.Promise
+import expo.modules.kotlin.modules.Module
+import expo.modules.kotlin.modules.ModuleDefinition
+import java.text.SimpleDateFormat
+import java.util.Date
+import java.util.Locale
+import java.util.TimeZone
+
+class ReactNativeDataDetectorModule : Module() {
+  override fun definition() = ModuleDefinition {
+    Name("ReactNativeDataDetector")
+
+    AsyncFunction("downloadModel") { promise: Promise ->
+      val options = EntityExtractorOptions.Builder(EntityExtractorOptions.ENGLISH)
+        .build()
+      val extractor = EntityExtraction.getClient(options)
+
+      extractor.downloadModelIfNeeded()
+        .addOnSuccessListener {
+          promise.resolve(true)
+          extractor.close()
+        }
+        .addOnFailureListener { e ->
+          promise.reject("MODEL_DOWNLOAD_ERROR", e.message ?: "Failed to download ML Kit model", e)
+          extractor.close()
+        }
+    }
+
+    AsyncFunction("detect") { text: String, types: List<String>, promise: Promise ->
+      val options = EntityExtractorOptions.Builder(EntityExtractorOptions.ENGLISH)
+        .build()
+      val extractor = EntityExtraction.getClient(options)
+
+      extractor.downloadModelIfNeeded()
+        .addOnSuccessListener {
+          val params = EntityExtractionParams.Builder(text).build()
+
+          extractor.annotate(params)
+            .addOnSuccessListener { annotations ->
+              val results = mutableListOf<Map<String, Any>>()
+
+              for (annotation in annotations) {
+                for (entity in annotation.entities) {
+                  val type = mapEntityType(entity) ?: continue
+                  if (!types.contains(type)) continue
+
+                  val data = mutableMapOf<String, String>()
+                  populateEntityData(entity, type, data, annotation.annotatedText)
+
+                  results.add(
+                    mapOf(
+                      "type" to type,
+                      "text" to annotation.annotatedText,
+                      "start" to annotation.start,
+                      "end" to annotation.end,
+                      "data" to data
+                    )
+                  )
+                  break // One result per annotation
+                }
+              }
+
+              promise.resolve(results)
+              extractor.close()
+            }
+            .addOnFailureListener { e ->
+              promise.reject("DETECTION_ERROR", e.message ?: "Entity extraction failed", e)
+              extractor.close()
+            }
+        }
+        .addOnFailureListener { e ->
+          promise.reject("MODEL_DOWNLOAD_ERROR", e.message ?: "Failed to download ML Kit model", e)
+          extractor.close()
+        }
+    }
+  }
+
+  private fun mapEntityType(entity: Entity): String? {
+    return when (entity.type) {
+      Entity.TYPE_PHONE -> "phoneNumber"
+      Entity.TYPE_URL -> "link"
+      Entity.TYPE_EMAIL -> "email"
+      Entity.TYPE_ADDRESS -> "address"
+      Entity.TYPE_DATE_TIME -> "date"
+      else -> null
+    }
+  }
+
+  private fun populateEntityData(
+    entity: Entity,
+    type: String,
+    data: MutableMap<String, String>,
+    annotatedText: String
+  ) {
+    when (type) {
+      "phoneNumber" -> data["phoneNumber"] = annotatedText
+      "link" -> data["url"] = annotatedText
+      "email" -> data["email"] = annotatedText
+      "address" -> data["address"] = annotatedText
+      "date" -> {
+        entity.asDateTimeEntity()?.let { dateTime ->
+          val formatter = SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss'Z'", Locale.US)
+          formatter.timeZone = TimeZone.getTimeZone("UTC")
+          data["date"] = formatter.format(Date(dateTime.timestampMillis))
+        }
+      }
+    }
+  }
+}

package/build/ReactNativeDataDetector.d.ts

@@ -0,0 +1,13 @@
+import type { DetectedEntity, DetectOptions } from './ReactNativeDataDetector.types';
+/**
+ * Pre-downloads the ML Kit entity extraction model on Android.
+ * No-op on iOS (NSDataDetector requires no model download).
+ * Call this at app startup to ensure `detect()` works offline later.
+ */
+export declare function downloadModel(): Promise<boolean>;
+/**
+ * Detects entities (phone numbers, URLs, emails, addresses, dates) in the given text
+ * using native platform APIs (NSDataDetector on iOS, ML Kit on Android).
+ */
+export declare function detect(text: string, options?: DetectOptions): Promise<DetectedEntity[]>;
+//# sourceMappingURL=ReactNativeDataDetector.d.ts.map

package/build/ReactNativeDataDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReactNativeDataDetector.d.ts","sourceRoot":"","sources":["../src/ReactNativeDataDetector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAIrF;;;;GAIG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAEtD;AAED;;;GAGG;AACH,wBAAsB,MAAM,CAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,cAAc,EAAE,CAAC,CAG3B"}

package/build/ReactNativeDataDetector.js

@@ -0,0 +1,19 @@
+import { requireNativeModule } from 'expo-modules-core';
+const NativeModule = requireNativeModule('ReactNativeDataDetector');
+/**
+ * Pre-downloads the ML Kit entity extraction model on Android.
+ * No-op on iOS (NSDataDetector requires no model download).
+ * Call this at app startup to ensure `detect()` works offline later.
+ */
+export async function downloadModel() {
+    return NativeModule.downloadModel();
+}
+/**
+ * Detects entities (phone numbers, URLs, emails, addresses, dates) in the given text
+ * using native platform APIs (NSDataDetector on iOS, ML Kit on Android).
+ */
+export async function detect(text, options) {
+    const types = options?.types ?? ['phoneNumber', 'link', 'email', 'address', 'date'];
+    return NativeModule.detect(text, types);
+}
+//# sourceMappingURL=ReactNativeDataDetector.js.map

package/build/ReactNativeDataDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReactNativeDataDetector.js","sourceRoot":"","sources":["../src/ReactNativeDataDetector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAIxD,MAAM,YAAY,GAAG,mBAAmB,CAAC,yBAAyB,CAAC,CAAC;AAEpE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,OAAO,YAAY,CAAC,aAAa,EAAE,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,IAAY,EACZ,OAAuB;IAEvB,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IACpF,OAAO,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC1C,CAAC","sourcesContent":["import { requireNativeModule } from 'expo-modules-core';\n\nimport type { DetectedEntity, DetectOptions } from './ReactNativeDataDetector.types';\n\nconst NativeModule = requireNativeModule('ReactNativeDataDetector');\n\n/**\n * Pre-downloads the ML Kit entity extraction model on Android.\n * No-op on iOS (NSDataDetector requires no model download).\n * Call this at app startup to ensure `detect()` works offline later.\n */\nexport async function downloadModel(): Promise<boolean> {\n  return NativeModule.downloadModel();\n}\n\n/**\n * Detects entities (phone numbers, URLs, emails, addresses, dates) in the given text\n * using native platform APIs (NSDataDetector on iOS, ML Kit on Android).\n */\nexport async function detect(\n  text: string,\n  options?: DetectOptions\n): Promise<DetectedEntity[]> {\n  const types = options?.types ?? ['phoneNumber', 'link', 'email', 'address', 'date'];\n  return NativeModule.detect(text, types);\n}\n"]}

package/build/ReactNativeDataDetector.types.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The type of entity detected in the text.
+ */
+export type DetectionType = 'phoneNumber' | 'link' | 'email' | 'address' | 'date';
+/**
+ * A single detected entity within the text.
+ */
+export interface DetectedEntity {
+    /** The type of detected entity. */
+    type: DetectionType;
+    /** The matched text substring. */
+    text: string;
+    /** Start index of the match in the original string. */
+    start: number;
+    /** End index (exclusive) of the match in the original string. */
+    end: number;
+    /** Additional data depending on the type (e.g., URL string, phone number, date ISO string). */
+    data?: Record<string, string>;
+}
+/**
+ * Options for the detect function.
+ */
+export interface DetectOptions {
+    /** Which entity types to detect. Defaults to all types. */
+    types?: DetectionType[];
+}
+//# sourceMappingURL=ReactNativeDataDetector.types.d.ts.map

package/build/ReactNativeDataDetector.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReactNativeDataDetector.types.d.ts","sourceRoot":"","sources":["../src/ReactNativeDataDetector.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,aAAa,GACb,MAAM,GACN,OAAO,GACP,SAAS,GACT,MAAM,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,IAAI,EAAE,aAAa,CAAC;IACpB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,GAAG,EAAE,MAAM,CAAC;IACZ,+FAA+F;IAC/F,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC;CACzB"}

package/build/ReactNativeDataDetector.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ReactNativeDataDetector.types.js.map

package/build/ReactNativeDataDetector.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReactNativeDataDetector.types.js","sourceRoot":"","sources":["../src/ReactNativeDataDetector.types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * The type of entity detected in the text.\n */\nexport type DetectionType =\n  | 'phoneNumber'\n  | 'link'\n  | 'email'\n  | 'address'\n  | 'date';\n\n/**\n * A single detected entity within the text.\n */\nexport interface DetectedEntity {\n  /** The type of detected entity. */\n  type: DetectionType;\n  /** The matched text substring. */\n  text: string;\n  /** Start index of the match in the original string. */\n  start: number;\n  /** End index (exclusive) of the match in the original string. */\n  end: number;\n  /** Additional data depending on the type (e.g., URL string, phone number, date ISO string). */\n  data?: Record<string, string>;\n}\n\n/**\n * Options for the detect function.\n */\nexport interface DetectOptions {\n  /** Which entity types to detect. Defaults to all types. */\n  types?: DetectionType[];\n}\n"]}

package/build/index.d.ts

@@ -0,0 +1,3 @@
+export { detect, downloadModel } from './ReactNativeDataDetector';
+export type { DetectedEntity, DetectionType, DetectOptions } from './ReactNativeDataDetector.types';
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAClE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC"}

package/build/index.js

@@ -0,0 +1,2 @@
+export { detect, downloadModel } from './ReactNativeDataDetector';
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC","sourcesContent":["export { detect, downloadModel } from './ReactNativeDataDetector';\nexport type { DetectedEntity, DetectionType, DetectOptions } from './ReactNativeDataDetector.types';\n"]}

package/expo-module.config.json

@@ -0,0 +1,9 @@
+{
+  "platforms": ["apple", "android"],
+  "apple": {
+    "modules": ["ReactNativeDataDetectorModule"]
+  },
+  "android": {
+    "modules": ["expo.modules.datadetector.ReactNativeDataDetectorModule"]
+  }
+}

package/ios/ReactNativeDataDetector.podspec

@@ -0,0 +1,21 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, '..', 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name           = 'ReactNativeDataDetector'
+  s.version        = package['version']
+  s.summary        = package['description']
+  s.description    = package['description']
+  s.license        = package['license']
+  s.author         = package['author']
+  s.homepage       = package['homepage']
+  s.platforms      = { :ios => '15.1' }
+  s.swift_version  = '5.9'
+  s.source         = { git: "#{package['repository']['url']}" }
+  s.static_framework = true
+
+  s.dependency 'ExpoModulesCore'
+
+  s.source_files = '**/*.swift'
+end

package/ios/ReactNativeDataDetectorModule.swift

@@ -0,0 +1,105 @@
+import ExpoModulesCore
+import Foundation
+
+public class ReactNativeDataDetectorModule: Module {
+  public func definition() -> ModuleDefinition {
+    Name("ReactNativeDataDetector")
+
+    // No-op on iOS — NSDataDetector requires no model download
+    AsyncFunction("downloadModel") { () -> Bool in
+      return true
+    }
+
+    AsyncFunction("detect") { (text: String, types: [String]) -> [[String: Any]] in
+      var checkingTypes: NSTextCheckingResult.CheckingType = []
+
+      for type in types {
+        switch type {
+        case "phoneNumber":
+          checkingTypes.insert(.phoneNumber)
+        case "link", "email":
+          checkingTypes.insert(.link)
+        case "address":
+          checkingTypes.insert(.address)
+        case "date":
+          checkingTypes.insert(.date)
+        default:
+          break
+        }
+      }
+
+      guard let detector = try? NSDataDetector(types: checkingTypes.rawValue) else {
+        return []
+      }
+
+      let range = NSRange(text.startIndex..., in: text)
+      let matches = detector.matches(in: text, options: [], range: range)
+
+      var results: [[String: Any]] = []
+
+      for match in matches {
+        guard let matchRange = Range(match.range, in: text) else { continue }
+        let matchedText = String(text[matchRange])
+
+        var type: String
+        var data: [String: String] = [:]
+
+        switch match.resultType {
+        case .phoneNumber:
+          guard types.contains("phoneNumber") else { continue }
+          type = "phoneNumber"
+          if let phone = match.phoneNumber {
+            data["phoneNumber"] = phone
+          }
+
+        case .link:
+          guard let url = match.url else { continue }
+          if url.scheme == "mailto" {
+            guard types.contains("email") else { continue }
+            type = "email"
+            data["email"] = url.absoluteString.replacingOccurrences(of: "mailto:", with: "")
+          } else {
+            guard types.contains("link") else { continue }
+            type = "link"
+            data["url"] = url.absoluteString
+          }
+
+        case .address:
+          guard types.contains("address") else { continue }
+          type = "address"
+          if let components = match.addressComponents {
+            if let street = components[.street] { data["street"] = street }
+            if let city = components[.city] { data["city"] = city }
+            if let state = components[.state] { data["state"] = state }
+            if let zip = components[.zip] { data["zip"] = zip }
+            if let country = components[.country] { data["country"] = country }
+          }
+
+        case .date:
+          guard types.contains("date") else { continue }
+          type = "date"
+          if let date = match.date {
+            let formatter = ISO8601DateFormatter()
+            data["date"] = formatter.string(from: date)
+          }
+
+        default:
+          continue
+        }
+
+        let start = text.distance(from: text.startIndex, to: matchRange.lowerBound)
+        let end = text.distance(from: text.startIndex, to: matchRange.upperBound)
+
+        results.append([
+          "type": type,
+          "text": matchedText,
+          "start": start,
+          "end": end,
+          "data": data,
+        ])
+      }
+
+      return results
+    }
+  }
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@themobilefirstcompany/react-native-data-detector",
+  "version": "0.1.0",
+  "description": "Cross-platform text data detection for React Native. Uses NSDataDetector on iOS and ML Kit Entity Extraction on Android to detect phone numbers, URLs, emails, dates, and addresses.",
+  "keywords": [
+    "react-native",
+    "expo",
+    "data-detector",
+    "nsdatadetector",
+    "mlkit",
+    "entity-extraction",
+    "phone-number",
+    "url",
+    "email",
+    "address",
+    "date"
+  ],
+  "homepage": "https://github.com/pablogdcr/react-native-data-detector#readme",
+  "bugs": {
+    "url": "https://github.com/pablogdcr/react-native-data-detector/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pablogdcr/react-native-data-detector.git"
+  },
+  "license": "MIT",
+  "author": "pablogdcr",
+  "type": "commonjs",
+  "main": "build/index.js",
+  "types": "build/index.d.ts",
+  "scripts": {
+    "build": "expo-module build",
+    "clean": "expo-module clean",
+    "lint": "expo-module lint",
+    "test": "expo-module test",
+    "prepare": "expo-module prepare",
+    "prepublishOnly": "expo-module prepublishOnly",
+    "expo-module": "expo-module"
+  },
+  "devDependencies": {
+    "expo-module-scripts": "^4.0.0",
+    "expo-modules-core": "^2.0.0",
+    "typescript": "^5.3.0"
+  },
+  "peerDependencies": {
+    "expo": "*",
+    "react": "*",
+    "react-native": "*"
+  }
+}

package/src/ReactNativeDataDetector.ts

@@ -0,0 +1,26 @@
+import { requireNativeModule } from 'expo-modules-core';
+
+import type { DetectedEntity, DetectOptions } from './ReactNativeDataDetector.types';
+
+const NativeModule = requireNativeModule('ReactNativeDataDetector');
+
+/**
+ * Pre-downloads the ML Kit entity extraction model on Android.
+ * No-op on iOS (NSDataDetector requires no model download).
+ * Call this at app startup to ensure `detect()` works offline later.
+ */
+export async function downloadModel(): Promise<boolean> {
+  return NativeModule.downloadModel();
+}
+
+/**
+ * Detects entities (phone numbers, URLs, emails, addresses, dates) in the given text
+ * using native platform APIs (NSDataDetector on iOS, ML Kit on Android).
+ */
+export async function detect(
+  text: string,
+  options?: DetectOptions
+): Promise<DetectedEntity[]> {
+  const types = options?.types ?? ['phoneNumber', 'link', 'email', 'address', 'date'];
+  return NativeModule.detect(text, types);
+}

package/src/ReactNativeDataDetector.types.ts

@@ -0,0 +1,33 @@
+/**
+ * The type of entity detected in the text.
+ */
+export type DetectionType =
+  | 'phoneNumber'
+  | 'link'
+  | 'email'
+  | 'address'
+  | 'date';
+
+/**
+ * A single detected entity within the text.
+ */
+export interface DetectedEntity {
+  /** The type of detected entity. */
+  type: DetectionType;
+  /** The matched text substring. */
+  text: string;
+  /** Start index of the match in the original string. */
+  start: number;
+  /** End index (exclusive) of the match in the original string. */
+  end: number;
+  /** Additional data depending on the type (e.g., URL string, phone number, date ISO string). */
+  data?: Record<string, string>;
+}
+
+/**
+ * Options for the detect function.
+ */
+export interface DetectOptions {
+  /** Which entity types to detect. Defaults to all types. */
+  types?: DetectionType[];
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export { detect, downloadModel } from './ReactNativeDataDetector';
+export type { DetectedEntity, DetectionType, DetectOptions } from './ReactNativeDataDetector.types';