react-native-pdfrender 0.1.0

package/src/specs/NativePdfViewerModule.ts

@@ -0,0 +1,58 @@
+/**
+ * Codegen spec for PdfViewerTurboModule.
+ *
+ * Codegen reads this file at build time and generates:
+ *   Android: abstract Kotlin class `NativePdfViewerModuleSpec`
+ *
+ * The name passed to TurboModuleRegistry.getEnforcing() MUST match the
+ * string returned by PdfViewerTurboModule.getName() in Kotlin.
+ *
+ * Method signatures here are the source of truth — if the Kotlin
+ * implementation diverges, the build fails at compile time.
+ */
+
+import type { TurboModule } from 'react-native';
+import { TurboModuleRegistry } from 'react-native';
+
+export interface PdfCreationResult {
+  base64: string;
+  path: string;
+}
+
+export interface PdfPage {
+  title: string;
+  body: string;
+}
+
+export interface Spec extends TurboModule {
+  /**
+   * Show the PDF viewer inside the host Activity's Fragment back-stack.
+   * No new Activity is started — uses PdfViewerFragment.
+   *
+   * @param uri         PDF file URI  (file:// or content://)
+   * @param pageIndex   0-based page to open on start (-1 = first page)
+   * @param defaultZoom Initial zoom level (1.0 = 100%, 1.5 = 150%)
+   */
+  openPdfViewer(uri: string, pageIndex: number, defaultZoom: number): void;
+
+  /**
+   * Dismiss the viewer Fragment if it is currently visible.
+   */
+  dismissPdfViewer(): void;
+
+  /**
+   * Async: returns total page count without rendering the PDF.
+   */
+  getPdfPageCount(uri: string): Promise<number>;
+
+  /**
+   * Generate a multi-page PDF from structured content and return as Base64.
+   */
+  createMultiPagePdfBase64(
+    pages: ReadonlyArray<PdfPage>,
+    widthPx: number,
+    heightPx: number
+  ): Promise<PdfCreationResult>;
+}
+
+export default TurboModuleRegistry.getEnforcing<Spec>('NativePdfViewerModule');

package/src/usePdfViewer.ts

@@ -0,0 +1,102 @@
+/**
+ * usePdfViewer — programmatic (Fragment-based) PDF viewer hook.
+ *
+ * Use this when you want to open the PDF viewer imperatively (like a modal),
+ * without embedding a <PdfViewerView /> in the render tree.
+ *
+ * Under the hood it calls PdfViewerTurboModule.openPdfViewer(), which shows
+ * PdfViewerFragment inside the host Activity — no new Activity is started.
+ *
+ * Usage:
+ *   const { open, dismiss, getPageCount } = usePdfViewer({
+ *     onZoomChanged: (pct) => console.log('zoom', pct),
+ *     onDismiss: () => console.log('closed'),
+ *   });
+ *
+ *   // Open the viewer
+ *   open('file:///path/to/book.pdf', 0, 1.5);
+ *
+ *   // Dismiss it programmatically
+ *   dismiss();
+ */
+
+import { useCallback, useEffect, useRef } from 'react';
+import { NativeEventEmitter, NativeModules } from 'react-native';
+import NativePdfViewerModule from './specs/NativePdfViewerModule';
+
+export interface UsePdfViewerOptions {
+  onFullScreenChanged?: (isFullScreen: boolean) => void;
+  onZoomChanged?: (zoomPercentage: number) => void;
+  onDismiss?: () => void;
+  onError?: (error: string) => void;
+}
+
+export interface UsePdfViewerReturn {
+  /** Open the PDF viewer inside the host Activity */
+  open: (uri: string, pageIndex?: number, defaultZoom?: number) => void;
+  /** Dismiss the viewer programmatically */
+  dismiss: () => void;
+  /** Get the total number of pages (async, no rendering) */
+  getPageCount: (uri: string) => Promise<number>;
+  /** Generate a multi-page PDF as Base64 */
+  createPdf: (
+    pages: Array<{ title: string; body: string }>,
+    widthPx: number,
+    heightPx: number
+  ) => Promise<{ base64: string; path: string }>;
+}
+
+export function usePdfViewer(options: UsePdfViewerOptions = {}): UsePdfViewerReturn {
+  // Keep options in a ref so event handlers always see the latest callbacks
+  // without needing to re-subscribe to native events on every render.
+  const optionsRef = useRef(options);
+  optionsRef.current = options;
+
+  useEffect(() => {
+    const emitter = new NativeEventEmitter(NativeModules.NativePdfViewerModule);
+
+    const subs = [
+      emitter.addListener('PdfFullScreenChanged', ({ isFullScreen }: { isFullScreen: boolean }) =>
+        optionsRef.current.onFullScreenChanged?.(isFullScreen)
+      ),
+      emitter.addListener('PdfZoomChanged', ({ zoomPercentage }: { zoomPercentage: number }) =>
+        optionsRef.current.onZoomChanged?.(zoomPercentage)
+      ),
+      emitter.addListener('PdfViewerDismissed', () =>
+        optionsRef.current.onDismiss?.()
+      ),
+      emitter.addListener('PdfViewerError', ({ error }: { error: string }) =>
+        optionsRef.current.onError?.(error)
+      ),
+    ];
+
+    return () => subs.forEach((s) => s.remove());
+  }, []); // Empty deps: subscribe once, use ref for callbacks
+
+  const open = useCallback(
+    (uri: string, pageIndex = -1, defaultZoom = 1.5) => {
+      NativePdfViewerModule.openPdfViewer(uri, pageIndex, defaultZoom);
+    },
+    []
+  );
+
+  const dismiss = useCallback(() => {
+    NativePdfViewerModule.dismissPdfViewer();
+  }, []);
+
+  const getPageCount = useCallback(
+    (uri: string): Promise<number> => NativePdfViewerModule.getPdfPageCount(uri),
+    []
+  );
+
+  const createPdf = useCallback(
+    (
+      pages: Array<{ title: string; body: string }>,
+      widthPx: number,
+      heightPx: number
+    ) => NativePdfViewerModule.createMultiPagePdfBase64(pages, widthPx, heightPx),
+    []
+  );
+
+  return { open, dismiss, getPageCount, createPdf };
+}