react-native-pdf-jsi 4.3.2 → 4.4.0

package/README.md

@@ -41,7 +41,7 @@ High-performance React Native PDF viewer with JSI (JavaScript Interface) acceler
 - **Export Operations**: Export pages to PNG/JPEG with quality control
 - **PDF Operations**: Split, merge, extract, rotate, and delete pages
 - **PDF Compression**: Reduce file sizes with 5 smart presets (EMAIL, WEB, MOBILE, PRINT, ARCHIVE)
-- **Text Extraction**: Extract and search text with statistics and context
+- **Text Extraction & Search**: Extract and search text with statistics and context; **programmatic search** via `searchTextDirect(pdfId, term, startPage, endPage)` with bounding rects, and **highlight rendering** via `pdfId` + `highlightRects` props (Android & iOS)
 - **File Management** (Android): Download to public storage, open folders with MediaStore API
 
 ### Compliance & Compatibility
@@ -261,6 +261,8 @@ The documentation includes:
 | `enableAnnotationRendering` | boolean | true | Enable annotation rendering |
 | `enableDoubleTapZoom` | boolean | true | Enable double tap to zoom |
 | `singlePage` | boolean | false | Show only first page (thumbnail mode) |
+| `pdfId` | string | undefined | Stable ID for this PDF (e.g. `"main-pdf"`); required for `searchTextDirect()` so native code can resolve the document path |
+| `highlightRects` | array | undefined | Array of `{ page: number, rect: string }` (rect: `"left,top,right,bottom"` in PDF points) to draw yellow highlights; use with `searchTextDirect()` results |
 | `trustAllCerts` | boolean | true | Allow self-signed certificates |
 | `onLoadProgress` | function(percent) | null | Loading progress callback (0-1) |
 | `onLoadComplete` | function(pages, path, size, tableContents) | null | Called when PDF loads |
