@thatkid02/react-native-pdf-viewer 0.0.2 → 0.0.4

package/ios/PdfViewer.swift

@@ -1,6 +1,7 @@
 import Foundation
 import PDFKit
 import NitroModules
+import CryptoKit
 
 //  Error Types
 enum PdfViewerError: LocalizedError {
@@ -68,10 +69,12 @@ class HybridPdfViewer: HybridPdfViewerSpec {
   private var activityIndicator: UIActivityIndicatorView!
   private var document: PDFDocument?
   private var sourceUri: String?
+  private var documentHash: String?  // MD5 hash of source URI for caching
   private var urlSession: URLSession!
   private var downloadTask: URLSessionDataTask?
   private var loadToken: Int = 0
   private var boundsObservation: NSKeyValueObservation?
+  private var backgroundObserver: NSObjectProtocol?
   private var isLoading: Bool = false {
     didSet {
       if isLoading != oldValue {
@@ -81,14 +84,9 @@ class HybridPdfViewer: HybridPdfViewerSpec {
     }
   }
   
-  // Optimized caching with limits
-  private lazy var thumbnailCache: NSCache<NSNumber, NSString> = {
-    let cache = NSCache<NSNumber, NSString>()
-    cache.countLimit = 50  // Max 50 thumbnails in memory
-    cache.totalCostLimit = 10 * 1024 * 1024  // 10MB limit
-    cache.evictsObjectsWithDiscardedContent = true
-    return cache
-  }()
+  // URL-scoped thumbnail cache: document hash -> page index -> URI
+  private var thumbnailCache = [String: [Int: String]]()
+  private let cacheLock = NSLock()
   
   // Dedicated queue for thumbnail generation with limited concurrency
   private let thumbnailQueue = DispatchQueue(label: "com.pdfviewer.thumbnails", qos: .utility, attributes: .concurrent)
@@ -345,19 +343,42 @@ class HybridPdfViewer: HybridPdfViewerSpec {
       object: nil
     )
     
+    // Observe app entering background to cleanup thumbnail cache
+    backgroundObserver = NotificationCenter.default.addObserver(
+      forName: UIApplication.didEnterBackgroundNotification,
+      object: nil,
+      queue: .main
+    ) { [weak self] _ in
+      self?.cleanupThumbnailDirectory()
+    }
+    
     // Observe bounds changes to update scale factor when view is resized
     boundsObservation = pdfView.observe(\.bounds, options: [.new]) { [weak self] _, _ in
-      self?.updateScaleToFitWidthIfNeeded()
+      guard let self = self else { return }
+      // Only re-enable autoScales during bounds change if we're at default scale
+      // This allows manual zoom to persist through view lifecycle changes
+      if self.pdfView.displayMode == .singlePageContinuous && self.pdfView.scaleFactor == 1.0 {
+        self.pdfView.autoScales = true
+      }
+      self.updateScaleToFitWidthIfNeeded()
     }
   }
   
   deinit {
     NotificationCenter.default.removeObserver(self)
+    if let observer = backgroundObserver {
+      NotificationCenter.default.removeObserver(observer)
+    }
     boundsObservation?.invalidate()
     downloadTask?.cancel()
     urlSession.invalidateAndCancel()
-    thumbnailCache.removeAllObjects()
-    cleanupThumbnailDirectory()
+    
+    // Clear in-memory cache for this document only (disk cache persists)
+    if let hash = documentHash {
+      cacheLock.lock()
+      thumbnailCache.removeValue(forKey: hash)
+      cacheLock.unlock()
+    }
   }
   
   //  Document Loading
@@ -387,6 +408,7 @@ class HybridPdfViewer: HybridPdfViewerSpec {
     
     // Store the source URI for thumbnail caching
     sourceUri = source
+    documentHash = computeDocumentHash(source)
     
     guard let url = resolveURL(from: source) else {
       ensureMainThread { self.isLoading = false }
@@ -492,11 +514,25 @@ class HybridPdfViewer: HybridPdfViewerSpec {
     isLoading = false
     self.document = document
     pdfView.document = document
-    thumbnailCache.removeAllObjects()
+    
+    // Clear in-memory cache for all documents
+    cacheLock.lock()
+    thumbnailCache.removeAll()
+    cacheLock.unlock()
+    
+    // Ensure autoScales is enabled for proper width fitting
+    pdfView.autoScales = true
     
     // Update scale after document is loaded
     updateScaleToFitWidthIfNeeded()
     
+    // If bounds were zero, schedule a delayed update
+    if pdfView.bounds.width == 0 {
+      DispatchQueue.main.asyncAfter(deadline: .now() + 0.1) { [weak self] in
+        self?.updateScaleToFitWidthIfNeeded()
+      }
+    }
+    
     if let firstPage = document.page(at: 0) {
       let pageRect = firstPage.bounds(for: .mediaBox)
       onLoadComplete?(LoadCompleteEvent(
@@ -517,10 +553,18 @@ class HybridPdfViewer: HybridPdfViewerSpec {
     // Only update scale if view has been laid out (width > 0)
     guard viewWidth > 0 && pageRect.width > 0 else { return }
     
-    // In continuous scroll mode with autoScales=true, PDFKit handles scaling automatically
-    // We just need to ensure autoScales is enabled
+    // In continuous scroll mode, check if we should enable autoScales
     if pdfView.displayMode == .singlePageContinuous {
-      pdfView.autoScales = true
+      // Only enable autoScales if at default scale (hasn't been manually zoomed)
+      // This preserves user's manual zoom level through view lifecycle
+      let currentScale = pdfView.scaleFactor
+      let isDefaultScale = abs(currentScale - 1.0) < 0.01
+      
+      if isDefaultScale {
+        pdfView.autoScales = true
+        // Force PDFView to recalculate scale if needed
+        pdfView.layoutDocumentView()
+      }
     } else {
       // For paging mode, calculate and set the scale to fit width
       let scale = viewWidth / pageRect.width
@@ -557,7 +601,9 @@ class HybridPdfViewer: HybridPdfViewerSpec {
   
   @objc private func didReceiveMemoryWarning() {
     // Clear thumbnail cache to free up memory
-    thumbnailCache.removeAllObjects()
+    cacheLock.lock()
+    thumbnailCache.removeAll()
+    cacheLock.unlock()
     
     // Clear pending thumbnails set
     pendingLock.lock()
@@ -599,13 +645,11 @@ class HybridPdfViewer: HybridPdfViewerSpec {
     let maxScale = CGFloat(self.maxScale ?? 4.0)
     let clampedScale = max(minScale, min(maxScale, CGFloat(scale)))
     
-    // Ensure UI update happens on main thread
-    if Thread.isMainThread {
-      pdfView.scaleFactor = clampedScale
-    } else {
-      DispatchQueue.main.async { [weak self] in
-        self?.pdfView.scaleFactor = clampedScale
-      }
+    // Disable autoScales when manually setting scale
+    // This allows programmatic zoom control to work
+    ensureMainThread {
+      self.pdfView.autoScales = false
+      self.pdfView.scaleFactor = clampedScale
     }
   }
   
@@ -614,16 +658,37 @@ class HybridPdfViewer: HybridPdfViewerSpec {
       throw PdfViewerError.documentNotLoaded
     }
     
+    guard let hash = documentHash else {
+      throw PdfViewerError.invalidSource
+    }
+    
     let pageIndex = Int(page)
     guard pageIndex >= 0 && pageIndex < document.pageCount else {
       throw PdfViewerError.invalidPageIndex(page: pageIndex, pageCount: document.pageCount)
     }
     
-    let pageKey = NSNumber(value: pageIndex)
+    // Check in-memory cache first
+    cacheLock.lock()
+    if let cachedUri = thumbnailCache[hash]?[pageIndex] {
+      cacheLock.unlock()
+      onThumbnailGenerated?(ThumbnailGeneratedEvent(page: Double(pageIndex), uri: cachedUri))
+      return
+    }
+    cacheLock.unlock()
     
-    // Return cached thumbnail immediately if available
-    if let cached = thumbnailCache.object(forKey: pageKey) {
-      onThumbnailGenerated?(ThumbnailGeneratedEvent(page: Double(pageIndex), uri: cached as String))
+    // Check disk cache before generating
+    let diskPath = getThumbnailPath(hash: hash, page: pageIndex)
+    if FileManager.default.fileExists(atPath: diskPath.path) {
+      let uri = diskPath.absoluteString
+      // Cache in memory
+      cacheLock.lock()
+      if thumbnailCache[hash] == nil {
+        thumbnailCache[hash] = [:]
+      }
+      thumbnailCache[hash]?[pageIndex] = uri
+      cacheLock.unlock()
+      
+      onThumbnailGenerated?(ThumbnailGeneratedEvent(page: Double(pageIndex), uri: uri))
       return
     }
     
@@ -649,15 +714,23 @@ class HybridPdfViewer: HybridPdfViewerSpec {
       self.thumbnailSemaphore.wait()
       defer { self.thumbnailSemaphore.signal() }
       
-      // Double-check cache after acquiring semaphore
-      if let cached = self.thumbnailCache.object(forKey: pageKey) {
+      // Double-check disk cache after acquiring semaphore
+      if FileManager.default.fileExists(atPath: diskPath.path) {
+        let uri = diskPath.absoluteString
+        self.cacheLock.lock()
+        if self.thumbnailCache[hash] == nil {
+          self.thumbnailCache[hash] = [:]
+        }
+        self.thumbnailCache[hash]?[pageIndex] = uri
+        self.cacheLock.unlock()
+        
         DispatchQueue.main.async { [weak self] in
-          self?.onThumbnailGenerated?(ThumbnailGeneratedEvent(page: Double(pageIndex), uri: cached as String))
+          self?.onThumbnailGenerated?(ThumbnailGeneratedEvent(page: Double(pageIndex), uri: uri))
         }
         return
       }
       
-      self.generateThumbnailSync(document: document, pageIndex: pageIndex, pageKey: pageKey)
+      self.generateThumbnailSync(document: document, pageIndex: pageIndex, hash: hash)
     }
   }
   
@@ -666,6 +739,10 @@ class HybridPdfViewer: HybridPdfViewerSpec {
       throw PdfViewerError.documentNotLoaded
     }
     
+    guard let hash = documentHash else {
+      throw PdfViewerError.invalidSource
+    }
+    
     let pageCount = document.pageCount
     
     // Process thumbnails in batches for better memory management
@@ -674,12 +751,30 @@ class HybridPdfViewer: HybridPdfViewerSpec {
       
       for pageIndex in 0..<pageCount {
         autoreleasepool {
-          let pageKey = NSNumber(value: pageIndex)
+          // Check in-memory cache
+          self.cacheLock.lock()
+          if let cachedUri = self.thumbnailCache[hash]?[pageIndex] {
+            self.cacheLock.unlock()
+            DispatchQueue.main.async { [weak self] in
+              self?.onThumbnailGenerated?(ThumbnailGeneratedEvent(page: Double(pageIndex), uri: cachedUri))
+            }
+            return
+          }
+          self.cacheLock.unlock()
           
-          // Return cached thumbnail immediately
-          if let cached = self.thumbnailCache.object(forKey: pageKey) {
+          // Check disk cache
+          let diskPath = self.getThumbnailPath(hash: hash, page: pageIndex)
+          if FileManager.default.fileExists(atPath: diskPath.path) {
+            let uri = diskPath.absoluteString
+            self.cacheLock.lock()
+            if self.thumbnailCache[hash] == nil {
+              self.thumbnailCache[hash] = [:]
+            }
+            self.thumbnailCache[hash]?[pageIndex] = uri
+            self.cacheLock.unlock()
+            
             DispatchQueue.main.async { [weak self] in
-              self?.onThumbnailGenerated?(ThumbnailGeneratedEvent(page: Double(pageIndex), uri: cached as String))
+              self?.onThumbnailGenerated?(ThumbnailGeneratedEvent(page: Double(pageIndex), uri: uri))
             }
             return
           }
@@ -687,14 +782,38 @@ class HybridPdfViewer: HybridPdfViewerSpec {
           self.thumbnailSemaphore.wait()
           defer { self.thumbnailSemaphore.signal() }
           
-          self.generateThumbnailSync(document: document, pageIndex: pageIndex, pageKey: pageKey)
+          self.generateThumbnailSync(document: document, pageIndex: pageIndex, hash: hash)
         }
       }
     }
   }
   
+  func getDocumentInfo() throws -> DocumentInfo? {
+    guard let document = document else {
+      return nil
+    }
+    
+    guard let firstPage = document.page(at: 0) else {
+      return nil
+    }
+    
+    // Get current page index
+    var currentPageIndex = 0
+    if let currentPage = pdfView.currentPage {
+      currentPageIndex = document.index(for: currentPage)
+    }
+    
+    let bounds = firstPage.bounds(for: .mediaBox)
+    return DocumentInfo(
+      pageCount: Double(document.pageCount),
+      pageWidth: bounds.width,
+      pageHeight: bounds.height,
+      currentPage: Double(currentPageIndex)
+    )
+  }
+  
   //  Private Thumbnail Generation
-  private func generateThumbnailSync(document: PDFDocument, pageIndex: Int, pageKey: NSNumber) {
+  private func generateThumbnailSync(document: PDFDocument, pageIndex: Int, hash: String) {
     guard let pdfPage = document.page(at: pageIndex) else { return }
     
     let pageRect = pdfPage.bounds(for: .mediaBox)
@@ -706,10 +825,14 @@ class HybridPdfViewer: HybridPdfViewerSpec {
     
     let thumbnail = pdfPage.thumbnail(of: CGSize(width: thumbWidth, height: thumbHeight), for: .mediaBox)
     
-    if let uri = saveThumbnailToCache(thumbnail, page: pageIndex) {
-      // Calculate approximate memory cost for cache
-      let cost = Int(thumbWidth * thumbHeight * 4)  // Approximate bytes
-      thumbnailCache.setObject(uri as NSString, forKey: pageKey, cost: cost)
+    if let uri = saveThumbnailToCache(thumbnail, page: pageIndex, hash: hash) {
+      // Cache in memory
+      cacheLock.lock()
+      if thumbnailCache[hash] == nil {
+        thumbnailCache[hash] = [:]
+      }
+      thumbnailCache[hash]?[pageIndex] = uri
+      cacheLock.unlock()
       
       DispatchQueue.main.async { [weak self] in
         self?.onThumbnailGenerated?(ThumbnailGeneratedEvent(page: Double(pageIndex), uri: uri))
@@ -720,16 +843,17 @@ class HybridPdfViewer: HybridPdfViewerSpec {
   }
   
   //  Helper Methods
-  private func saveThumbnailToCache(_ image: UIImage, page: Int) -> String? {
+  private func saveThumbnailToCache(_ image: UIImage, page: Int, hash: String) -> String? {
     guard let data = image.jpegData(compressionQuality: 0.8) else { return nil }
     
-    let hash = abs(sourceUri?.hashValue ?? 0)
-    let fileName = "thumb_\(page)_\(hash).jpg"
-    let cacheDir = FileManager.default.temporaryDirectory.appendingPathComponent("PDFThumbnails")
+    let fileName = "\(page).jpg"
+    let documentCacheDir = FileManager.default.temporaryDirectory
+      .appendingPathComponent("PDFThumbnails")
+      .appendingPathComponent(hash)
     
     do {
-      try FileManager.default.createDirectory(at: cacheDir, withIntermediateDirectories: true)
-      let fileURL = cacheDir.appendingPathComponent(fileName)
+      try FileManager.default.createDirectory(at: documentCacheDir, withIntermediateDirectories: true)
+      let fileURL = documentCacheDir.appendingPathComponent(fileName)
       try data.write(to: fileURL, options: .atomic)
       return fileURL.absoluteString
     } catch {
@@ -737,6 +861,19 @@ class HybridPdfViewer: HybridPdfViewerSpec {
     }
   }
   
+  private func getThumbnailPath(hash: String, page: Int) -> URL {
+    return FileManager.default.temporaryDirectory
+      .appendingPathComponent("PDFThumbnails")
+      .appendingPathComponent(hash)
+      .appendingPathComponent("\(page).jpg")
+  }
+  
+  private func computeDocumentHash(_ uri: String) -> String {
+    let data = Data(uri.utf8)
+    let digest = Insecure.MD5.hash(data: data)
+    return digest.map { String(format: "%02hhx", $0) }.joined()
+  }
+  
   private func emitError(_ error: PdfViewerError) {
     onError?(ErrorEvent(message: error.errorDescription ?? "Unknown error", code: error.errorCode))
   }

package/lib/typescript/src/PdfViewer.nitro.d.ts

@@ -4,6 +4,12 @@ export interface LoadCompleteEvent {
     pageWidth: number;
     pageHeight: number;
 }
+export interface DocumentInfo {
+    pageCount: number;
+    pageWidth: number;
+    pageHeight: number;
+    currentPage: number;
+}
 export interface PageChangeEvent {
     page: number;
     pageCount: number;
@@ -81,6 +87,7 @@ export interface PdfViewerMethods extends HybridViewMethods {
     setScale(scale: number): void;
     generateThumbnail(page: number): void;
     generateAllThumbnails(): void;
+    getDocumentInfo(): DocumentInfo | null;
 }
 export type PdfViewer = HybridView<PdfViewerProps, PdfViewerMethods>;
 //# sourceMappingURL=PdfViewer.nitro.d.ts.map

package/lib/typescript/src/PdfViewer.nitro.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PdfViewer.nitro.d.ts","sourceRoot":"","sources":["../../../src/PdfViewer.nitro.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,iBAAiB,EACjB,eAAe,EAChB,MAAM,4BAA4B,CAAC;AAEpC,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,OAAO,CAAC;CACpB;AAGD,MAAM,WAAW,iBAAiB;IAEhC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAe,SAAQ,eAAe;IACrD;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAG3B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAGjC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACpD,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IAChD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAClD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACtC,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,CAAC;IAChE,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;CACvD;AAED,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IAEzD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAG7B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAG9B,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAGtC,qBAAqB,IAAI,IAAI,CAAC;CAC/B;AAED,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC"}
+{"version":3,"file":"PdfViewer.nitro.d.ts","sourceRoot":"","sources":["../../../src/PdfViewer.nitro.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,iBAAiB,EACjB,eAAe,EAChB,MAAM,4BAA4B,CAAC;AAEpC,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,OAAO,CAAC;CACpB;AAGD,MAAM,WAAW,iBAAiB;IAEhC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAe,SAAQ,eAAe;IACrD;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAG3B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAGjC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACpD,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IAChD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAClD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACtC,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,CAAC;IAChE,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;CACvD;AAED,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IAEzD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAG7B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAG9B,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAGtC,qBAAqB,IAAI,IAAI,CAAC;IAG9B,eAAe,IAAI,YAAY,GAAG,IAAI,CAAC;CACxC;AAED,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC"}

package/nitrogen/generated/android/c++/JDocumentInfo.hpp

@@ -0,0 +1,65 @@
+///
+/// JDocumentInfo.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#include <fbjni/fbjni.h>
+#include "DocumentInfo.hpp"
+
+
+
+namespace margelo::nitro::pdfviewer {
+
+  using namespace facebook;
+
+  /**
+   * The C++ JNI bridge between the C++ struct "DocumentInfo" and the the Kotlin data class "DocumentInfo".
+   */
+  struct JDocumentInfo final: public jni::JavaClass<JDocumentInfo> {
+  public:
+    static auto constexpr kJavaDescriptor = "Lcom/margelo/nitro/pdfviewer/DocumentInfo;";
+
+  public:
+    /**
+     * Convert this Java/Kotlin-based struct to the C++ struct DocumentInfo by copying all values to C++.
+     */
+    [[maybe_unused]]
+    [[nodiscard]]
+    DocumentInfo toCpp() const {
+      static const auto clazz = javaClassStatic();
+      static const auto fieldPageCount = clazz->getField<double>("pageCount");
+      double pageCount = this->getFieldValue(fieldPageCount);
+      static const auto fieldPageWidth = clazz->getField<double>("pageWidth");
+      double pageWidth = this->getFieldValue(fieldPageWidth);
+      static const auto fieldPageHeight = clazz->getField<double>("pageHeight");
+      double pageHeight = this->getFieldValue(fieldPageHeight);
+      static const auto fieldCurrentPage = clazz->getField<double>("currentPage");
+      double currentPage = this->getFieldValue(fieldCurrentPage);
+      return DocumentInfo(
+        pageCount,
+        pageWidth,
+        pageHeight,
+        currentPage
+      );
+    }
+
+  public:
+    /**
+     * Create a Java/Kotlin-based struct by copying all values from the given C++ struct to Java.
+     */
+    [[maybe_unused]]
+    static jni::local_ref<JDocumentInfo::javaobject> fromCpp(const DocumentInfo& value) {
+      return newInstance(
+        value.pageCount,
+        value.pageWidth,
+        value.pageHeight,
+        value.currentPage
+      );
+    }
+  };
+
+} // namespace margelo::nitro::pdfviewer

package/nitrogen/generated/android/c++/JHybridPdfViewerSpec.cpp

@@ -19,6 +19,8 @@ namespace margelo::nitro::pdfviewer { struct ErrorEvent; }
 namespace margelo::nitro::pdfviewer { struct ThumbnailGeneratedEvent; }
 // Forward declaration of `LoadingChangeEvent` to properly resolve imports.
 namespace margelo::nitro::pdfviewer { struct LoadingChangeEvent; }
+// Forward declaration of `DocumentInfo` to properly resolve imports.
+namespace margelo::nitro::pdfviewer { struct DocumentInfo; }
 
 #include <string>
 #include <optional>
@@ -41,6 +43,8 @@ namespace margelo::nitro::pdfviewer { struct LoadingChangeEvent; }
 #include "LoadingChangeEvent.hpp"
 #include "JFunc_void_LoadingChangeEvent.hpp"
 #include "JLoadingChangeEvent.hpp"
+#include "DocumentInfo.hpp"
+#include "JDocumentInfo.hpp"
 
 namespace margelo::nitro::pdfviewer {
 
@@ -305,5 +309,10 @@ namespace margelo::nitro::pdfviewer {
     static const auto method = javaClassStatic()->getMethod<void()>("generateAllThumbnails");
     method(_javaPart);
   }
+  std::optional<DocumentInfo> JHybridPdfViewerSpec::getDocumentInfo() {
+    static const auto method = javaClassStatic()->getMethod<jni::local_ref<JDocumentInfo>()>("getDocumentInfo");
+    auto __result = method(_javaPart);
+    return __result != nullptr ? std::make_optional(__result->toCpp()) : std::nullopt;
+  }
 
 } // namespace margelo::nitro::pdfviewer

package/nitrogen/generated/android/c++/JHybridPdfViewerSpec.hpp

@@ -92,6 +92,7 @@ namespace margelo::nitro::pdfviewer {
     void setScale(double scale) override;
     void generateThumbnail(double page) override;
     void generateAllThumbnails() override;
+    std::optional<DocumentInfo> getDocumentInfo() override;
 
   private:
     friend HybridBase;

package/nitrogen/generated/android/kotlin/com/margelo/nitro/pdfviewer/DocumentInfo.kt

@@ -0,0 +1,38 @@
+///
+/// DocumentInfo.kt
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2026 Marc Rousavy @ Margelo
+///
+
+package com.margelo.nitro.pdfviewer
+
+import androidx.annotation.Keep
+import com.facebook.proguard.annotations.DoNotStrip
+import com.margelo.nitro.core.*
+
+
+/**
+ * Represents the JavaScript object/struct "DocumentInfo".
+ */
+@DoNotStrip
+@Keep
+data class DocumentInfo
+  @DoNotStrip
+  @Keep
+  constructor(
+    @DoNotStrip
+    @Keep
+    val pageCount: Double,
+    @DoNotStrip
+    @Keep
+    val pageWidth: Double,
+    @DoNotStrip
+    @Keep
+    val pageHeight: Double,
+    @DoNotStrip
+    @Keep
+    val currentPage: Double
+  ) {
+  /* main constructor */
+}

package/nitrogen/generated/android/kotlin/com/margelo/nitro/pdfviewer/HybridPdfViewerSpec.kt

@@ -210,6 +210,10 @@ abstract class HybridPdfViewerSpec: HybridView() {
   @DoNotStrip
   @Keep
   abstract fun generateAllThumbnails(): Unit
+  
+  @DoNotStrip
+  @Keep
+  abstract fun getDocumentInfo(): DocumentInfo?
 
   private external fun initHybrid(): HybridData
 

package/nitrogen/generated/ios/PdfViewer-Swift-Cxx-Bridge.hpp

@@ -8,6 +8,8 @@
 #pragma once
 
 // Forward declarations of C++ defined types
+// Forward declaration of `DocumentInfo` to properly resolve imports.
+namespace margelo::nitro::pdfviewer { struct DocumentInfo; }
 // Forward declaration of `ErrorEvent` to properly resolve imports.
 namespace margelo::nitro::pdfviewer { struct ErrorEvent; }
 // Forward declaration of `HybridPdfViewerSpec` to properly resolve imports.
@@ -28,6 +30,7 @@ namespace margelo::nitro::pdfviewer { struct ThumbnailGeneratedEvent; }
 namespace PdfViewer { class HybridPdfViewerSpec_cxx; }
 
 // Include C++ defined types
+#include "DocumentInfo.hpp"
 #include "ErrorEvent.hpp"
 #include "HybridPdfViewerSpec.hpp"
 #include "LoadCompleteEvent.hpp"
@@ -315,6 +318,21 @@ namespace margelo::nitro::pdfviewer::bridge::swift {
     return *optional;
   }
   
+  // pragma MARK: std::optional<DocumentInfo>
+  /**
+   * Specialized version of `std::optional<DocumentInfo>`.
+   */
+  using std__optional_DocumentInfo_ = std::optional<DocumentInfo>;
+  inline std::optional<DocumentInfo> create_std__optional_DocumentInfo_(const DocumentInfo& value) noexcept {
+    return std::optional<DocumentInfo>(value);
+  }
+  inline bool has_value_std__optional_DocumentInfo_(const std::optional<DocumentInfo>& optional) noexcept {
+    return optional.has_value();
+  }
+  inline DocumentInfo get_std__optional_DocumentInfo_(const std::optional<DocumentInfo>& optional) noexcept {
+    return *optional;
+  }
+  
   // pragma MARK: std::shared_ptr<HybridPdfViewerSpec>
   /**
    * Specialized version of `std::shared_ptr<HybridPdfViewerSpec>`.
@@ -335,5 +353,14 @@ namespace margelo::nitro::pdfviewer::bridge::swift {
   inline Result_void_ create_Result_void_(const std::exception_ptr& error) noexcept {
     return Result<void>::withError(error);
   }
+  
+  // pragma MARK: Result<std::optional<DocumentInfo>>
+  using Result_std__optional_DocumentInfo__ = Result<std::optional<DocumentInfo>>;
+  inline Result_std__optional_DocumentInfo__ create_Result_std__optional_DocumentInfo__(const std::optional<DocumentInfo>& value) noexcept {
+    return Result<std::optional<DocumentInfo>>::withValue(value);
+  }
+  inline Result_std__optional_DocumentInfo__ create_Result_std__optional_DocumentInfo__(const std::exception_ptr& error) noexcept {
+    return Result<std::optional<DocumentInfo>>::withError(error);
+  }
 
 } // namespace margelo::nitro::pdfviewer::bridge::swift

package/nitrogen/generated/ios/PdfViewer-Swift-Cxx-Umbrella.hpp

@@ -8,6 +8,8 @@
 #pragma once
 
 // Forward declarations of C++ defined types
+// Forward declaration of `DocumentInfo` to properly resolve imports.
+namespace margelo::nitro::pdfviewer { struct DocumentInfo; }
 // Forward declaration of `ErrorEvent` to properly resolve imports.
 namespace margelo::nitro::pdfviewer { struct ErrorEvent; }
 // Forward declaration of `HybridPdfViewerSpec` to properly resolve imports.
@@ -24,6 +26,7 @@ namespace margelo::nitro::pdfviewer { struct ScaleChangeEvent; }
 namespace margelo::nitro::pdfviewer { struct ThumbnailGeneratedEvent; }
 
 // Include C++ defined types
+#include "DocumentInfo.hpp"
 #include "ErrorEvent.hpp"
 #include "HybridPdfViewerSpec.hpp"
 #include "LoadCompleteEvent.hpp"

package/nitrogen/generated/ios/c++/HybridPdfViewerSpecSwift.hpp

@@ -24,6 +24,8 @@ namespace margelo::nitro::pdfviewer { struct ErrorEvent; }
 namespace margelo::nitro::pdfviewer { struct ThumbnailGeneratedEvent; }
 // Forward declaration of `LoadingChangeEvent` to properly resolve imports.
 namespace margelo::nitro::pdfviewer { struct LoadingChangeEvent; }
+// Forward declaration of `DocumentInfo` to properly resolve imports.
+namespace margelo::nitro::pdfviewer { struct DocumentInfo; }
 
 #include <string>
 #include <optional>
@@ -34,6 +36,7 @@ namespace margelo::nitro::pdfviewer { struct LoadingChangeEvent; }
 #include "ErrorEvent.hpp"
 #include "ThumbnailGeneratedEvent.hpp"
 #include "LoadingChangeEvent.hpp"
+#include "DocumentInfo.hpp"
 
 #include "PdfViewer-Swift-Cxx-Umbrella.hpp"
 
@@ -225,6 +228,14 @@ namespace margelo::nitro::pdfviewer {
         std::rethrow_exception(__result.error());
       }
     }
+    inline std::optional<DocumentInfo> getDocumentInfo() override {
+      auto __result = _swiftPart.getDocumentInfo();
+      if (__result.hasError()) [[unlikely]] {
+        std::rethrow_exception(__result.error());
+      }
+      auto __value = std::move(__result.value());
+      return __value;
+    }
 
   private:
     PdfViewer::HybridPdfViewerSpec_cxx _swiftPart;