react-native-text-reader 2.0.1 → 2.1.0

package/README.md

@@ -103,9 +103,53 @@ const result = await TextReader.readDetailed(imagePath, {
 
 console.log(result.fullText);
 console.log(result.lines);
-console.log(result.details); // confidence, frame, languages
+console.log(result.details); // confidence, box, words, languages
 ```
 
+### Documents (ID cards, forms)
+
+`readDocument()` applies the settings that printed documents need: `accurate`
+recognition, **language correction off** — it would otherwise push codes like an
+MRZ or a Mexican CURP toward dictionary words — and word-level boxes.
+
+```typescript
+const result = await TextReader.readDocument(imagePath);
+
+for (const line of result.details) {
+  console.log(line.text, line.box); // { x, y, width, height }, 0-1
+  for (const word of line.words ?? []) {
+    console.log(' ', word.text, word.box);
+  }
+}
+```
+
+### Layout: `box` vs `frame`
+
+`box` is a normalized rect (`0-1`) with a **top-left origin**, identical on both
+platforms. Use it to reason about layout — columns, reading order, which value
+sits under which label:
+
+```typescript
+// Value in the same column as its label, rather than "the next line"
+const label = result.details.find((line) => line.text.includes('VIGENCIA'));
+const value = result.details.find(
+  (line) =>
+    line.box && label?.box &&
+    line.box.y > label.box.y &&
+    Math.abs(line.box.x - label.box.x) < 0.05
+);
+```
+
+> `frame` is **deprecated**. Its units and origin differ per platform (iOS:
+> normalized ×1000, bottom-left; Android: pixels, top-left), so it was never
+> comparable across platforms. It still ships unchanged for existing callers.
+
+### Confidence
+
+`confidence` is `undefined` when the engine reports no value — it is never
+filled in with a placeholder. Absence of a measurement is not a low
+measurement, and a fabricated `1.0` reads downstream as maximum certainty.
+
 ## Options
 
 | Property | Type | Platform | Description |
@@ -118,6 +162,8 @@ console.log(result.details); // confidence, frame, languages
 | `customWords` | `string[]` | iOS | Domain vocabulary hints |
 | `useLanguageCorrection` | `boolean` | iOS | Enable language correction |
 | `minimumTextHeight` | `number` | iOS | Ignore text smaller than this fraction |
+| `includeWords` | `boolean` | Both | Return each word with its own `box` and confidence |
+| `regionOfInterest` | `TextBox` | Both | Restrict recognition to a normalized area (`0-1`, top-left origin) |
 
 ## ScriptOptions
 

package/android/src/main/java/com/textreader/TextReaderModule.kt

@@ -38,35 +38,65 @@ class TextReaderModule(reactContext: ReactApplicationContext) :
   override fun getName(): String = "TextReader"
 
   @Throws(IOException::class)
-  private fun getInputImage(reactContext: ReactApplicationContext, url: String): InputImage {
-    return if (url.contains("http://") || url.contains("https://")) {
-      val connection = URL(url).openConnection() as HttpURLConnection
-      connection.connectTimeout = HTTP_CONNECT_TIMEOUT_MS
-      connection.readTimeout = HTTP_READ_TIMEOUT_MS
-      connection.connect()
-
-      val contentLength = connection.contentLength
-      if (contentLength > MAX_IMAGE_BYTES) {
-        connection.disconnect()
-        throw IOException("Remote image exceeds maximum allowed size.")
-      }
+  private fun remoteBitmap(url: String): Bitmap {
+    val connection = URL(url).openConnection() as HttpURLConnection
+    connection.connectTimeout = HTTP_CONNECT_TIMEOUT_MS
+    connection.readTimeout = HTTP_READ_TIMEOUT_MS
+    connection.connect()
 
-      val image: Bitmap? = connection.inputStream.use { stream ->
-        BitmapFactory.decodeStream(stream)
-      }
+    val contentLength = connection.contentLength
+    if (contentLength > MAX_IMAGE_BYTES) {
       connection.disconnect()
+      throw IOException("Remote image exceeds maximum allowed size.")
+    }
 
-      if (image == null) {
-        throw IOException("Failed to decode remote image.")
-      }
+    val image: Bitmap? = connection.inputStream.use { stream ->
+      BitmapFactory.decodeStream(stream)
+    }
+    connection.disconnect()
+
+    return image ?: throw IOException("Failed to decode remote image.")
+  }
 
-      InputImage.fromBitmap(image, 0)
+  @Throws(IOException::class)
+  private fun getInputImage(reactContext: ReactApplicationContext, url: String): InputImage {
+    return if (url.contains("http://") || url.contains("https://")) {
+      InputImage.fromBitmap(remoteBitmap(url), 0)
     } else {
       val uri = Uri.parse(url)
       InputImage.fromFilePath(reactContext, uri)
     }
   }
 
+  private fun croppedInputImage(
+    reactContext: ReactApplicationContext,
+    url: String,
+    region: ReadableMap
+  ): InputImage {
+    val bitmap = loadBitmap(reactContext, url)
+    val x = (region.getDouble("x") * bitmap.width).toInt().coerceIn(0, bitmap.width - 1)
+    val y = (region.getDouble("y") * bitmap.height).toInt().coerceIn(0, bitmap.height - 1)
+    val width = (region.getDouble("width") * bitmap.width).toInt()
+      .coerceIn(1, bitmap.width - x)
+    val height = (region.getDouble("height") * bitmap.height).toInt()
+      .coerceIn(1, bitmap.height - y)
+
+    return InputImage.fromBitmap(Bitmap.createBitmap(bitmap, x, y, width, height), 0)
+  }
+
+  @Throws(IOException::class)
+  private fun loadBitmap(reactContext: ReactApplicationContext, url: String): Bitmap {
+    if (url.contains("http://") || url.contains("https://")) {
+      return remoteBitmap(url)
+    }
+
+    val stream = reactContext.contentResolver.openInputStream(Uri.parse(url))
+      ?: throw IOException("Could not open image at $url")
+
+    return stream.use { BitmapFactory.decodeStream(it) }
+      ?: throw IOException("Failed to decode image at $url")
+  }
+
   private fun rectToMap(rect: Rect): WritableMap {
     return Arguments.createMap().apply {
       putInt("width", rect.width())
@@ -95,24 +125,37 @@ class TextReaderModule(reactContext: ReactApplicationContext) :
     }
   }
 
-  private fun lineConfidence(line: Text.Line): Float {
-    val elements = line.elements
-    if (elements.isEmpty()) return 1.0f
-    return elements.map { element ->
-      try {
-        val method = element.javaClass.getMethod("getConfidence")
-        (method.invoke(element) as? Float) ?: 1.0f
-      } catch (_: Exception) {
-        1.0f
-      }
-    }.average().toFloat()
+  private fun lineConfidence(line: Text.Line): Float? {
+    val confidences = line.elements.mapNotNull { it.confidence }
+    if (confidences.isEmpty()) {
+      return null
+    }
+    return confidences.average().toFloat()
+  }
+
+  private fun normalizedBox(rect: Rect?, width: Int, height: Int): WritableMap? {
+    if (rect == null || width <= 0 || height <= 0) {
+      return null
+    }
+    return Arguments.createMap().apply {
+      putDouble("x", rect.left.toDouble() / width)
+      putDouble("y", rect.top.toDouble() / height)
+      putDouble("width", rect.width().toDouble() / width)
+      putDouble("height", rect.height().toDouble() / height)
+    }
   }
 
-  private fun lineToMap(line: Text.Line): WritableMap {
+  private fun lineToMap(
+    line: Text.Line,
+    imageWidth: Int,
+    imageHeight: Int,
+    includeWords: Boolean
+  ): WritableMap {
     return Arguments.createMap().apply {
       putString("text", line.text)
-      putDouble("confidence", lineConfidence(line).toDouble())
+      lineConfidence(line)?.let { putDouble("confidence", it.toDouble()) }
       line.boundingBox?.let { putMap("frame", rectToMap(it)) }
+      normalizedBox(line.boundingBox, imageWidth, imageHeight)?.let { putMap("box", it) }
       line.cornerPoints?.let { putArray("cornerPoints", cornerPointsToMap(it)) }
       putArray("recognizedLanguages", langToMap(line.recognizedLanguage))
 
@@ -125,6 +168,20 @@ class TextReaderModule(reactContext: ReactApplicationContext) :
         })
       }
       putArray("elements", elementsArray)
+
+      if (includeWords) {
+        val wordsArray = Arguments.createArray()
+        line.elements.forEach { element ->
+          wordsArray.pushMap(Arguments.createMap().apply {
+            putString("text", element.text)
+            normalizedBox(element.boundingBox, imageWidth, imageHeight)?.let {
+              putMap("box", it)
+            }
+            element.confidence?.let { putDouble("confidence", it.toDouble()) }
+          })
+        }
+        putArray("words", wordsArray)
+      }
     }
   }
 
@@ -157,7 +214,7 @@ class TextReaderModule(reactContext: ReactApplicationContext) :
   private fun sortedLines(visionText: Text, confidenceThreshold: Float): List<Text.Line> {
     return visionText.textBlocks
       .flatMap { block -> block.lines }
-      .filter { line -> lineConfidence(line) >= confidenceThreshold }
+      .filter { line -> (lineConfidence(line) ?: Float.MAX_VALUE) >= confidenceThreshold }
       .sortedWith(compareBy({ it.boundingBox?.top ?: 0 }, { it.boundingBox?.left ?: 0 }))
   }
 
@@ -179,15 +236,36 @@ class TextReaderModule(reactContext: ReactApplicationContext) :
       0.0f
     }
 
+    val includeWords = options?.hasKey("includeWords") == true &&
+      options.getBoolean("includeWords")
+
     val recognizer: TextRecognizer = TextRecognition.getClient(getScriptTextRecognizerOptions(script))
 
     try {
-      val image = getInputImage(reactApplicationContext, url)
+      val region = if (options?.hasKey("regionOfInterest") == true) {
+        options.getMap("regionOfInterest")
+      } else {
+        null
+      }
+      val image = if (region != null) {
+        croppedInputImage(reactApplicationContext, url, region)
+      } else {
+        getInputImage(reactApplicationContext, url)
+      }
+
       recognizer.process(image)
         .addOnSuccessListener { visionText ->
           val lines = sortedLines(visionText, confidenceThreshold)
           if (detailed) {
-            promise.resolve(buildDetailedResult(visionText, lines))
+            promise.resolve(
+              buildDetailedResult(
+                visionText,
+                lines,
+                image.width,
+                image.height,
+                includeWords
+              )
+            )
           } else {
             val linesArray = Arguments.createArray()
             lines.forEach { line -> linesArray.pushString(line.text) }
@@ -209,11 +287,17 @@ class TextReaderModule(reactContext: ReactApplicationContext) :
     }
   }
 
-  private fun buildDetailedResult(visionText: Text, lines: List<Text.Line>): WritableMap {
+  private fun buildDetailedResult(
+    visionText: Text,
+    lines: List<Text.Line>,
+    imageWidth: Int,
+    imageHeight: Int,
+    includeWords: Boolean
+  ): WritableMap {
     val lineTexts = lines.map { it.text }
     val detailsArray = Arguments.createArray()
     lines.forEach { line ->
-      detailsArray.pushMap(lineToMap(line))
+      detailsArray.pushMap(lineToMap(line, imageWidth, imageHeight, includeWords))
     }
 
     return Arguments.createMap().apply {
@@ -222,6 +306,7 @@ class TextReaderModule(reactContext: ReactApplicationContext) :
         lineTexts.forEach { pushString(it) }
       })
       putArray("details", detailsArray)
+      putString("coordinateSpace", "normalized-top-left")
     }
   }
 

package/ios/TextReader.swift

@@ -8,10 +8,26 @@ extension String {
   }
 }
 
+private struct RecognizedWord {
+  let text: String
+  let confidence: Float
+  let box: CGRect
+}
+
 private struct RecognizedLine {
   let text: String
   let confidence: Float
   let frame: CGRect
+  let words: [RecognizedWord]
+}
+
+private func normalizedBoxPayload(_ box: CGRect) -> [String: Any] {
+  return [
+    "x": box.origin.x,
+    "y": 1.0 - box.origin.y - box.height,
+    "width": box.width,
+    "height": box.height,
+  ]
 }
 
 private struct TextCandidate {
@@ -54,6 +70,7 @@ class TextReader: NSObject {
       switch result {
       case .success(let lines):
         let lineTexts = lines.map { $0.text }
+        let includeWords = (options["includeWords"] as? Bool) ?? false
         let details: [[String: Any]] = lines.map { line in
           var detail: [String: Any] = [
             "text": line.text,
@@ -65,12 +82,23 @@ class TextReader: NSObject {
             "width": Int(line.frame.width * 1000),
             "height": Int(line.frame.height * 1000),
           ]
+          detail["box"] = normalizedBoxPayload(line.frame)
+          if includeWords {
+            detail["words"] = line.words.map { word in
+              [
+                "text": word.text,
+                "confidence": word.confidence,
+                "box": normalizedBoxPayload(word.box),
+              ] as [String: Any]
+            }
+          }
           return detail
         }
         resolve([
           "fullText": lineTexts.joined(separator: "\n"),
           "lines": lineTexts,
           "details": details,
+          "coordinateSpace": "normalized-top-left",
         ])
       case .failure(let error):
         reject(error.code, error.message, error.underlying)
@@ -150,6 +178,19 @@ class TextReader: NSObject {
       request.recognitionLanguages = languages
     }
 
+    if let roi = options["regionOfInterest"] as? [String: Any],
+       let x = roi["x"] as? NSNumber,
+       let y = roi["y"] as? NSNumber,
+       let width = roi["width"] as? NSNumber,
+       let height = roi["height"] as? NSNumber {
+      request.regionOfInterest = CGRect(
+        x: CGFloat(truncating: x),
+        y: 1.0 - CGFloat(truncating: y) - CGFloat(truncating: height),
+        width: CGFloat(truncating: width),
+        height: CGFloat(truncating: height)
+      )
+    }
+
     if let customWords = options["customWords"] as? [String], !customWords.isEmpty {
       request.customWords = customWords
     }
@@ -228,6 +269,9 @@ class TextReader: NSObject {
     let maxX = sortedGroup.map { $0.box.maxX }.max() ?? 0
     let maxY = sortedGroup.map { $0.box.maxY }.max() ?? 0
     let frame = CGRect(x: minX, y: minY, width: maxX - minX, height: maxY - minY)
-    return RecognizedLine(text: text, confidence: confidence, frame: frame)
+    let words = sortedGroup.map {
+      RecognizedWord(text: $0.text, confidence: $0.confidence, box: $0.box)
+    }
+    return RecognizedLine(text: text, confidence: confidence, frame: frame, words: words)
   }
 }

package/lib/commonjs/NativeTextReader.js.map

@@ -1 +1 @@
-{"version":3,"names":["_reactNative","require","_default","exports","default","TurboModuleRegistry","get"],"sourceRoot":"../../src","sources":["NativeTextReader.ts"],"mappings":";;;;;;AACA,IAAAA,YAAA,GAAAC,OAAA;AAAmD,IAAAC,QAAA,GAAAC,OAAA,CAAAC,OAAA,GAuCpCC,gCAAmB,CAACC,GAAG,CAAO,YAAY,CAAC","ignoreList":[]}
+{"version":3,"names":["_reactNative","require","_default","exports","default","TurboModuleRegistry","get"],"sourceRoot":"../../src","sources":["NativeTextReader.ts"],"mappings":";;;;;;AACA,IAAAA,YAAA,GAAAC,OAAA;AAAmD,IAAAC,QAAA,GAAAC,OAAA,CAAAC,OAAA,GA8DpCC,gCAAmB,CAACC,GAAG,CAAO,YAAY,CAAC","ignoreList":[]}

package/lib/commonjs/index.js

@@ -25,6 +25,10 @@ let ScriptOptions = exports.ScriptOptions = /*#__PURE__*/function (ScriptOptions
   ScriptOptions["KOREAN"] = "Korean";
   return ScriptOptions;
 }({});
+/**
+ * @deprecated Sus unidades y su origen difieren entre plataformas, así que no
+ * es comparable cross-platform. Usa `TextLine.box`.
+ */
 const DEFAULT_OPTIONS = {
   script: ScriptOptions.LATIN
 };
@@ -32,14 +36,24 @@ function normalizeDetailedResult(result) {
   return {
     fullText: result.fullText ?? '',
     lines: result.lines ?? [],
+    coordinateSpace: result.coordinateSpace,
     details: (result.details ?? []).map(detail => ({
       text: detail.text,
       confidence: detail.confidence,
       frame: detail.frame,
+      box: detail.box,
+      words: detail.words,
       recognizedLanguages: detail.recognizedLanguages
     }))
   };
 }
+const DOCUMENT_OPTIONS = {
+  script: ScriptOptions.LATIN,
+  recognitionLevel: 'accurate',
+  useLanguageCorrection: false,
+  minimumTextHeight: 0.008,
+  includeWords: true
+};
 
 /**
  * Extracts text lines from an image.
@@ -56,8 +70,15 @@ async function readDetailed(imagePath, options) {
   const result = await TextReader.readDetailed(imagePath, options ?? DEFAULT_OPTIONS);
   return normalizeDetailedResult(result);
 }
+async function readDocument(imagePath, options) {
+  return readDetailed(imagePath, {
+    ...DOCUMENT_OPTIONS,
+    ...options
+  });
+}
 var _default = exports.default = {
   read,
-  readDetailed
+  readDetailed,
+  readDocument
 };
 //# sourceMappingURL=index.js.map

package/lib/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_reactNative","require","_NativeTextReader","_interopRequireDefault","e","__esModule","default","LINKING_ERROR","Platform","select","ios","TextReaderModule","NativeTextReaderModule","NativeModules","TextReader","Proxy","get","Error","ScriptOptions","exports","DEFAULT_OPTIONS","script","LATIN","normalizeDetailedResult","result","fullText","lines","details","map","detail","text","confidence","frame","recognizedLanguages","read","imagePath","options","detailed","readDetailed","_default"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AACA,IAAAC,iBAAA,GAAAC,sBAAA,CAAAF,OAAA;AAAwD,SAAAE,uBAAAC,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAExD,MAAMG,aAAa,GACjB,mFAAmF,GACnFC,qBAAQ,CAACC,MAAM,CAAC;EAAEC,GAAG,EAAE,gCAAgC;EAAEJ,OAAO,EAAE;AAAG,CAAC,CAAC,GACvE,sDAAsD,GACtD,iEAAiE;AAEnE,MAAMK,gBAAgB,GAAGC,yBAAsB,IAAIC,0BAAa,CAACC,UAAU;AAE3E,MAAMA,UAAU,GAAGH,gBAAgB,GAC/BA,gBAAgB,GAChB,IAAII,KAAK,CACP,CAAC,CAAC,EACF;EACEC,GAAGA,CAAA,EAAG;IACJ,MAAM,IAAIC,KAAK,CAACV,aAAa,CAAC;EAChC;AACF,CACF,CAAC;AAAC,IAEMW,aAAa,GAAAC,OAAA,CAAAD,aAAA,0BAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;EAAA,OAAbA,aAAa;AAAA;AA8CzB,MAAME,eAAwB,GAAG;EAC/BC,MAAM,EAAEH,aAAa,CAACI;AACxB,CAAC;AAED,SAASC,uBAAuBA,CAACC,MAAsB,EAAkB;EACvE,OAAO;IACLC,QAAQ,EAAED,MAAM,CAACC,QAAQ,IAAI,EAAE;IAC/BC,KAAK,EAAEF,MAAM,CAACE,KAAK,IAAI,EAAE;IACzBC,OAAO,EAAE,CAACH,MAAM,CAACG,OAAO,IAAI,EAAE,EAAEC,GAAG,CAAEC,MAAM,KAAM;MAC/CC,IAAI,EAAED,MAAM,CAACC,IAAI;MACjBC,UAAU,EAAEF,MAAM,CAACE,UAAU;MAC7BC,KAAK,EAAEH,MAAM,CAACG,KAAK;MACnBC,mBAAmB,EAAEJ,MAAM,CAACI;IAC9B,CAAC,CAAC;EACJ,CAAC;AACH;;AAEA;AACA;AACA;AACA,eAAeC,IAAIA,CAACC,SAAiB,EAAEC,OAAiB,EAAqB;EAC3E,MAAMC,QAAQ,GAAG,MAAMC,YAAY,CAACH,SAAS,EAAEC,OAAO,CAAC;EACvD,OAAOC,QAAQ,CAACX,KAAK;AACvB;;AAEA;AACA;AACA;AACA,eAAeY,YAAYA,CACzBH,SAAiB,EACjBC,OAAiB,EACQ;EACzB,MAAMZ,MAAM,GAAG,MAAMV,UAAU,CAACwB,YAAY,CAC1CH,SAAS,EACTC,OAAO,IAAIhB,eACb,CAAC;EACD,OAAOG,uBAAuB,CAACC,MAAM,CAAC;AACxC;AAAC,IAAAe,QAAA,GAAApB,OAAA,CAAAb,OAAA,GAEc;EAAE4B,IAAI;EAAEI;AAAa,CAAC","ignoreList":[]}
+{"version":3,"names":["_reactNative","require","_NativeTextReader","_interopRequireDefault","e","__esModule","default","LINKING_ERROR","Platform","select","ios","TextReaderModule","NativeTextReaderModule","NativeModules","TextReader","Proxy","get","Error","ScriptOptions","exports","DEFAULT_OPTIONS","script","LATIN","normalizeDetailedResult","result","fullText","lines","coordinateSpace","details","map","detail","text","confidence","frame","box","words","recognizedLanguages","DOCUMENT_OPTIONS","recognitionLevel","useLanguageCorrection","minimumTextHeight","includeWords","read","imagePath","options","detailed","readDetailed","readDocument","_default"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AACA,IAAAC,iBAAA,GAAAC,sBAAA,CAAAF,OAAA;AAAwD,SAAAE,uBAAAC,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAExD,MAAMG,aAAa,GACjB,mFAAmF,GACnFC,qBAAQ,CAACC,MAAM,CAAC;EAAEC,GAAG,EAAE,gCAAgC;EAAEJ,OAAO,EAAE;AAAG,CAAC,CAAC,GACvE,sDAAsD,GACtD,iEAAiE;AAEnE,MAAMK,gBAAgB,GAAGC,yBAAsB,IAAIC,0BAAa,CAACC,UAAU;AAE3E,MAAMA,UAAU,GAAGH,gBAAgB,GAC/BA,gBAAgB,GAChB,IAAII,KAAK,CACP,CAAC,CAAC,EACF;EACEC,GAAGA,CAAA,EAAG;IACJ,MAAM,IAAIC,KAAK,CAACV,aAAa,CAAC;EAChC;AACF,CACF,CAAC;AAAC,IAEMW,aAAa,GAAAC,OAAA,CAAAD,aAAA,0BAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;EAAA,OAAbA,aAAa;AAAA;AAUzB;AACA;AACA;AACA;AAoEA,MAAME,eAAwB,GAAG;EAC/BC,MAAM,EAAEH,aAAa,CAACI;AACxB,CAAC;AAED,SAASC,uBAAuBA,CAACC,MAAsB,EAAkB;EACvE,OAAO;IACLC,QAAQ,EAAED,MAAM,CAACC,QAAQ,IAAI,EAAE;IAC/BC,KAAK,EAAEF,MAAM,CAACE,KAAK,IAAI,EAAE;IACzBC,eAAe,EAAEH,MAAM,CAACG,eAAe;IACvCC,OAAO,EAAE,CAACJ,MAAM,CAACI,OAAO,IAAI,EAAE,EAAEC,GAAG,CAAEC,MAAM,KAAM;MAC/CC,IAAI,EAAED,MAAM,CAACC,IAAI;MACjBC,UAAU,EAAEF,MAAM,CAACE,UAAU;MAC7BC,KAAK,EAAEH,MAAM,CAACG,KAAK;MACnBC,GAAG,EAAEJ,MAAM,CAACI,GAAG;MACfC,KAAK,EAAEL,MAAM,CAACK,KAAK;MACnBC,mBAAmB,EAAEN,MAAM,CAACM;IAC9B,CAAC,CAAC;EACJ,CAAC;AACH;AAEA,MAAMC,gBAAyB,GAAG;EAChChB,MAAM,EAAEH,aAAa,CAACI,KAAK;EAC3BgB,gBAAgB,EAAE,UAAU;EAC5BC,qBAAqB,EAAE,KAAK;EAC5BC,iBAAiB,EAAE,KAAK;EACxBC,YAAY,EAAE;AAChB,CAAC;;AAED;AACA;AACA;AACA,eAAeC,IAAIA,CAACC,SAAiB,EAAEC,OAAiB,EAAqB;EAC3E,MAAMC,QAAQ,GAAG,MAAMC,YAAY,CAACH,SAAS,EAAEC,OAAO,CAAC;EACvD,OAAOC,QAAQ,CAACnB,KAAK;AACvB;;AAEA;AACA;AACA;AACA,eAAeoB,YAAYA,CACzBH,SAAiB,EACjBC,OAAiB,EACQ;EACzB,MAAMpB,MAAM,GAAG,MAAMV,UAAU,CAACgC,YAAY,CAC1CH,SAAS,EACTC,OAAO,IAAIxB,eACb,CAAC;EACD,OAAOG,uBAAuB,CAACC,MAAM,CAAC;AACxC;AAEA,eAAeuB,YAAYA,CACzBJ,SAAiB,EACjBC,OAAiB,EACQ;EACzB,OAAOE,YAAY,CAACH,SAAS,EAAE;IAAE,GAAGN,gBAAgB;IAAE,GAAGO;EAAQ,CAAC,CAAC;AACrE;AAAC,IAAAI,QAAA,GAAA7B,OAAA,CAAAb,OAAA,GAEc;EAAEoC,IAAI;EAAEI,YAAY;EAAEC;AAAa,CAAC","ignoreList":[]}

package/lib/module/NativeTextReader.js.map

@@ -1 +1 @@
-{"version":3,"names":["TurboModuleRegistry","get"],"sourceRoot":"../../src","sources":["NativeTextReader.ts"],"mappings":";;AACA,SAASA,mBAAmB,QAAQ,cAAc;AAuClD,eAAeA,mBAAmB,CAACC,GAAG,CAAO,YAAY,CAAC","ignoreList":[]}
+{"version":3,"names":["TurboModuleRegistry","get"],"sourceRoot":"../../src","sources":["NativeTextReader.ts"],"mappings":";;AACA,SAASA,mBAAmB,QAAQ,cAAc;AA8DlD,eAAeA,mBAAmB,CAACC,GAAG,CAAO,YAAY,CAAC","ignoreList":[]}

package/lib/module/index.js

@@ -20,6 +20,12 @@ export let ScriptOptions = /*#__PURE__*/function (ScriptOptions) {
   ScriptOptions["KOREAN"] = "Korean";
   return ScriptOptions;
 }({});
+
+/**
+ * @deprecated Sus unidades y su origen difieren entre plataformas, así que no
+ * es comparable cross-platform. Usa `TextLine.box`.
+ */
+
 const DEFAULT_OPTIONS = {
   script: ScriptOptions.LATIN
 };
@@ -27,14 +33,24 @@ function normalizeDetailedResult(result) {
   return {
     fullText: result.fullText ?? '',
     lines: result.lines ?? [],
+    coordinateSpace: result.coordinateSpace,
     details: (result.details ?? []).map(detail => ({
       text: detail.text,
       confidence: detail.confidence,
       frame: detail.frame,
+      box: detail.box,
+      words: detail.words,
       recognizedLanguages: detail.recognizedLanguages
     }))
   };
 }
+const DOCUMENT_OPTIONS = {
+  script: ScriptOptions.LATIN,
+  recognitionLevel: 'accurate',
+  useLanguageCorrection: false,
+  minimumTextHeight: 0.008,
+  includeWords: true
+};
 
 /**
  * Extracts text lines from an image.
@@ -51,8 +67,15 @@ async function readDetailed(imagePath, options) {
   const result = await TextReader.readDetailed(imagePath, options ?? DEFAULT_OPTIONS);
   return normalizeDetailedResult(result);
 }
+async function readDocument(imagePath, options) {
+  return readDetailed(imagePath, {
+    ...DOCUMENT_OPTIONS,
+    ...options
+  });
+}
 export default {
   read,
-  readDetailed
+  readDetailed,
+  readDocument
 };
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativeModules","Platform","NativeTextReaderModule","LINKING_ERROR","select","ios","default","TextReaderModule","TextReader","Proxy","get","Error","ScriptOptions","DEFAULT_OPTIONS","script","LATIN","normalizeDetailedResult","result","fullText","lines","details","map","detail","text","confidence","frame","recognizedLanguages","read","imagePath","options","detailed","readDetailed"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,SAASA,aAAa,EAAEC,QAAQ,QAAQ,cAAc;AACtD,OAAOC,sBAAsB,MAAM,uBAAoB;AAEvD,MAAMC,aAAa,GACjB,mFAAmF,GACnFF,QAAQ,CAACG,MAAM,CAAC;EAAEC,GAAG,EAAE,gCAAgC;EAAEC,OAAO,EAAE;AAAG,CAAC,CAAC,GACvE,sDAAsD,GACtD,iEAAiE;AAEnE,MAAMC,gBAAgB,GAAGL,sBAAsB,IAAIF,aAAa,CAACQ,UAAU;AAE3E,MAAMA,UAAU,GAAGD,gBAAgB,GAC/BA,gBAAgB,GAChB,IAAIE,KAAK,CACP,CAAC,CAAC,EACF;EACEC,GAAGA,CAAA,EAAG;IACJ,MAAM,IAAIC,KAAK,CAACR,aAAa,CAAC;EAChC;AACF,CACF,CAAC;AAEL,WAAYS,aAAa,0BAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;EAAA,OAAbA,aAAa;AAAA;AA8CzB,MAAMC,eAAwB,GAAG;EAC/BC,MAAM,EAAEF,aAAa,CAACG;AACxB,CAAC;AAED,SAASC,uBAAuBA,CAACC,MAAsB,EAAkB;EACvE,OAAO;IACLC,QAAQ,EAAED,MAAM,CAACC,QAAQ,IAAI,EAAE;IAC/BC,KAAK,EAAEF,MAAM,CAACE,KAAK,IAAI,EAAE;IACzBC,OAAO,EAAE,CAACH,MAAM,CAACG,OAAO,IAAI,EAAE,EAAEC,GAAG,CAAEC,MAAM,KAAM;MAC/CC,IAAI,EAAED,MAAM,CAACC,IAAI;MACjBC,UAAU,EAAEF,MAAM,CAACE,UAAU;MAC7BC,KAAK,EAAEH,MAAM,CAACG,KAAK;MACnBC,mBAAmB,EAAEJ,MAAM,CAACI;IAC9B,CAAC,CAAC;EACJ,CAAC;AACH;;AAEA;AACA;AACA;AACA,eAAeC,IAAIA,CAACC,SAAiB,EAAEC,OAAiB,EAAqB;EAC3E,MAAMC,QAAQ,GAAG,MAAMC,YAAY,CAACH,SAAS,EAAEC,OAAO,CAAC;EACvD,OAAOC,QAAQ,CAACX,KAAK;AACvB;;AAEA;AACA;AACA;AACA,eAAeY,YAAYA,CACzBH,SAAiB,EACjBC,OAAiB,EACQ;EACzB,MAAMZ,MAAM,GAAG,MAAMT,UAAU,CAACuB,YAAY,CAC1CH,SAAS,EACTC,OAAO,IAAIhB,eACb,CAAC;EACD,OAAOG,uBAAuB,CAACC,MAAM,CAAC;AACxC;AAEA,eAAe;EAAEU,IAAI;EAAEI;AAAa,CAAC","ignoreList":[]}
+{"version":3,"names":["NativeModules","Platform","NativeTextReaderModule","LINKING_ERROR","select","ios","default","TextReaderModule","TextReader","Proxy","get","Error","ScriptOptions","DEFAULT_OPTIONS","script","LATIN","normalizeDetailedResult","result","fullText","lines","coordinateSpace","details","map","detail","text","confidence","frame","box","words","recognizedLanguages","DOCUMENT_OPTIONS","recognitionLevel","useLanguageCorrection","minimumTextHeight","includeWords","read","imagePath","options","detailed","readDetailed","readDocument"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,SAASA,aAAa,EAAEC,QAAQ,QAAQ,cAAc;AACtD,OAAOC,sBAAsB,MAAM,uBAAoB;AAEvD,MAAMC,aAAa,GACjB,mFAAmF,GACnFF,QAAQ,CAACG,MAAM,CAAC;EAAEC,GAAG,EAAE,gCAAgC;EAAEC,OAAO,EAAE;AAAG,CAAC,CAAC,GACvE,sDAAsD,GACtD,iEAAiE;AAEnE,MAAMC,gBAAgB,GAAGL,sBAAsB,IAAIF,aAAa,CAACQ,UAAU;AAE3E,MAAMA,UAAU,GAAGD,gBAAgB,GAC/BA,gBAAgB,GAChB,IAAIE,KAAK,CACP,CAAC,CAAC,EACF;EACEC,GAAGA,CAAA,EAAG;IACJ,MAAM,IAAIC,KAAK,CAACR,aAAa,CAAC;EAChC;AACF,CACF,CAAC;AAEL,WAAYS,aAAa,0BAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;EAAbA,aAAa;EAAA,OAAbA,aAAa;AAAA;;AAUzB;AACA;AACA;AACA;;AAoEA,MAAMC,eAAwB,GAAG;EAC/BC,MAAM,EAAEF,aAAa,CAACG;AACxB,CAAC;AAED,SAASC,uBAAuBA,CAACC,MAAsB,EAAkB;EACvE,OAAO;IACLC,QAAQ,EAAED,MAAM,CAACC,QAAQ,IAAI,EAAE;IAC/BC,KAAK,EAAEF,MAAM,CAACE,KAAK,IAAI,EAAE;IACzBC,eAAe,EAAEH,MAAM,CAACG,eAAe;IACvCC,OAAO,EAAE,CAACJ,MAAM,CAACI,OAAO,IAAI,EAAE,EAAEC,GAAG,CAAEC,MAAM,KAAM;MAC/CC,IAAI,EAAED,MAAM,CAACC,IAAI;MACjBC,UAAU,EAAEF,MAAM,CAACE,UAAU;MAC7BC,KAAK,EAAEH,MAAM,CAACG,KAAK;MACnBC,GAAG,EAAEJ,MAAM,CAACI,GAAG;MACfC,KAAK,EAAEL,MAAM,CAACK,KAAK;MACnBC,mBAAmB,EAAEN,MAAM,CAACM;IAC9B,CAAC,CAAC;EACJ,CAAC;AACH;AAEA,MAAMC,gBAAyB,GAAG;EAChChB,MAAM,EAAEF,aAAa,CAACG,KAAK;EAC3BgB,gBAAgB,EAAE,UAAU;EAC5BC,qBAAqB,EAAE,KAAK;EAC5BC,iBAAiB,EAAE,KAAK;EACxBC,YAAY,EAAE;AAChB,CAAC;;AAED;AACA;AACA;AACA,eAAeC,IAAIA,CAACC,SAAiB,EAAEC,OAAiB,EAAqB;EAC3E,MAAMC,QAAQ,GAAG,MAAMC,YAAY,CAACH,SAAS,EAAEC,OAAO,CAAC;EACvD,OAAOC,QAAQ,CAACnB,KAAK;AACvB;;AAEA;AACA;AACA;AACA,eAAeoB,YAAYA,CACzBH,SAAiB,EACjBC,OAAiB,EACQ;EACzB,MAAMpB,MAAM,GAAG,MAAMT,UAAU,CAAC+B,YAAY,CAC1CH,SAAS,EACTC,OAAO,IAAIxB,eACb,CAAC;EACD,OAAOG,uBAAuB,CAACC,MAAM,CAAC;AACxC;AAEA,eAAeuB,YAAYA,CACzBJ,SAAiB,EACjBC,OAAiB,EACQ;EACzB,OAAOE,YAAY,CAACH,SAAS,EAAE;IAAE,GAAGN,gBAAgB;IAAE,GAAGO;EAAQ,CAAC,CAAC;AACrE;AAEA,eAAe;EAAEF,IAAI;EAAEI,YAAY;EAAEC;AAAa,CAAC","ignoreList":[]}

package/lib/typescript/commonjs/src/NativeTextReader.d.ts

@@ -8,22 +8,43 @@ export type NativeOptions = {
     customWords?: string[];
     useLanguageCorrection?: boolean;
     minimumTextHeight?: number;
+    includeWords?: boolean;
+    regionOfInterest?: NativeBox;
+};
+export type NativeBox = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export type NativeWord = {
+    text: string;
+    box?: NativeBox;
+    confidence?: number;
 };
 export type NativeTextLine = {
     text: string;
     confidence?: number;
+    /**
+     * @deprecated Sus unidades y su origen difieren entre plataformas (iOS:
+     * normalizado x1000 con origen abajo; Android: píxeles con origen arriba),
+     * así que no es comparable cross-platform. Usa `box`.
+     */
     frame?: {
         top: number;
         left: number;
         width: number;
         height: number;
     };
+    box?: NativeBox;
+    words?: NativeWord[];
     recognizedLanguages?: string[];
 };
 export type NativeDetailedResult = {
     fullText: string;
     lines: string[];
     details: NativeTextLine[];
+    coordinateSpace?: 'normalized-top-left';
 };
 export interface Spec extends TurboModule {
     read(imagePath: string, options?: NativeOptions): Promise<string[]>;

package/lib/typescript/commonjs/src/NativeTextReader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativeTextReader.d.ts","sourceRoot":"","sources":["../../../../src/NativeTextReader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,MAAM,aAAa,GAAG;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IACvC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE;QACN,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B,CAAC;AAEF,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACpE,YAAY,CACV,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAClC;;AAED,wBAA2D"}
+{"version":3,"file":"NativeTextReader.d.ts","sourceRoot":"","sources":["../../../../src/NativeTextReader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,MAAM,aAAa,GAAG;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IACvC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gBAAgB,CAAC,EAAE,SAAS,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,KAAK,CAAC,EAAE;QACN,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,eAAe,CAAC,EAAE,qBAAqB,CAAC;CACzC,CAAC;AAEF,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACpE,YAAY,CACV,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAClC;;AAED,wBAA2D"}

package/lib/typescript/commonjs/src/index.d.ts

@@ -6,22 +6,50 @@ export declare enum ScriptOptions {
     KOREAN = "Korean"
 }
 export type RecognitionLevel = 'fast' | 'accurate';
+/**
+ * @deprecated Sus unidades y su origen difieren entre plataformas, así que no
+ * es comparable cross-platform. Usa `TextLine.box`.
+ */
 export type TextFrame = {
     top: number;
     left: number;
     width: number;
     height: number;
 };
+export type TextBox = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export type TextWord = {
+    text: string;
+    box?: TextBox;
+    confidence?: number;
+};
 export type TextLine = {
     text: string;
+    /**
+     * Confianza del motor, 0-1, cuando la expone. `undefined` significa que no
+     * hay dato — nunca se rellena con un valor inventado.
+     */
     confidence?: number;
+    /** @deprecated Usa `box`. */
     frame?: TextFrame;
+    box?: TextBox;
+    /** Palabras de la línea; solo se llena si se pidió `includeWords`. */
+    words?: TextWord[];
     recognizedLanguages?: string[];
 };
 export type DetailedResult = {
     fullText: string;
     lines: string[];
     details: TextLine[];
+    /**
+     * Sistema de coordenadas de las cajas. Ausente en módulos nativos anteriores
+     * a la 2.1, donde `box` tampoco existe.
+     */
+    coordinateSpace?: 'normalized-top-left';
 };
 export type Options = {
     visionIgnoreThreshold?: number;
@@ -32,10 +60,15 @@ export type Options = {
     customWords?: string[];
     useLanguageCorrection?: boolean;
     minimumTextHeight?: number;
+    /** Devolver cada palabra con su caja, además de la línea completa. */
+    includeWords?: boolean;
+    /** Zona a leer, normalizada (0-1) con origen arriba-izquierda. */
+    regionOfInterest?: TextBox;
 };
 type TextReaderNative = {
     read(imagePath: string, options?: Options): Promise<string[]>;
     readDetailed(imagePath: string, options?: Options): Promise<DetailedResult>;
+    readDocument(imagePath: string, options?: Options): Promise<DetailedResult>;
 };
 declare const _default: TextReaderNative;
 export default _default;

package/lib/typescript/commonjs/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/index.tsx"],"names":[],"mappings":"AAsBA,oBAAY,aAAa;IACvB,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,UAAU,eAAe;IACzB,QAAQ,aAAa;IACrB,MAAM,WAAW;CAClB;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,UAAU,CAAC;AAEnD,MAAM,MAAM,SAAS,GAAG;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,QAAQ,EAAE,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IACpB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9D,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC7E,CAAC;wBAyCuC,gBAAgB;AAAzD,wBAA0D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/index.tsx"],"names":[],"mappings":"AAsBA,oBAAY,aAAa;IACvB,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,UAAU,eAAe;IACzB,QAAQ,aAAa;IACrB,MAAM,WAAW;CAClB;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,UAAU,CAAC;AAEnD;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,sEAAsE;IACtE,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB;;;OAGG;IACH,eAAe,CAAC,EAAE,qBAAqB,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IACpB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sEAAsE;IACtE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9D,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC5E,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC7E,CAAC;wBA2DqD,gBAAgB;AAAvE,wBAAwE"}

package/lib/typescript/module/src/NativeTextReader.d.ts

@@ -8,22 +8,43 @@ export type NativeOptions = {
     customWords?: string[];
     useLanguageCorrection?: boolean;
     minimumTextHeight?: number;
+    includeWords?: boolean;
+    regionOfInterest?: NativeBox;
+};
+export type NativeBox = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export type NativeWord = {
+    text: string;
+    box?: NativeBox;
+    confidence?: number;
 };
 export type NativeTextLine = {
     text: string;
     confidence?: number;
+    /**
+     * @deprecated Sus unidades y su origen difieren entre plataformas (iOS:
+     * normalizado x1000 con origen abajo; Android: píxeles con origen arriba),
+     * así que no es comparable cross-platform. Usa `box`.
+     */
     frame?: {
         top: number;
         left: number;
         width: number;
         height: number;
     };
+    box?: NativeBox;
+    words?: NativeWord[];
     recognizedLanguages?: string[];
 };
 export type NativeDetailedResult = {
     fullText: string;
     lines: string[];
     details: NativeTextLine[];
+    coordinateSpace?: 'normalized-top-left';
 };
 export interface Spec extends TurboModule {
     read(imagePath: string, options?: NativeOptions): Promise<string[]>;

package/lib/typescript/module/src/NativeTextReader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativeTextReader.d.ts","sourceRoot":"","sources":["../../../../src/NativeTextReader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,MAAM,aAAa,GAAG;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IACvC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE;QACN,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B,CAAC;AAEF,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACpE,YAAY,CACV,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAClC;;AAED,wBAA2D"}
+{"version":3,"file":"NativeTextReader.d.ts","sourceRoot":"","sources":["../../../../src/NativeTextReader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,MAAM,aAAa,GAAG;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IACvC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gBAAgB,CAAC,EAAE,SAAS,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,KAAK,CAAC,EAAE;QACN,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,eAAe,CAAC,EAAE,qBAAqB,CAAC;CACzC,CAAC;AAEF,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACpE,YAAY,CACV,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAClC;;AAED,wBAA2D"}

package/lib/typescript/module/src/index.d.ts

@@ -6,22 +6,50 @@ export declare enum ScriptOptions {
     KOREAN = "Korean"
 }
 export type RecognitionLevel = 'fast' | 'accurate';
+/**
+ * @deprecated Sus unidades y su origen difieren entre plataformas, así que no
+ * es comparable cross-platform. Usa `TextLine.box`.
+ */
 export type TextFrame = {
     top: number;
     left: number;
     width: number;
     height: number;
 };
+export type TextBox = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export type TextWord = {
+    text: string;
+    box?: TextBox;
+    confidence?: number;
+};
 export type TextLine = {
     text: string;
+    /**
+     * Confianza del motor, 0-1, cuando la expone. `undefined` significa que no
+     * hay dato — nunca se rellena con un valor inventado.
+     */
     confidence?: number;
+    /** @deprecated Usa `box`. */
     frame?: TextFrame;
+    box?: TextBox;
+    /** Palabras de la línea; solo se llena si se pidió `includeWords`. */
+    words?: TextWord[];
     recognizedLanguages?: string[];
 };
 export type DetailedResult = {
     fullText: string;
     lines: string[];
     details: TextLine[];
+    /**
+     * Sistema de coordenadas de las cajas. Ausente en módulos nativos anteriores
+     * a la 2.1, donde `box` tampoco existe.
+     */
+    coordinateSpace?: 'normalized-top-left';
 };
 export type Options = {
     visionIgnoreThreshold?: number;
@@ -32,10 +60,15 @@ export type Options = {
     customWords?: string[];
     useLanguageCorrection?: boolean;
     minimumTextHeight?: number;
+    /** Devolver cada palabra con su caja, además de la línea completa. */
+    includeWords?: boolean;
+    /** Zona a leer, normalizada (0-1) con origen arriba-izquierda. */
+    regionOfInterest?: TextBox;
 };
 type TextReaderNative = {
     read(imagePath: string, options?: Options): Promise<string[]>;
     readDetailed(imagePath: string, options?: Options): Promise<DetailedResult>;
+    readDocument(imagePath: string, options?: Options): Promise<DetailedResult>;
 };
 declare const _default: TextReaderNative;
 export default _default;

package/lib/typescript/module/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/index.tsx"],"names":[],"mappings":"AAsBA,oBAAY,aAAa;IACvB,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,UAAU,eAAe;IACzB,QAAQ,aAAa;IACrB,MAAM,WAAW;CAClB;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,UAAU,CAAC;AAEnD,MAAM,MAAM,SAAS,GAAG;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,QAAQ,EAAE,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IACpB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9D,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC7E,CAAC;wBAyCuC,gBAAgB;AAAzD,wBAA0D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/index.tsx"],"names":[],"mappings":"AAsBA,oBAAY,aAAa;IACvB,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,UAAU,eAAe;IACzB,QAAQ,aAAa;IACrB,MAAM,WAAW;CAClB;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,UAAU,CAAC;AAEnD;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,sEAAsE;IACtE,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB;;;OAGG;IACH,eAAe,CAAC,EAAE,qBAAqB,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IACpB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sEAAsE;IACtE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9D,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC5E,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC7E,CAAC;wBA2DqD,gBAAgB;AAAvE,wBAAwE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-text-reader",
-  "version": "2.0.1",
+  "version": "2.1.0",
   "description": "A React Native library for OCR using Vision Framework on iOS and ML Kit on Android. Supports Expo development builds, detailed OCR metadata, and Android 16KB page size compatibility.",
   "source": "./src/index.tsx",
   "main": "./lib/commonjs/index.js",

package/src/NativeTextReader.ts

@@ -10,17 +10,39 @@ export type NativeOptions = {
   customWords?: string[];
   useLanguageCorrection?: boolean;
   minimumTextHeight?: number;
+  includeWords?: boolean;
+  regionOfInterest?: NativeBox;
+};
+
+export type NativeBox = {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+};
+
+export type NativeWord = {
+  text: string;
+  box?: NativeBox;
+  confidence?: number;
 };
 
 export type NativeTextLine = {
   text: string;
   confidence?: number;
+  /**
+   * @deprecated Sus unidades y su origen difieren entre plataformas (iOS:
+   * normalizado x1000 con origen abajo; Android: píxeles con origen arriba),
+   * así que no es comparable cross-platform. Usa `box`.
+   */
   frame?: {
     top: number;
     left: number;
     width: number;
     height: number;
   };
+  box?: NativeBox;
+  words?: NativeWord[];
   recognizedLanguages?: string[];
 };
 
@@ -28,6 +50,7 @@ export type NativeDetailedResult = {
   fullText: string;
   lines: string[];
   details: NativeTextLine[];
+  coordinateSpace?: 'normalized-top-left';
 };
 
 export interface Spec extends TurboModule {

package/src/index.tsx

@@ -30,6 +30,10 @@ export enum ScriptOptions {
 
 export type RecognitionLevel = 'fast' | 'accurate';
 
+/**
+ * @deprecated Sus unidades y su origen difieren entre plataformas, así que no
+ * es comparable cross-platform. Usa `TextLine.box`.
+ */
 export type TextFrame = {
   top: number;
   left: number;
@@ -37,10 +41,31 @@ export type TextFrame = {
   height: number;
 };
 
+export type TextBox = {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+};
+
+export type TextWord = {
+  text: string;
+  box?: TextBox;
+  confidence?: number;
+};
+
 export type TextLine = {
   text: string;
+  /**
+   * Confianza del motor, 0-1, cuando la expone. `undefined` significa que no
+   * hay dato — nunca se rellena con un valor inventado.
+   */
   confidence?: number;
+  /** @deprecated Usa `box`. */
   frame?: TextFrame;
+  box?: TextBox;
+  /** Palabras de la línea; solo se llena si se pidió `includeWords`. */
+  words?: TextWord[];
   recognizedLanguages?: string[];
 };
 
@@ -48,6 +73,11 @@ export type DetailedResult = {
   fullText: string;
   lines: string[];
   details: TextLine[];
+  /**
+   * Sistema de coordenadas de las cajas. Ausente en módulos nativos anteriores
+   * a la 2.1, donde `box` tampoco existe.
+   */
+  coordinateSpace?: 'normalized-top-left';
 };
 
 export type Options = {
@@ -59,11 +89,16 @@ export type Options = {
   customWords?: string[];
   useLanguageCorrection?: boolean;
   minimumTextHeight?: number;
+  /** Devolver cada palabra con su caja, además de la línea completa. */
+  includeWords?: boolean;
+  /** Zona a leer, normalizada (0-1) con origen arriba-izquierda. */
+  regionOfInterest?: TextBox;
 };
 
 type TextReaderNative = {
   read(imagePath: string, options?: Options): Promise<string[]>;
   readDetailed(imagePath: string, options?: Options): Promise<DetailedResult>;
+  readDocument(imagePath: string, options?: Options): Promise<DetailedResult>;
 };
 
 const DEFAULT_OPTIONS: Options = {
@@ -74,15 +109,26 @@ function normalizeDetailedResult(result: DetailedResult): DetailedResult {
   return {
     fullText: result.fullText ?? '',
     lines: result.lines ?? [],
+    coordinateSpace: result.coordinateSpace,
     details: (result.details ?? []).map((detail) => ({
       text: detail.text,
       confidence: detail.confidence,
       frame: detail.frame,
+      box: detail.box,
+      words: detail.words,
       recognizedLanguages: detail.recognizedLanguages,
     })),
   };
 }
 
+const DOCUMENT_OPTIONS: Options = {
+  script: ScriptOptions.LATIN,
+  recognitionLevel: 'accurate',
+  useLanguageCorrection: false,
+  minimumTextHeight: 0.008,
+  includeWords: true,
+};
+
 /**
  * Extracts text lines from an image.
  */
@@ -105,4 +151,11 @@ async function readDetailed(
   return normalizeDetailedResult(result);
 }
 
-export default { read, readDetailed } as TextReaderNative;
+async function readDocument(
+  imagePath: string,
+  options?: Options
+): Promise<DetailedResult> {
+  return readDetailed(imagePath, { ...DOCUMENT_OPTIONS, ...options });
+}
+
+export default { read, readDetailed, readDocument } as TextReaderNative;