@@ -304,6 +306,30 @@ const pdfRef = useRef(null);
 pdfRef.current?.setPage(42);
 ```
 
+#### searchTextDirect(pdfId, searchTerm, startPage, endPage)
+
+Programmatic PDF text search. Returns a promise that resolves to an array of `{ page, text, rect }` (rect is `"left,top,right,bottom"` in PDF coordinates). Use with `pdfId` and `highlightRects` to show highlights.
+
+```jsx
+import Pdf, { searchTextDirect } from 'react-native-pdf-jsi';
+
+const PDF_ID = 'main-pdf';
+const [highlights, setHighlights] = useState([]);
+
+<Pdf
+  pdfId={PDF_ID}
+  source={source}
+  highlightRects={highlights.filter(r => r.rect).map(r => ({ page: r.page, rect: r.rect }))}
+  onLoadComplete={(pages, path) => { /* path is registered for search */ }}
+/>
+
+// After PDF has loaded, e.g. on button press:
+const results = await searchTextDirect(PDF_ID, 'Lorem', 1, 999);
+setHighlights(results);
+```
+
+On iOS, the path is registered when the document loads (local file only); you can also call `NativeModules.PDFJSIManager.registerPathForSearch(pdfId, path)` after `onLoadComplete` if needed. Highlights stay aligned when zooming and scrolling on both Android and iOS.
+
 ## ProGuard / R8 Configuration (Android Release Builds)
 
 **IMPORTANT:** If you're using ProGuard or R8 code shrinking in your release builds, you must add the following rules to prevent crashes. These rules preserve JSI classes and native module interfaces that are required at runtime.

package/android/src/main/java/org/wonday/pdf/PDFJSIManager.java

@@ -18,15 +18,27 @@ import com.facebook.react.bridge.ReactMethod;
 import com.facebook.react.bridge.Promise;
 import com.facebook.react.bridge.ReadableMap;
 import com.facebook.react.bridge.ReadableArray;
+import com.facebook.react.bridge.WritableArray;
 import com.facebook.react.bridge.WritableMap;
 import com.facebook.react.bridge.Arguments;
 
 // import com.facebook.react.turbomodule.core.CallInvokerHolder; // Not available in this RN version
 import com.facebook.soloader.SoLoader;
 
+import java.io.File;
+import java.io.IOException;
 import java.util.concurrent.ExecutorService;
 import java.util.concurrent.Executors;
 
+import android.graphics.RectF;
+import android.net.Uri;
+import android.os.ParcelFileDescriptor;
+
+import io.legere.pdfiumandroid.PdfiumCore;
+import io.legere.pdfiumandroid.PdfDocument;
+import io.legere.pdfiumandroid.PdfPage;
+import io.legere.pdfiumandroid.PdfTextPage;
+
 public class PDFJSIManager extends ReactContextBaseJavaModule {
     private static final String MODULE_NAME = "PDFJSIManager";
     private static final String TAG = "PDFJSI";
@@ -220,9 +232,24 @@ public class PDFJSIManager extends ReactContextBaseJavaModule {
             }
         });
     }
+
+    /**
+     * Register a path for search by pdfId. Called from JS when loadComplete fires so search works
+     * even if the native view has not received pdfId yet. On Android the view also registers; this is for parity with iOS.
+     */
+    @ReactMethod
+    public void registerPathForSearch(String pdfId, String path, Promise promise) {
+        if (pdfId != null && !pdfId.isEmpty() && path != null && !path.isEmpty()) {
+            SearchRegistry.registerPath(pdfId, path);
+            promise.resolve(true);
+        } else {
+            promise.resolve(false);
+        }
+    }
     
     /**
-     * Search text directly via JSI
+     * Search text directly via JSI.
+     * Uses SearchRegistry to get path for pdfId, then io.legere PdfiumCore to extract text and find matches.
      */
     @ReactMethod
     public void searchTextDirect(String pdfId, String searchTerm, int startPage, int endPage, Promise promise) {
@@ -230,11 +257,20 @@ public class PDFJSIManager extends ReactContextBaseJavaModule {
             promise.reject("JSI_NOT_INITIALIZED", "JSI is not initialized");
             return;
         }
-        
+        if (searchTerm == null || searchTerm.isEmpty()) {
+            promise.resolve(Arguments.createArray());
+            return;
+        }
         backgroundExecutor.execute(() -> {
             try {
                 Log.d(TAG, "Searching text via JSI: '" + searchTerm + "' in pages " + startPage + "-" + endPage);
-                ReadableArray results = nativeSearchTextDirect(pdfId, searchTerm, startPage, endPage);
+                String path = SearchRegistry.getPath(pdfId);
+                if (path == null || path.isEmpty()) {
+                    Log.w(TAG, "No path registered for pdfId: " + pdfId + " - pass pdfId to Pdf view to enable search");
+                    promise.resolve(Arguments.createArray());
+                    return;
+                }
+                WritableArray results = searchInPdf(pdfId, path, searchTerm, startPage, endPage);
                 promise.resolve(results);
             } catch (Exception e) {
                 Log.e(TAG, "Error searching text via JSI", e);
@@ -242,6 +278,105 @@ public class PDFJSIManager extends ReactContextBaseJavaModule {
             }
         });
     }
+
+    private WritableArray searchInPdf(String pdfId, String path, String searchTerm, int startPage, int endPage) {
+        WritableArray out = Arguments.createArray();
+        ParcelFileDescriptor pfd = null;
+        PdfDocument doc = null;
+        try {
+            if (path.startsWith("content://")) {
+                pfd = getReactApplicationContext().getContentResolver()
+                    .openFileDescriptor(Uri.parse(path), "r");
+            } else {
+                File file = new File(path);
+                if (!file.exists() || !file.canRead()) {
+                    return out;
+                }
+                pfd = ParcelFileDescriptor.open(file, ParcelFileDescriptor.MODE_READ_ONLY);
+            }
+            if (pfd == null) return out;
+            PdfiumCore core = new PdfiumCore();
+            doc = core.newDocument(pfd);
+            int pageCount = doc.getPageCount();
+            int from = Math.max(1, startPage);
+            int to = Math.min(endPage, pageCount);
+            String termLower = searchTerm.toLowerCase();
+            for (int pageIndex = from; pageIndex <= to; pageIndex++) {
+                int zeroBased = pageIndex - 1;
+                PdfPage page = doc.openPage(zeroBased);
+                if (page == null) continue;
+                try {
+                    // Store page size in PDF points for highlight scaling in PdfView
+                    try {
+                        int wPt = page.getPageWidthPoint();
+                        int hPt = page.getPageHeightPoint();
+                        if (wPt > 0 && hPt > 0) {
+                            SearchRegistry.registerPageSizePoints(pdfId, zeroBased, (float) wPt, (float) hPt);
+                        }
+                    } catch (Exception ignored) {}
+                    PdfTextPage textPage = page.openTextPage();
+                    if (textPage == null) continue;
+                    try {
+                        int chars = textPage.textPageCountChars();
+                        if (chars <= 0) continue;
+                        String text = textPage.textPageGetText(0, chars);
+                        if (text == null) continue;
+                        String textLower = text.toLowerCase();
+                        int idx = 0;
+                        while ((idx = textLower.indexOf(termLower, idx)) >= 0) {
+                            int end = Math.min(idx + searchTerm.length(), text.length());
+                            int len = end - idx;
+                            String snippet = text.substring(idx, end);
+                            WritableMap item = Arguments.createMap();
+                            item.putInt("page", pageIndex);
+                            item.putString("text", snippet);
+                            String rectStr = "{}";
+                            try {
+                                int rectCount = textPage.textPageCountRects(idx, len);
+                                if (rectCount > 0) {
+                                    RectF first = textPage.textPageGetRect(0);
+                                    if (first != null) {
+                                        rectStr = first.left + "," + first.top + "," + first.right + "," + first.bottom;
+                                    }
+                                }
+                                if ("{}".equals(rectStr)) {
+                                    RectF charBox = textPage.textPageGetCharBox(idx);
+                                    if (charBox != null) {
+                                        rectStr = charBox.left + "," + charBox.top + "," + charBox.right + "," + charBox.bottom;
+                                    }
+                                }
+                            } catch (Exception e) {
+                                Log.d(TAG, "Rect lookup for match at " + idx + ": " + e.getMessage());
+                            }
+                            item.putString("rect", rectStr);
+                            out.pushMap(item);
+                            idx = end;
+                        }
+                    } finally {
+                        textPage.close();
+                    }
+                } finally {
+                    page.close();
+                }
+            }
+        } catch (IOException e) {
+            Log.e(TAG, "Search IO error", e);
+        } catch (Exception e) {
+            Log.e(TAG, "Search error", e);
+        } finally {
+            if (doc != null) {
+                try {
+                    doc.close();
+                } catch (Exception ignored) {}
+            }
+            if (pfd != null) {
+                try {
+                    pfd.close();
+                } catch (IOException ignored) {}
+            }
+        }
+        return out;
+    }
     
     /**
      * Get performance metrics via JSI

package/android/src/main/java/org/wonday/pdf/PdfManager.java

@@ -69,6 +69,16 @@ public class PdfManager extends SimpleViewManager<PdfView> implements RNPDFPdfVi
         pdfView.setPath(path);
     }
 
+    @ReactProp(name = "pdfId")
+    public void setPdfId(PdfView pdfView, String pdfId) {
+        pdfView.setPdfId(pdfId);
+    }
+
+    @ReactProp(name = "highlightRects")
+    public void setHighlightRects(PdfView pdfView, ReadableArray highlightRects) {
+        pdfView.setHighlightRects(highlightRects);
+    }
+
     // page start from 1
     @ReactProp(name = "page")
     public void setPage(PdfView pdfView, int page) {

package/android/src/main/java/org/wonday/pdf/PdfView.java

@@ -20,7 +20,12 @@ import android.net.Uri;
 import android.util.AttributeSet;
 import android.view.MotionEvent;
 import android.graphics.Canvas;
+import android.graphics.Color;
+import android.graphics.Paint;
 import android.os.Handler;
+
+import com.facebook.react.bridge.ReadableArray;
+import com.facebook.react.bridge.ReadableMap;
 import android.os.Looper;
 
 
@@ -52,6 +57,8 @@ import static java.lang.String.format;
 
 import java.io.FileNotFoundException;
 import java.io.InputStream;
+import java.util.ArrayList;
+import java.util.List;
 
 import com.google.gson.Gson;
 
@@ -77,7 +84,8 @@ public class PdfView extends PDFView implements OnPageChangeListener,OnLoadCompl
     private FitPolicy fitPolicy = FitPolicy.WIDTH;
     private boolean singlePage = false;
     private boolean scrollEnabled = true;
-    
+    private String pdfId = null;
+
     private String decelerationRate = "normal"; // "normal", "fast", "slow"
 
     private float originalWidth = 0;
@@ -94,8 +102,29 @@ public class PdfView extends PDFView implements OnPageChangeListener,OnLoadCompl
     private int oldW = 0;
     private int oldH = 0;
 
+    /** Search highlight rects: list of { page (1-based), rect "left,top,right,bottom" in PDF points } */
+    private List<HighlightRect> highlightRects = new ArrayList<>();
+    private static final int HIGHLIGHT_COLOR = Color.argb(80, 255, 255, 0);
+    private final Paint highlightPaint = new Paint();
+
     public PdfView(Context context, AttributeSet set){
         super(context, set);
+        highlightPaint.setColor(HIGHLIGHT_COLOR);
+        highlightPaint.setStyle(Paint.Style.FILL);
+    }
+
+    /** Entry for one highlight: page (1-based) and rect in PDF points "left,top,right,bottom". */
+    private static class HighlightRect {
+        final int page;
+        final float left, top, right, bottom;
+
+        HighlightRect(int page, float left, float top, float right, float bottom) {
+            this.page = page;
+            this.left = left;
+            this.top = top;
+            this.right = right;
+            this.bottom = bottom;
+        }
     }
 
     @Override
@@ -225,6 +254,9 @@ public class PdfView extends PDFView implements OnPageChangeListener,OnLoadCompl
                         self.loadCompleteDispatched = true;
                         showLog("loadComplete: Event dispatched successfully (delayed)");
                     }
+                    if (self.pdfId != null && self.path != null) {
+                        SearchRegistry.registerPath(self.pdfId, self.path);
+                    }
                 }
             });
         } else {
@@ -340,6 +372,42 @@ public class PdfView extends PDFView implements OnPageChangeListener,OnLoadCompl
 
         lastPageWidth = pageWidth;
         lastPageHeight = pageHeight;
+
+        if (!highlightRects.isEmpty() && pdfId != null) {
+            int pageOneBased = displayedPage + 1;
+            try {
+                float pdfW = 0, pdfH = 0;
+                float[] sizePt = SearchRegistry.getPageSizePoints(pdfId, displayedPage);
+                if (sizePt != null && sizePt.length >= 2 && sizePt[0] > 0 && sizePt[1] > 0) {
+                    pdfW = sizePt[0];
+                    pdfH = sizePt[1];
+                }
+                if (pdfW <= 0 || pdfH <= 0) {
+                    SizeF fallback = getPageSize(displayedPage);
+                    if (fallback != null) {
+                        pdfW = fallback.getWidth();
+                        pdfH = fallback.getHeight();
+                    }
+                }
+                if (pdfW > 0 && pdfH > 0) {
+                    float scaleX = pageWidth / pdfW;
+                    float scaleY = pageHeight / pdfH;
+                    for (HighlightRect hr : highlightRects) {
+                        if (hr.page != pageOneBased) continue;
+                        float left = hr.left * scaleX;
+                        float right = hr.right * scaleX;
+                        float top = hr.top * scaleY;
+                        float bottom = hr.bottom * scaleY;
+                        // PDF coords: origin bottom-left, so top > bottom. Canvas: origin top-left.
+                        float canvasTop = pageHeight - top;
+                        float canvasBottom = pageHeight - bottom;
+                        canvas.drawRect(left, canvasTop, right, canvasBottom, highlightPaint);
+                    }
+                }
+            } catch (Exception e) {
+                showLog("Highlight draw error: " + e.getMessage());
+            }
+        }
     }
 
     @Override
@@ -361,6 +429,14 @@ public class PdfView extends PDFView implements OnPageChangeListener,OnLoadCompl
         // the PDF on navigation. We only recycle when PdfManager.onDropViewInstance is called.
     }
 
+    @Override
+    public void recycle() {
+        if (pdfId != null) {
+            SearchRegistry.unregisterPath(pdfId);
+        }
+        super.recycle();
+    }
+
     public void drawPdf() {
         
         // FIX: Check if we actually need to reload the document
@@ -444,14 +520,45 @@ public class PdfView extends PDFView implements OnPageChangeListener,OnLoadCompl
     }
 
     public void setPath(String path) {
-        // Path changed - need to reload document
+        if (pdfId != null) {
+            SearchRegistry.unregisterPath(pdfId);
+        }
         needsReload = true;
         this.path = path;
-        // Reset flags when path changes
         loadCompleteDispatched = false;
         lastKnownPageCount = 0;
     }
 
+    public void setPdfId(String pdfId) {
+        if (this.pdfId != null && !this.pdfId.equals(pdfId)) {
+            SearchRegistry.unregisterPath(this.pdfId);
+        }
+        this.pdfId = pdfId;
+    }
+
+    public void setHighlightRects(ReadableArray arr) {
+        highlightRects.clear();
+        if (arr == null) return;
+        for (int i = 0; i < arr.size(); i++) {
+            ReadableMap map = arr.getMap(i);
+            if (map == null || !map.hasKey("page") || !map.hasKey("rect")) continue;
+            int page = map.getInt("page");
+            String rectStr = map.getString("rect");
+            if (rectStr == null || rectStr.equals("{}")) continue;
+            String[] parts = rectStr.split(",");
+            if (parts.length != 4) continue;
+            try {
+                float left = Float.parseFloat(parts[0].trim());
+                float top = Float.parseFloat(parts[1].trim());
+                float right = Float.parseFloat(parts[2].trim());
+                float bottom = Float.parseFloat(parts[3].trim());
+                highlightRects.add(new HighlightRect(page, left, top, right, bottom));
+            } catch (NumberFormatException ignored) {}
+        }
+        invalidate();
+        postInvalidate();
+    }
+
     // page start from 1
     public void setPage(int page) {
         int newPage = page>1?page:1;

package/android/src/main/java/org/wonday/pdf/SearchRegistry.java

@@ -0,0 +1,44 @@
+/**
+ * Registry mapping pdfId to current PDF file path for programmatic search.
+ * PdfView registers when a document loads with pdfId; searchTextDirect looks up path by pdfId.
+ * Also stores PDF page sizes in points (per pdfId + pageIndex) for highlight coordinate scaling.
+ */
+package org.wonday.pdf;
+
+import java.util.concurrent.ConcurrentHashMap;
+
+public final class SearchRegistry {
+    private static final ConcurrentHashMap<String, String> pdfIdToPath = new ConcurrentHashMap<>();
+    /** Key: pdfId + "_" + pageIndex0Based, value: float[2] = { widthPt, heightPt } */
+    private static final ConcurrentHashMap<String, float[]> pdfIdPageSizePoints = new ConcurrentHashMap<>();
+
+    public static void registerPath(String pdfId, String path) {
+        if (pdfId != null && !pdfId.isEmpty() && path != null && !path.isEmpty()) {
+            pdfIdToPath.put(pdfId, path);
+        }
+    }
+
+    public static void unregisterPath(String pdfId) {
+        if (pdfId != null && !pdfId.isEmpty()) {
+            pdfIdToPath.remove(pdfId);
+            // Clear page sizes for this pdfId
+            pdfIdPageSizePoints.keySet().removeIf(k -> k != null && k.startsWith(pdfId + "_"));
+        }
+    }
+
+    public static String getPath(String pdfId) {
+        return pdfId == null ? null : pdfIdToPath.get(pdfId);
+    }
+
+    /** Register page size in PDF points (for highlight scaling). */
+    public static void registerPageSizePoints(String pdfId, int pageIndex0Based, float widthPt, float heightPt) {
+        if (pdfId != null && !pdfId.isEmpty() && widthPt > 0 && heightPt > 0) {
+            pdfIdPageSizePoints.put(pdfId + "_" + pageIndex0Based, new float[] { widthPt, heightPt });
+        }
+    }
+
+    /** Get page size in PDF points; returns float[2] = { widthPt, heightPt } or null. */
+    public static float[] getPageSizePoints(String pdfId, int pageIndex0Based) {
+        return pdfId == null ? null : pdfIdPageSizePoints.get(pdfId + "_" + pageIndex0Based);
+    }
+}

package/fabric/RNPDFPdfNativeComponent.js

@@ -37,6 +37,8 @@
    password: ?string,
    onChange: ?BubblingEventHandler<ChangeEvent>,
    singlePage: ?boolean,
+   pdfId: ?string,
+   highlightRects: ?$ReadOnlyArray<$ReadOnly<{|page: Int32, rect: string|}>>,
  |}>;
 
  interface NativeCommands {

package/index.d.ts

@@ -88,6 +88,17 @@ export interface PdfProps {
     onPageSingleTap?: (page: number, x: number, y: number) => void,
     onScaleChanged?: (scale: number) => void,
     onPressLink?: (url: string) => void,
+    /**
+     * Optional. When set, use this id with searchTextDirect(pdfId, ...) for programmatic text search.
+     * On iOS, the same id must be passed to the Pdf view and to searchTextDirect. One view per pdfId.
+     */
+    pdfId?: string,
+    /**
+     * Optional. Array of rects to highlight on the PDF (e.g. from searchTextDirect results).
+     * Each item: { page: number, rect: string } where rect is "left,top,right,bottom" in PDF page coordinates.
+     * Supported on Android; iOS can be added later.
+     */
+    highlightRects?: Array<{ page: number; rect: string }>,
 }
 
 declare class Pdf extends React.Component<PdfProps, any> {
@@ -463,3 +474,26 @@ export interface PDFCompressorManager {
  * PDFCompressor singleton instance
  */
 export const PDFCompressor: PDFCompressorManager;
+
+// ========================================
+// JSI / Programmatic search
+// ========================================
+
+export interface PDFSearchResultItem {
+    page: number;
+    text: string;
+    /** Bounds of the match (format is platform-specific; on iOS a CGRect string). */
+    rect: string;
+}
+
+/**
+ * Search PDF text programmatically.
+ * On iOS: pass the same pdfId to the Pdf view (pdfId prop) so the view is registered for search.
+ * On Android: returns empty array until a native text-extraction implementation is added.
+ */
+export function searchTextDirect(
+    pdfId: string,
+    searchTerm: string,
+    startPage: number,
+    endPage: number
+): Promise<PDFSearchResultItem[]>;

package/index.js

@@ -18,6 +18,7 @@ import {
     StyleSheet,
     Image,
     Text,
+    NativeModules,
     requireNativeComponent
 } from 'react-native';
 // Codegen component variables - will be loaded lazily to prevent hooks errors
@@ -27,7 +28,7 @@ import ReactNativeBlobUtil from 'react-native-blob-util'
 import {ViewPropTypes} from 'deprecated-react-native-prop-types';
 const SHA1 = require('crypto-js/sha1');
 import PdfView from './PdfView';
-import PDFJSI from './src/PDFJSI';
+import PDFJSI, { searchTextDirect } from './src/PDFJSI';
 
 export default class Pdf extends Component {
 
@@ -67,6 +68,8 @@ export default class Pdf extends Component {
         onPageSingleTap: PropTypes.func,
         onScaleChanged: PropTypes.func,
         onPressLink: PropTypes.func,
+        pdfId: PropTypes.string,
+        highlightRects: PropTypes.arrayOf(PropTypes.shape({ page: PropTypes.number.isRequired, rect: PropTypes.string.isRequired })),
 
         // Props that are not available in the earlier react native version, added to prevent crashed on android
         accessibilityLabel: PropTypes.string,
@@ -111,6 +114,8 @@ export default class Pdf extends Component {
         },
         onPressLink: (url) => {
         },
+        pdfId: undefined,
+        highlightRects: undefined,
     };
 
     constructor(props) {
@@ -594,7 +599,24 @@ export default class Pdf extends Component {
                 if (!filePath || filePath.trim() === '') {
                     filePath = this.downloadedFilePath || this.state.path || '';
                 }
-                
+                // Register path for search (iOS: ensures SearchRegistry has path when pdfId may not reach native view)
+                if (this.props.pdfId && filePath) {
+                    const PDFJSIManager = NativeModules.PDFJSIManager;
+                    if (PDFJSIManager && typeof PDFJSIManager.registerPathForSearch === 'function') {
+                        if (__DEV__) {
+                            console.log('📌 [Pdf] Registering path for search:', this.props.pdfId, 'pathLength:', filePath.length);
+                        }
+                        PDFJSIManager.registerPathForSearch(this.props.pdfId, filePath).then(() => {
+                            if (__DEV__) console.log('✅ [Pdf] Path registered for search:', this.props.pdfId);
+                        }).catch((err) => {
+                            if (__DEV__) console.warn('⚠️ [Pdf] registerPathForSearch failed:', err);
+                        });
+                    } else if (__DEV__) {
+                        console.warn('⚠️ [Pdf] PDFJSIManager.registerPathForSearch not available');
+                    }
+                } else if (__DEV__) {
+                    console.log('📌 [Pdf] Skip path registration: pdfId=', this.props.pdfId, 'hasPath=', !!filePath);
+                }
                 // Log path extraction for debugging
                 if (__DEV__) {
                     console.log('📁 [Pdf] loadComplete - Path extraction:', {
@@ -758,6 +780,11 @@ export {
     CompressionLevel
 };
 
+// ========================================
+// Programmatic search and JSI API (fix #24)
+// ========================================
+export { searchTextDirect, PDFJSI };
+
 // ========================================
 // TIER 3: Pre-built UI Components
 // ========================================

package/ios/RNPDFPdf/PDFJSIManager.m

@@ -8,9 +8,11 @@
 
 #import "PDFJSIManager.h"
 #import "PDFNativeCacheManager.h"
+#import "SearchRegistry.h"
 #import <React/RCTLog.h>
 #import <React/RCTUtils.h>
 #import <React/RCTBridge.h>
+#import <PDFKit/PDFKit.h>
 #import <dispatch/dispatch.h>
 
 @implementation PDFJSIManager {
@@ -248,6 +250,21 @@ RCT_EXPORT_METHOD(optimizeMemory:(NSString *)pdfId
     });
 }
 
+RCT_EXPORT_METHOD(registerPathForSearch:(NSString *)pdfId
+                  path:(NSString *)path
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+{
+    if (pdfId.length && path.length) {
+        [SearchRegistry registerPath:pdfId path:path];
+        RCTLogInfo(@"✅ [SearchRegistry] Registered path for pdfId: %@ (path length %lu)", pdfId, (unsigned long)path.length);
+        resolve(@YES);
+    } else {
+        RCTLogWarn(@"⚠️ [SearchRegistry] registerPathForSearch skipped: pdfId length=%lu path length=%lu", (unsigned long)pdfId.length, (unsigned long)path.length);
+        resolve(@NO);
+    }
+}
+
 RCT_EXPORT_METHOD(searchTextDirect:(NSString *)pdfId
                   searchTerm:(NSString *)searchTerm
                   startPage:(NSInteger)startPage
@@ -259,14 +276,82 @@ RCT_EXPORT_METHOD(searchTextDirect:(NSString *)pdfId
         reject(@"JSI_NOT_INITIALIZED", @"JSI is not initialized", nil);
         return;
     }
+    if (!searchTerm || searchTerm.length == 0) {
+        resolve(@[]);
+        return;
+    }
     
     dispatch_async(_backgroundQueue, ^{
         @try {
             RCTLogInfo(@"🔍 Searching text via JSI: '%@' in pages %ld-%ld", searchTerm, (long)startPage, (long)endPage);
             
-            // Simulate text search - return empty array for now
-            NSArray *results = @[];
-            resolve(results);
+            NSString *path = [SearchRegistry pathForPdfId:pdfId];
+            if (!path || path.length == 0) {
+                RCTLogWarn(@"❌ [Search] No path registered for pdfId: %@ - ensure onLoadComplete ran and pdfId is set on Pdf", pdfId);
+                resolve(@[]);
+                return;
+            }
+            if ([path hasPrefix:@"http://"] || [path hasPrefix:@"https://"]) {
+                RCTLogWarn(@"❌ [Search] Path for pdfId %@ is a URI (not a local file path) - cannot open for search", pdfId);
+                resolve(@[]);
+                return;
+            }
+            RCTLogInfo(@"📂 [Search] Path for pdfId '%@': length %lu", pdfId, (unsigned long)path.length);
+            if ([path hasPrefix:@"file://"]) {
+                path = [path substringFromIndex:7];
+            }
+            BOOL readable = [[NSFileManager defaultManager] isReadableFileAtPath:path];
+            if (!readable) {
+                RCTLogWarn(@"❌ [Search] File not readable at path (length %lu)", (unsigned long)path.length);
+                resolve(@[]);
+                return;
+            }
+            NSURL *fileURL = [NSURL fileURLWithPath:path];
+            PDFDocument *doc = [[PDFDocument alloc] initWithURL:fileURL];
+            if (!doc || doc.pageCount == 0) {
+                RCTLogWarn(@"❌ [Search] PDFDocument init failed or empty: doc=%p pageCount=%lu", (__bridge void *)doc, (unsigned long)doc.pageCount);
+                resolve(@[]);
+                return;
+            }
+            
+            NSInteger from = MAX(1, startPage);
+            NSInteger to = MIN((NSInteger)doc.pageCount, endPage);
+            NSMutableArray *out = [NSMutableArray array];
+            
+            // findString:withOptions: returns selections; each can span multiple pages
+            NSArray<PDFSelection *> *selections = [doc findString:searchTerm withOptions:NSCaseInsensitiveSearch];
+            RCTLogInfo(@"📄 [Search] findString returned %lu selection(s) for '%@'", (unsigned long)selections.count, searchTerm);
+            for (PDFSelection *sel in selections) {
+                for (PDFPage *page in sel.pages) {
+                    NSInteger pageIndex1Based = [doc indexForPage:page] + 1;
+                    if (pageIndex1Based < from || pageIndex1Based > to) continue;
+                    
+                    CGRect bounds = [sel boundsForPage:page];
+                    // PDF page coords: origin bottom-left. Serialize as "left,top,right,bottom" (y-up: top > bottom)
+                    CGFloat left = bounds.origin.x;
+                    CGFloat bottom = bounds.origin.y;
+                    CGFloat right = bounds.origin.x + bounds.size.width;
+                    CGFloat top = bounds.origin.y + bounds.size.height;
+                    NSString *rectStr = [NSString stringWithFormat:@"%g,%g,%g,%g", left, top, right, bottom];
+                    
+                    [out addObject:@{
+                        @"page": @(pageIndex1Based),
+                        @"text": sel.string ?: @"",
+                        @"rect": rectStr
+                    }];
+                }
+            }
+            
+            // Register page sizes in points for highlight scaling (use first page of range if we have selections)
+            for (NSInteger idx = from; idx <= to; idx++) {
+                PDFPage *page = [doc pageAtIndex:(NSUInteger)(idx - 1)];
+                if (page) {
+                    CGRect box = [page boundsForBox:kPDFDisplayBoxMediaBox];
+                    [SearchRegistry registerPageSizePointsForPdfId:pdfId pageIndex0Based:(idx - 1) widthPt:box.size.width heightPt:box.size.height];
+                }
+            }
+            
+            resolve([out copy]);
             
         } @catch (NSException *exception) {
             RCTLogError(@"❌ Error searching text via JSI: %@", exception.reason);
@@ -580,7 +665,7 @@ RCT_EXPORT_METHOD(testNativeCache:(RCTPromiseResolveBlock)resolve
 
                // iOS doesn't have the same 16KB page size requirements as Android
                // but we still check for compatibility
-               BOOL is16KBSupported = [self checkiOS16KBSupport];
+               (void)[self checkiOS16KBSupport];
 
                NSDictionary *result = @{
                    @"supported": @YES, // iOS is generally compatible

package/ios/RNPDFPdf/RNPDFPdfView.h

@@ -68,6 +68,8 @@ UIView
 @property(nonatomic) int spacing;
 @property(nonatomic, strong) NSString *password;
 @property(nonatomic) BOOL singlePage;
+@property(nonatomic, strong) NSString *pdfId;
+@property(nonatomic, copy) NSArray *highlightRects;
 
 @property(nonatomic, copy) RCTBubblingEventBlock onChange;
 

package/ios/RNPDFPdf/RNPDFPdfView.mm

@@ -7,6 +7,7 @@
  */
 
 #import "RNPDFPdfView.h"
+#import "SearchRegistry.h"
 
 #import <Foundation/Foundation.h>
 #import <QuartzCore/QuartzCore.h>
@@ -55,6 +56,37 @@ const float MAX_SCALE = 3.0f;
 const float MIN_SCALE = 1.0f;
 
 
+/** Overlay that draws highlight rects on top of the PDF view. */
+@interface HighlightOverlayView : UIView
+@property (nonatomic, weak) PDFView *pdfView;
+@property (nonatomic, copy) NSArray<NSDictionary *> *highlightRects;
+@end
+
+@implementation HighlightOverlayView
+- (void)drawRect:(CGRect)rect {
+    PDFView *pv = self.pdfView;
+    NSArray *items = self.highlightRects;
+    if (!pv || !pv.document || !items.count) return;
+    PDFDocument *doc = pv.document;
+    [[UIColor colorWithRed:1 green:1 blue:0 alpha:0.35] setFill];
+    for (NSDictionary *item in items) {
+        NSNumber *pageNum = item[@"page"];
+        NSString *rectStr = item[@"rect"];
+        if (!pageNum || !rectStr.length) continue;
+        int page1 = pageNum.intValue;
+        if (page1 < 1) continue;
+        PDFPage *page = [doc pageAtIndex:(NSUInteger)(page1 - 1)];
+        if (!page) continue;
+        NSArray<NSString *> *parts = [rectStr componentsSeparatedByString:@","];
+        if (parts.count != 4) continue;
+        CGFloat left = parts[0].doubleValue, top = parts[1].doubleValue, right = parts[2].doubleValue, bottom = parts[3].doubleValue;
+        CGRect pageRect = CGRectMake(left, bottom, right - left, top - bottom);
+        CGRect viewRect = [pv convertRect:pageRect fromPage:page];
+        CGContextFillRect(UIGraphicsGetCurrentContext(), viewRect);
+    }
+}
+@end
+
 @interface RNPDFScrollViewDelegateProxy : NSObject <UIScrollViewDelegate>
 - (instancetype)initWithPrimary:(id<UIScrollViewDelegate>)primary secondary:(id<UIScrollViewDelegate>)secondary;
 @end
@@ -181,6 +213,13 @@ const float MIN_SCALE = 1.0f;
     // Track usePageViewController state to prevent unnecessary reconfiguration
     BOOL _currentUsePageViewController;
     BOOL _usePageViewControllerStateInitialized;
+    
+    // Search and highlight (iOS parity with Android)
+    NSString *_pdfId;
+    NSArray *_highlightRects;
+    HighlightOverlayView *_highlightOverlay;
+    /// Local file path when document loaded (used for SearchRegistry; may differ from _path which can be URI)
+    NSString *_lastLoadedPath;
 }
 
 #ifdef RCT_NEW_ARCH_ENABLED
@@ -315,6 +354,30 @@ using namespace facebook::react;
         _scrollEnabled = newProps.scrollEnabled;
         [updatedPropNames addObject:@"scrollEnabled"];
     }
+    NSString *newPdfId = RCTNSStringFromStringNilIfEmpty(newProps.pdfId);
+    if (_pdfId != newPdfId && ![newPdfId isEqualToString:_pdfId]) {
+        if (_pdfId.length) [SearchRegistry unregisterPath:_pdfId];
+        _pdfId = [newPdfId copy];
+        [updatedPropNames addObject:@"pdfId"];
+        // Only register local file paths; never register URIs - onDocumentChanged will register when we have local path
+        NSString *pathToRegister = nil;
+        if (_lastLoadedPath.length > 0) {
+            pathToRegister = _lastLoadedPath;
+        } else if (_path.length > 0 && [_path hasPrefix:@"/"]) {
+            pathToRegister = _path;
+        }
+        if (_pdfId.length && pathToRegister.length > 0) {
+            [SearchRegistry registerPath:_pdfId path:pathToRegister];
+            RCTLogInfo(@"✅ [iOS] SearchRegistry registered path for pdfId: %@ (from updateProps)", _pdfId);
+        }
+    }
+    // Convert codegen vector of {page, rect} to NSArray for setHighlightRects
+    NSMutableArray *newHighlightRects = [NSMutableArray array];
+    for (const auto &item : newProps.highlightRects) {
+      [newHighlightRects addObject:@{ @"page": @(item.page), @"rect": [NSString stringWithUTF8String:item.rect.c_str()] }];
+    }
+    [self setHighlightRects:[newHighlightRects copy]];
+    [updatedPropNames addObject:@"highlightRects"];
     
     [super updateProps:props oldProps:oldProps];
     [self didSetProps:updatedPropNames];
@@ -329,10 +392,11 @@ using namespace facebook::react;
 - (void)prepareForRecycle
 {
     [super prepareForRecycle];
-
+    if (_pdfId.length) [SearchRegistry unregisterPath:_pdfId];
     [_pdfView removeFromSuperview];
     _pdfDocument = Nil;
     _pdfView = Nil;
+    _highlightOverlay = Nil;
     //Remove notifications
     [[NSNotificationCenter defaultCenter] removeObserver:self name:@"PDFViewDocumentChangedNotification" object:nil];
     [[NSNotificationCenter defaultCenter] removeObserver:self name:@"PDFViewPageChangedNotification" object:nil];
@@ -442,6 +506,11 @@ using namespace facebook::react;
     _preloadQueue.maxConcurrentOperationCount = 3;
     _preloadQueue.qualityOfService = NSQualityOfServiceBackground;
 
+    _pdfId = nil;
+    _highlightRects = nil;
+    _lastLoadedPath = nil;
+    _highlightOverlay = nil;
+
     // init and config PDFView
     _pdfView = [[PDFView alloc] initWithFrame:CGRectMake(0, 0, 500, 500)];
     _pdfView.displayMode = kPDFDisplaySinglePageContinuous;
@@ -997,10 +1066,58 @@ using namespace facebook::react;
         RCTLogInfo(@"🔍 [iOS] loadComplete message: %@", message);
         
         [self notifyOnChangeWithMessage:message];
+        
+        // Store local path so we can register when pdfId is set (Fabric may set pdfId after document load)
+        _lastLoadedPath = [pathValue copy];
+        // Register path for searchTextDirect (iOS parity with Android)
+        if (_pdfId.length && pathValue.length) {
+            [SearchRegistry registerPath:_pdfId path:pathValue];
+            RCTLogInfo(@"✅ [iOS] SearchRegistry registered path for pdfId: %@ (from onDocumentChanged)", _pdfId);
+        }
     }
 
 }
 
+- (void)setPdfId:(NSString *)pdfId {
+    if (_pdfId.length && ![pdfId isEqualToString:_pdfId]) {
+        [SearchRegistry unregisterPath:_pdfId];
+    }
+    _pdfId = [pdfId copy];
+    // If document already loaded, register path now (Fabric may set pdfId after path/document load).
+    // Only register local file paths; never register URIs (http/https) - PDFDocument needs file path.
+    NSString *pathToRegister = nil;
+    if (_lastLoadedPath.length > 0) {
+        pathToRegister = _lastLoadedPath;
+    } else if (_path.length > 0 && [_path hasPrefix:@"/"]) {
+        pathToRegister = _path;
+    }
+    if (_pdfId.length && pathToRegister.length > 0) {
+        [SearchRegistry registerPath:_pdfId path:pathToRegister];
+        RCTLogInfo(@"✅ [iOS] SearchRegistry registered path for pdfId: %@ (from setPdfId)", _pdfId);
+    }
+}
+
+- (void)setHighlightRects:(NSArray *)highlightRects {
+    _highlightRects = [highlightRects copy];
+    if (!_pdfView) return;
+    if (_highlightRects.count > 0) {
+        if (!_highlightOverlay) {
+            _highlightOverlay = [[HighlightOverlayView alloc] initWithFrame:_pdfView.bounds];
+            _highlightOverlay.backgroundColor = [UIColor clearColor];
+            _highlightOverlay.userInteractionEnabled = NO;
+            _highlightOverlay.autoresizingMask = UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight;
+            _highlightOverlay.pdfView = _pdfView;
+            [_pdfView addSubview:_highlightOverlay];
+            [_pdfView bringSubviewToFront:_highlightOverlay];
+        }
+        _highlightOverlay.highlightRects = _highlightRects;
+        [_highlightOverlay setNeedsDisplay];
+    } else if (_highlightOverlay) {
+        _highlightOverlay.highlightRects = @[];
+        [_highlightOverlay setNeedsDisplay];
+    }
+}
+
 -(NSString *) getTableContents
 {
 
@@ -1118,6 +1235,7 @@ using namespace facebook::react;
 
         RLog(@"Enhanced PDF: Navigated to page %d", _page);
         [self notifyOnChangeWithMessage:[[NSString alloc] initWithString:[NSString stringWithFormat:@"pageChanged|%lu|%lu", page+1, numberOfPages]]];
+        if (_highlightOverlay) [_highlightOverlay setNeedsDisplay];
     }
 
 }
@@ -1132,6 +1250,7 @@ using namespace facebook::react;
             [self notifyOnChangeWithMessage:[[NSString alloc] initWithString:[NSString stringWithFormat:@"scaleChanged|%f", _scale]]];
         }
     }
+    if (_highlightOverlay) [_highlightOverlay setNeedsDisplay];
 }
 
 #pragma mark gesture process
@@ -1435,9 +1554,11 @@ using namespace facebook::react;
 #pragma mark - UIScrollViewDelegate
 
 - (void)scrollViewDidScroll:(UIScrollView *)scrollView {
+    // Redraw highlight overlay so rects stay aligned when user scrolls (pan)
+    if (_highlightOverlay) [_highlightOverlay setNeedsDisplay];
     static int scrollEventCount = 0;
     scrollEventCount++;
-    
+
     // Log scroll events periodically (every 10th event to avoid spam)
     if (scrollEventCount % 10 == 0) {
         RCTLogInfo(@"📜 [iOS Scroll] scrollViewDidScroll #%d - offset=(%.2f, %.2f), contentSize=(%.2f, %.2f), bounds=(%.2f, %.2f), scrollEnabled=%d", 
@@ -1507,7 +1628,8 @@ using namespace facebook::react;
 #pragma mark - UIScrollViewDelegate Zoom Support
 
 - (void)scrollViewDidZoom:(UIScrollView *)scrollView {
-    // Called during pinch-to-zoom
+    // Called during pinch-to-zoom — redraw highlight overlay so rects stay aligned with zoomed content
+    if (_highlightOverlay) [_highlightOverlay setNeedsDisplay];
     if (_fixScaleFactor > 0 && _pdfView.scaleFactor > 0) {
         float newScale = _pdfView.scaleFactor / _fixScaleFactor;
 
@@ -1551,7 +1673,8 @@ using namespace facebook::react;
 - (void)scrollViewDidEndZooming:(UIScrollView *)scrollView
                         withView:(UIView *)view
                          atScale:(CGFloat)scale {
-    // Optional: Track zoom end
+    // Redraw highlight overlay so rects match final zoom level
+    if (_highlightOverlay) [_highlightOverlay setNeedsDisplay];
     RCTLogInfo(@"🔍 [iOS Zoom] Did end zooming at scale %f", scale);
 }
 

package/ios/RNPDFPdf/RNPDFPdfViewManager.mm

@@ -52,6 +52,8 @@ RCT_EXPORT_VIEW_PROPERTY(spacing, int);
 RCT_EXPORT_VIEW_PROPERTY(password, NSString);
 RCT_EXPORT_VIEW_PROPERTY(onChange, RCTBubblingEventBlock);
 RCT_EXPORT_VIEW_PROPERTY(singlePage, BOOL);
+RCT_EXPORT_VIEW_PROPERTY(pdfId, NSString);
+RCT_EXPORT_VIEW_PROPERTY(highlightRects, NSArray);
 
 RCT_EXPORT_METHOD(supportPDFKit:(RCTResponseSenderBlock)callback)
 {
@@ -177,12 +179,14 @@ RCT_EXPORT_METHOD(optimizeMemory:(NSString *)pdfId
 
 RCT_EXPORT_METHOD(searchTextDirect:(NSString *)pdfId
                   searchTerm:(NSString *)searchTerm
+                  startPage:(NSInteger)startPage
+                  endPage:(NSInteger)endPage
                   resolver:(RCTPromiseResolveBlock)resolve
                   rejecter:(RCTPromiseRejectBlock)reject)
 {
     PDFJSIManager *jsiManager = [self.bridge moduleForClass:[PDFJSIManager class]];
     if (jsiManager) {
-        [jsiManager searchTextDirect:pdfId searchTerm:searchTerm startPage:1 endPage:999 resolver:resolve rejecter:reject];
+        [jsiManager searchTextDirect:pdfId searchTerm:searchTerm startPage:startPage endPage:endPage resolver:resolve rejecter:reject];
     } else {
         reject(@"JSI_NOT_AVAILABLE", @"PDFJSIManager not available", nil);
     }

package/ios/RNPDFPdf/SearchRegistry.h

@@ -0,0 +1,21 @@
+/**
+ * Registry mapping pdfId to current PDF file path for programmatic search.
+ * RNPDFPdfView registers when a document loads with pdfId; searchTextDirect looks up path by pdfId.
+ * Also stores PDF page sizes in points (per pdfId + pageIndex) for highlight coordinate scaling.
+ */
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface SearchRegistry : NSObject
+
++ (void)registerPath:(NSString *)pdfId path:(NSString *)path;
++ (void)unregisterPath:(NSString *)pdfId;
++ (nullable NSString *)pathForPdfId:(NSString *)pdfId;
+
++ (void)registerPageSizePointsForPdfId:(NSString *)pdfId pageIndex0Based:(NSInteger)pageIndex widthPt:(CGFloat)widthPt heightPt:(CGFloat)heightPt;
++ (void)getPageSizePointsForPdfId:(NSString *)pdfId pageIndex0Based:(NSInteger)pageIndex widthOut:(CGFloat *)widthOut heightOut:(CGFloat *)heightOut;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/ios/RNPDFPdf/SearchRegistry.m

@@ -0,0 +1,71 @@
+/**
+ * Registry mapping pdfId to current PDF file path for programmatic search.
+ */
+#import "SearchRegistry.h"
+
+@implementation SearchRegistry
+
+static NSMutableDictionary<NSString *, NSString *> *_pathByPdfId;
+static NSMutableDictionary<NSString *, NSValue *> *_pageSizeByKey; // key = "pdfId_pageIndex", value = NSValue with CGSize
+static dispatch_queue_t _queue;
+
++ (void)initialize {
+    if (self == [SearchRegistry class]) {
+        _pathByPdfId = [NSMutableDictionary new];
+        _pageSizeByKey = [NSMutableDictionary new];
+        _queue = dispatch_queue_create("com.rnpdf.searchregistry", DISPATCH_QUEUE_SERIAL);
+    }
+}
+
++ (void)registerPath:(NSString *)pdfId path:(NSString *)path {
+    if (!pdfId.length || !path.length) return;
+    dispatch_sync(_queue, ^{
+        _pathByPdfId[pdfId] = path;
+    });
+}
+
++ (void)unregisterPath:(NSString *)pdfId {
+    if (!pdfId.length) return;
+    dispatch_sync(_queue, ^{
+        [_pathByPdfId removeObjectForKey:pdfId];
+        NSString *prefix = [pdfId stringByAppendingString:@"_"];
+        NSArray *keysToRemove = [_pageSizeByKey.allKeys filteredArrayUsingPredicate:
+            [NSPredicate predicateWithBlock:^BOOL(NSString *key, id _) { return [key hasPrefix:prefix]; }]];
+        [_pageSizeByKey removeObjectsForKeys:keysToRemove];
+    });
+}
+
++ (NSString *)pathForPdfId:(NSString *)pdfId {
+    if (!pdfId.length) return nil;
+    __block NSString *path = nil;
+    dispatch_sync(_queue, ^{
+        path = _pathByPdfId[pdfId];
+    });
+    return path;
+}
+
++ (void)registerPageSizePointsForPdfId:(NSString *)pdfId pageIndex0Based:(NSInteger)pageIndex widthPt:(CGFloat)widthPt heightPt:(CGFloat)heightPt {
+    if (!pdfId.length || widthPt <= 0 || heightPt <= 0) return;
+    NSString *key = [NSString stringWithFormat:@"%@_%ld", pdfId, (long)pageIndex];
+    dispatch_sync(_queue, ^{
+        _pageSizeByKey[key] = [NSValue valueWithCGSize:CGSizeMake(widthPt, heightPt)];
+    });
+}
+
++ (void)getPageSizePointsForPdfId:(NSString *)pdfId pageIndex0Based:(NSInteger)pageIndex widthOut:(CGFloat *)widthOut heightOut:(CGFloat *)heightOut {
+    if (!pdfId.length || !widthOut || !heightOut) return;
+    *widthOut = 0;
+    *heightOut = 0;
+    NSString *key = [NSString stringWithFormat:@"%@_%ld", pdfId, (long)pageIndex];
+    __block NSValue *val = nil;
+    dispatch_sync(_queue, ^{
+        val = _pageSizeByKey[key];
+    });
+    if (val) {
+        CGSize s = [val CGSizeValue];
+        *widthOut = s.width;
+        *heightOut = s.height;
+    }
+}
+
+@end

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "react-native-pdf-jsi",
-    "version": "4.3.2",
+    "version": "4.4.0",
     "summary": "High-performance React Native PDF viewer with JSI acceleration - up to 80x faster than traditional bridge",
     "description": "🚀 Ultra-fast React Native PDF viewer with JSI (JavaScript Interface) integration for maximum performance. Features lazy loading, smart caching, progressive loading, and zero-bridge overhead operations. Perfect for large PDF files with 30-day persistent cache and advanced memory optimization. Google Play 16KB page size compliant for Android 15+. Supports iOS, Android, and Windows platforms.",
     "main": "index.js",
@@ -80,7 +80,9 @@
     },
     "scripts": {
         "build:plugin": "tsc -p plugin/tsconfig.json",
-        "prepublishOnly": "npm run build:plugin"
+        "prepublishOnly": "npm run build:plugin",
+        "clean:for-publish": "node -e \"const fs=require('fs'),path=require('path');['android/.cxx','android/.gradle','android/build'].forEach(p=>{try{fs.rmSync(path.join(__dirname,p),{recursive:true});console.log('Removed',p);}catch(e){}})\"",
+        "prepack": "npm run clean:for-publish"
     },
     "peerDependencies": {
         "@react-native-async-storage/async-storage": ">=1.17.0",

package/src/PDFJSI.js

@@ -392,7 +392,7 @@ class PDFJSIManager {
             if (Platform.OS === 'android') {
                 results = await PDFJSIManagerNative.searchTextDirect(pdfId, searchTerm, startPage, endPage);
             } else if (Platform.OS === 'ios') {
-                results = await RNPDFPdfViewManager.searchTextDirect(pdfId, searchTerm);
+                results = await RNPDFPdfViewManager.searchTextDirect(pdfId, searchTerm, startPage, endPage);
             } else {
                 throw new Error(`Platform ${Platform.OS} not supported`);
             }

package/android/.gradle/buildOutputCleanup/cache.properties

@@ -1,2 +0,0 @@
-#Thu Oct 02 20:04:14 IST 2025
-gradle.version=8.5