react-native-pdfrender 0.1.0

package/lib/typescript/PdfViewerView.d.ts

@@ -0,0 +1,58 @@
+/**
+ * PdfViewerView — public React component for the embedded PDF viewer.
+ *
+ * Usage:
+ *   import { PdfViewerView } from './PdfViewerView';
+ *
+ *   <PdfViewerView
+ *     uri="file:///path/to/book.pdf"
+ *     initialPage={0}
+ *     defaultZoom={1.5}
+ *     style={{ flex: 1 }}
+ *     onZoomChange={(pct) => console.log('zoom', pct)}
+ *     onFullScreenChange={(fs) => setFullScreen(fs)}
+ *   />
+ */
+import React from 'react';
+import { type ViewStyle } from 'react-native';
+export interface PdfViewerHandle {
+}
+export interface IconSet {
+    zoomIn?: number | string;
+    zoomOut?: number | string;
+    fullScreen?: number | string;
+    minimizeScreen?: number | string;
+    leftLayout?: number | string;
+    rightLayout?: number | string;
+}
+export interface PdfViewerProps {
+    /** PDF file URI — file:// or content:// */
+    uri: string;
+    /** 0-based page index to open (-1 = first page) */
+    initialPage?: number;
+    /** Initial (and minimum) zoom level. 1.0 = 100%, 1.5 = 150% */
+    defaultZoom?: number;
+    /** Whether the viewer fills the screen */
+    isFullScreen?: boolean;
+    /** PDF position in split-view: true = right side */
+    rightLayout?: boolean;
+    /** Max pixel width of the viewer container (used in split-view) */
+    maxWidth?: number;
+    /** Width percentage of the screen occupied by the viewer (0–100) */
+    screenWidthPercentage?: number;
+    /** Custom toolbar icon assets */
+    icons?: IconSet;
+    /** Icon size in logical pixels (default: 40) */
+    iconSize?: number;
+    /** Toolbar back-button text */
+    backButtonText?: string;
+    /** Toolbar header text */
+    headerText?: string;
+    style?: ViewStyle;
+    onFullScreenChange?: (isFullScreen: boolean) => void;
+    onLeftScreenChange?: (isLeftScreen: boolean) => void;
+    onRightScreenChange?: (isRightScreen: boolean) => void;
+    onZoomChange?: (zoomPercentage: number) => void;
+}
+export declare const PdfViewerView: React.ForwardRefExoticComponent<PdfViewerProps & React.RefAttributes<PdfViewerHandle>>;
+//# sourceMappingURL=PdfViewerView.d.ts.map

package/lib/typescript/PdfViewerView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PdfViewerView.d.ts","sourceRoot":"","sources":["../../src/PdfViewerView.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAmD,MAAM,OAAO,CAAC;AACxE,OAAO,EAAqB,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAKjE,MAAM,WAAW,eAAe;CAG/B;AAID,MAAM,WAAW,OAAO;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,2CAA2C;IAC3C,GAAG,EAAE,MAAM,CAAC;IAEZ,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,oDAAoD;IACpD,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,oEAAoE;IACpE,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B,iCAAiC;IACjC,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,+BAA+B;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,0BAA0B;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,KAAK,CAAC,EAAE,SAAS,CAAC;IAElB,kBAAkB,CAAC,EAAE,CAAC,YAAY,EAAE,OAAO,KAAK,IAAI,CAAC;IACrD,kBAAkB,CAAC,EAAE,CAAC,YAAY,EAAE,OAAO,KAAK,IAAI,CAAC;IACrD,mBAAmB,CAAC,EAAE,CAAC,aAAa,EAAE,OAAO,KAAK,IAAI,CAAC;IACvD,YAAY,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;CACjD;AAID,eAAO,MAAM,aAAa,wFAwEzB,CAAC"}

package/lib/typescript/index.d.ts

@@ -0,0 +1,7 @@
+export { PdfViewerView } from './PdfViewerView';
+export type { PdfViewerProps, PdfViewerHandle, IconSet } from './PdfViewerView';
+export { usePdfViewer } from './usePdfViewer';
+export type { UsePdfViewerOptions, UsePdfViewerReturn } from './usePdfViewer';
+export { default as NativePdfViewerModule } from './specs/NativePdfViewerModule';
+export type { PdfPage, PdfCreationResult } from './specs/NativePdfViewerModule';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAEhF,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAE9E,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACjF,YAAY,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC"}

package/lib/typescript/specs/NativePdfViewerComponent.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Codegen spec for the embedded PDF viewer Fabric component.
+ *
+ * Codegen reads this file and generates the native component registration
+ * that allows <PdfViewerView /> to map to PdfViewerFabricManager on Android.
+ *
+ * Use DirectEventHandler (not BubblingEventHandler) for custom events — they
+ * are dispatched directly to the component's onXxx prop without bubbling.
+ */
+import type { HostComponent, ViewProps } from 'react-native';
+import type { Float, Int32, WithDefault, DirectEventHandler } from 'react-native/Libraries/Types/CodegenTypes';
+interface FullScreenChangeEvent {
+    isFullScreen: boolean;
+}
+interface LeftScreenChangeEvent {
+    isLeftScreen: boolean;
+}
+interface RightScreenChangeEvent {
+    isRightScreen: boolean;
+}
+interface ZoomChangeEvent {
+    zoomPercentage: Float;
+}
+export interface NativePdfViewerProps extends ViewProps {
+    /** PDF file URI (file:// or content://) */
+    pdfUri?: string;
+    /** 0-based page to scroll to on open. -1 = first page. */
+    initialPageIndex?: WithDefault<Int32, -1>;
+    /** Max pixel width available to the viewer (used in split-view) */
+    maxWidth?: Float;
+    /** Percentage of screen width the viewer occupies (0–100) */
+    screenWidthPercentage?: WithDefault<Float, 100>;
+    /** Whether the viewer is in full-screen mode */
+    isFullScreen?: WithDefault<boolean, false>;
+    /** PDF position: true = right side, false = left side (split-view) */
+    rightLayout?: WithDefault<boolean, false>;
+    /** Initial and minimum zoom level (1.0 = 100%) */
+    defaultZoom?: WithDefault<Float, 1.5>;
+    /** Text for the back button in the toolbar */
+    backButtonText?: string;
+    /** Text for the header in the toolbar */
+    headerText?: string;
+    /** Icon URIs passed from JS (resolved asset URIs from Image.resolveAssetSource) */
+    iconZoomIn?: string;
+    iconZoomOut?: string;
+    iconFullScreen?: string;
+    iconMinimizeScreen?: string;
+    iconLeftLayout?: string;
+    iconRightLayout?: string;
+    /** Icon size in logical pixels */
+    iconSize?: WithDefault<Float, 40>;
+    onFullScreenChange?: DirectEventHandler<FullScreenChangeEvent>;
+    onLeftScreenChange?: DirectEventHandler<LeftScreenChangeEvent>;
+    onRightScreenChange?: DirectEventHandler<RightScreenChangeEvent>;
+    onZoomChange?: DirectEventHandler<ZoomChangeEvent>;
+}
+declare const _default: HostComponent<NativePdfViewerProps>;
+export default _default;
+//# sourceMappingURL=NativePdfViewerComponent.d.ts.map

package/lib/typescript/specs/NativePdfViewerComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativePdfViewerComponent.d.ts","sourceRoot":"","sources":["../../../src/specs/NativePdfViewerComponent.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,KAAK,EACV,KAAK,EACL,KAAK,EACL,WAAW,EACX,kBAAkB,EACnB,MAAM,2CAA2C,CAAC;AAUnD,UAAU,qBAAqB;IAC7B,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,UAAU,qBAAqB;IAC7B,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,UAAU,sBAAsB;IAC9B,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,UAAU,eAAe;IACvB,cAAc,EAAE,KAAK,CAAC;CACvB;AAID,MAAM,WAAW,oBAAqB,SAAQ,SAAS;IACrD,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,0DAA0D;IAC1D,gBAAgB,CAAC,EAAE,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAE1C,mEAAmE;IACnE,QAAQ,CAAC,EAAE,KAAK,CAAC;IAEjB,6DAA6D;IAC7D,qBAAqB,CAAC,EAAE,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAEhD,gDAAgD;IAChD,YAAY,CAAC,EAAE,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAE3C,sEAAsE;IACtE,WAAW,CAAC,EAAE,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAE1C,kDAAkD;IAClD,WAAW,CAAC,EAAE,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAEtC,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,WAAW,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAGlC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC,qBAAqB,CAAC,CAAC;IAC/D,kBAAkB,CAAC,EAAE,kBAAkB,CAAC,qBAAqB,CAAC,CAAC;IAC/D,mBAAmB,CAAC,EAAE,kBAAkB,CAAC,sBAAsB,CAAC,CAAC;IACjE,YAAY,CAAC,EAAE,kBAAkB,CAAC,eAAe,CAAC,CAAC;CACpD;wBAKI,aAAa,CAAC,oBAAoB,CAAC;AAFxC,wBAEyC"}

package/lib/typescript/specs/NativePdfViewerModule.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 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';
+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>;
+}
+declare const _default: Spec;
+export default _default;
+//# sourceMappingURL=NativePdfViewerModule.d.ts.map

package/lib/typescript/specs/NativePdfViewerModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativePdfViewerModule.d.ts","sourceRoot":"","sources":["../../../src/specs/NativePdfViewerModule.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC;;;;;;;OAOG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzE;;OAEG;IACH,gBAAgB,IAAI,IAAI,CAAC;IAEzB;;OAEG;IACH,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE9C;;OAEG;IACH,wBAAwB,CACtB,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,EAC7B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC/B;;AAED,wBAA+E"}

package/lib/typescript/usePdfViewer.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 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();
+ */
+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 declare function usePdfViewer(options?: UsePdfViewerOptions): UsePdfViewerReturn;
+//# sourceMappingURL=usePdfViewer.d.ts.map

package/lib/typescript/usePdfViewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePdfViewer.d.ts","sourceRoot":"","sources":["../../src/usePdfViewer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAMH,MAAM,WAAW,mBAAmB;IAClC,mBAAmB,CAAC,EAAE,CAAC,YAAY,EAAE,OAAO,KAAK,IAAI,CAAC;IACtD,aAAa,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACtE,0CAA0C;IAC1C,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,0DAA0D;IAC1D,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,0CAA0C;IAC1C,SAAS,EAAE,CACT,KAAK,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,EAC7C,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,KACb,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAED,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,kBAAkB,CAqDlF"}

package/package.json

@@ -0,0 +1,109 @@
+{
+  "name": "react-native-pdfrender",
+  "version": "0.1.0",
+  "description": "React Native PDF rendering library with TurboModules and Fabric components",
+  "main": "lib/commonjs/index.js",
+  "module": "lib/module/index.js",
+  "react-native": "src/index.tsx",
+  "types": "lib/typescript/index.d.ts",
+  "source": "src/index.tsx",
+  "files": [
+    "src",
+    "lib",
+    "android/src",
+    "android/build.gradle",
+    "ios",
+    "react-native-pdfrender.podspec",
+    "react-native.config.js",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!android/build",
+    "!android/.gradle",
+    "!ios/build",
+    "!lib/typescript/example"
+  ],
+  "keywords": [
+    "react-native",
+    "ios",
+    "android",
+    "pdf",
+    "pdf-viewer",
+    "pdf-renderer",
+    "turbomodule",
+    "fabric",
+    "new-architecture"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cosmiq-co/react-native-pdfrender.git"
+  },
+  "homepage": "https://github.com/cosmiq-co/react-native-pdfrender#readme",
+  "bugs": {
+    "url": "https://github.com/cosmiq-co/react-native-pdfrender/issues"
+  },
+  "author": "Shubham Keshari <shubham.keshari@cosmiq.co.in>",
+  "license": "MIT",
+  "scripts": {
+    "build": "bob build",
+    "prepare": "bob build",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/",
+    "test": "jest",
+    "example:android": "yarn --cwd example android",
+    "example:ios": "yarn --cwd example ios",
+    "example:start": "yarn --cwd example start"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-native": ">=0.70.0"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.25.2",
+    "@babel/preset-env": "^7.25.3",
+    "@babel/runtime": "^7.25.0",
+    "@react-native-community/cli": "20.1.0",
+    "@react-native-community/cli-platform-android": "20.1.0",
+    "@react-native-community/cli-platform-ios": "20.1.0",
+    "@react-native/babel-preset": "0.84.1",
+    "@react-native/eslint-config": "0.84.1",
+    "@react-native/metro-config": "0.84.1",
+    "@react-native/typescript-config": "0.84.1",
+    "@types/jest": "^29.5.13",
+    "@types/react": "^19.2.0",
+    "@types/react-test-renderer": "^19.1.0",
+    "eslint": "^8.19.0",
+    "jest": "^29.6.3",
+    "prettier": "2.8.8",
+    "react": "19.2.3",
+    "react-native": "0.84.1",
+    "react-native-builder-bob": "^0.35.3",
+    "react-test-renderer": "19.2.3",
+    "typescript": "^5.8.3"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "codegenConfig": {
+    "name": "PdfViewerSpecs",
+    "type": "all",
+    "jsSrcsDir": "src/specs",
+    "android": {
+      "javaPackageName": "com.pdfrender"
+    }
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      "commonjs",
+      "module",
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  }
+}

package/react-native-pdfrender.podspec

@@ -0,0 +1,35 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "react-native-pdfrender"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"] || "https://github.com/cosmiq-co/react-native-pdfrender"
+  s.license      = package["license"]
+  s.authors      = package["author"]
+  s.platforms    = { :ios => "13.0" }
+
+  s.source       = { :git => "https://github.com/cosmiq-co/react-native-pdfrender.git",
+                     :tag => "v#{s.version}" }
+
+  # All Swift and ObjC++ library sources live in ios/
+  s.source_files = "ios/**/*.{h,m,mm,swift}"
+
+  # Swift/ObjC++ interop: the module map enables Swift-to-ObjC++ bridging inside the pod
+  s.pod_target_xcconfig = {
+    "SWIFT_OBJC_BRIDGING_HEADER"     => "",
+    "DEFINES_MODULE"                  => "YES",
+    "SWIFT_COMPILATION_MODE"          => "wholemodule",
+    "OTHER_SWIFT_FLAGS"               => "$(inherited) -D RCT_NEW_ARCH_ENABLED",
+  }
+
+  # Minimum iOS for PDFRenderer-compatible APIs
+  s.ios.deployment_target = "13.0"
+
+  # ── React Native dependency resolution ────────────────────────────────────────
+  # install_modules_dependencies handles both Old Arch and New Arch automatically.
+  # It adds React-Core, React-RCTFabric, ReactCodegen, etc. as needed.
+  install_modules_dependencies(s)
+end

package/react-native.config.js

@@ -0,0 +1,11 @@
+module.exports = {
+  dependency: {
+    platforms: {
+      ios: {},
+      android: {
+        packageImportPath: 'import com.pdfrender.PdfViewPackage;',
+        packageInstance: 'new PdfViewPackage()',
+      },
+    },
+  },
+};

package/src/PdfViewerView.tsx

@@ -0,0 +1,159 @@
+/**
+ * PdfViewerView — public React component for the embedded PDF viewer.
+ *
+ * Usage:
+ *   import { PdfViewerView } from './PdfViewerView';
+ *
+ *   <PdfViewerView
+ *     uri="file:///path/to/book.pdf"
+ *     initialPage={0}
+ *     defaultZoom={1.5}
+ *     style={{ flex: 1 }}
+ *     onZoomChange={(pct) => console.log('zoom', pct)}
+ *     onFullScreenChange={(fs) => setFullScreen(fs)}
+ *   />
+ */
+
+import React, { forwardRef, useImperativeHandle, useMemo } from 'react';
+import { Image, StyleSheet, type ViewStyle } from 'react-native';
+import NativePdfViewerComponent from './specs/NativePdfViewerComponent';
+
+// ── Public handle (imperative API via ref) ────────────────────────────────────
+
+export interface PdfViewerHandle {
+  // Future: goToPage(index: number), resetZoom(), etc.
+  // Kept as an empty interface now so host apps can forward refs safely.
+}
+
+// ── Public props ──────────────────────────────────────────────────────────────
+
+export interface IconSet {
+  zoomIn?: number | string;        // require('./assets/zoom_in.png') or URI string
+  zoomOut?: number | string;
+  fullScreen?: number | string;
+  minimizeScreen?: number | string;
+  leftLayout?: number | string;
+  rightLayout?: number | string;
+}
+
+export interface PdfViewerProps {
+  /** PDF file URI — file:// or content:// */
+  uri: string;
+
+  /** 0-based page index to open (-1 = first page) */
+  initialPage?: number;
+
+  /** Initial (and minimum) zoom level. 1.0 = 100%, 1.5 = 150% */
+  defaultZoom?: number;
+
+  /** Whether the viewer fills the screen */
+  isFullScreen?: boolean;
+
+  /** PDF position in split-view: true = right side */
+  rightLayout?: boolean;
+
+  /** Max pixel width of the viewer container (used in split-view) */
+  maxWidth?: number;
+
+  /** Width percentage of the screen occupied by the viewer (0–100) */
+  screenWidthPercentage?: number;
+
+  /** Custom toolbar icon assets */
+  icons?: IconSet;
+
+  /** Icon size in logical pixels (default: 40) */
+  iconSize?: number;
+
+  /** Toolbar back-button text */
+  backButtonText?: string;
+
+  /** Toolbar header text */
+  headerText?: string;
+
+  style?: ViewStyle;
+
+  onFullScreenChange?: (isFullScreen: boolean) => void;
+  onLeftScreenChange?: (isLeftScreen: boolean) => void;
+  onRightScreenChange?: (isRightScreen: boolean) => void;
+  onZoomChange?: (zoomPercentage: number) => void;
+}
+
+// ── Component ─────────────────────────────────────────────────────────────────
+
+export const PdfViewerView = forwardRef<PdfViewerHandle, PdfViewerProps>(
+  (
+    {
+      uri,
+      initialPage = -1,
+      defaultZoom = 1,
+      isFullScreen = false,
+      rightLayout = false,
+      maxWidth,
+      screenWidthPercentage = 100,
+      icons,
+      iconSize = 40,
+      backButtonText,
+      headerText,
+      style,
+      onFullScreenChange,
+      onLeftScreenChange,
+      onRightScreenChange,
+      onZoomChange,
+    },
+    ref
+  ) => {
+    useImperativeHandle(ref, () => ({}));
+
+    // Resolve icon assets to URI strings the native layer can load.
+    // Image.resolveAssetSource handles both require() numbers and plain strings.
+    const resolvedIcons = useMemo(() => {
+      const resolve = (src?: number | string): string | undefined => {
+        if (src == null) return undefined;
+        if (typeof src === 'string') return src;
+        try {
+          return Image.resolveAssetSource(src).uri;
+        } catch {
+          return undefined;
+        }
+      };
+      return {
+        zoomIn:         resolve(icons?.zoomIn),
+        zoomOut:        resolve(icons?.zoomOut),
+        fullScreen:     resolve(icons?.fullScreen),
+        minimizeScreen: resolve(icons?.minimizeScreen),
+        leftLayout:     resolve(icons?.leftLayout),
+        rightLayout:    resolve(icons?.rightLayout),
+      };
+    }, [icons]);
+
+    return (
+      <NativePdfViewerComponent
+        style={[styles.fill, style]}
+        pdfUri={uri}
+        initialPageIndex={initialPage}
+        defaultZoom={defaultZoom}
+        isFullScreen={isFullScreen}
+        rightLayout={rightLayout}
+        maxWidth={maxWidth}
+        screenWidthPercentage={screenWidthPercentage}
+        iconZoomIn={resolvedIcons.zoomIn}
+        iconZoomOut={resolvedIcons.zoomOut}
+        iconFullScreen={resolvedIcons.fullScreen}
+        iconMinimizeScreen={resolvedIcons.minimizeScreen}
+        iconLeftLayout={resolvedIcons.leftLayout}
+        iconRightLayout={resolvedIcons.rightLayout}
+        iconSize={iconSize}
+        backButtonText={backButtonText}
+        headerText={headerText}
+        onFullScreenChange={(e) => onFullScreenChange?.(e.nativeEvent.isFullScreen)}
+        onLeftScreenChange={(e) => onLeftScreenChange?.(e.nativeEvent.isLeftScreen)}
+        onRightScreenChange={(e) => onRightScreenChange?.(e.nativeEvent.isRightScreen)}
+        onZoomChange={(e) => onZoomChange?.(e.nativeEvent.zoomPercentage)}
+      />
+    );
+  }
+);
+
+const styles = StyleSheet.create({
+  fill: { flex: 1 },
+});

package/src/index.tsx

@@ -0,0 +1,10 @@
+// ── Public API ────────────────────────────────────────────────────────────────
+
+export { PdfViewerView } from './PdfViewerView';
+export type { PdfViewerProps, PdfViewerHandle, IconSet } from './PdfViewerView';
+
+export { usePdfViewer } from './usePdfViewer';
+export type { UsePdfViewerOptions, UsePdfViewerReturn } from './usePdfViewer';
+
+export { default as NativePdfViewerModule } from './specs/NativePdfViewerModule';
+export type { PdfPage, PdfCreationResult } from './specs/NativePdfViewerModule';

package/src/specs/NativePdfViewerComponent.ts

@@ -0,0 +1,94 @@
+/**
+ * Codegen spec for the embedded PDF viewer Fabric component.
+ *
+ * Codegen reads this file and generates the native component registration
+ * that allows <PdfViewerView /> to map to PdfViewerFabricManager on Android.
+ *
+ * Use DirectEventHandler (not BubblingEventHandler) for custom events — they
+ * are dispatched directly to the component's onXxx prop without bubbling.
+ */
+
+import type { HostComponent, ViewProps } from 'react-native';
+import type {
+  Float,
+  Int32,
+  WithDefault,
+  DirectEventHandler,
+} from 'react-native/Libraries/Types/CodegenTypes';
+// The deep import below is intentional. Metro codegen identifies Fabric component
+// specs by statically analysing this exact import path — switching to a public
+// re-export or require() breaks spec detection. The runtime deprecation warning
+// this produces is a known false positive for *spec* files and can be ignored.
+// eslint-disable-next-line import/no-deprecated
+import codegenNativeComponent from 'react-native/Libraries/Utilities/codegenNativeComponent';
+
+// ── Event payload types ───────────────────────────────────────────────────────
+
+interface FullScreenChangeEvent {
+  isFullScreen: boolean;
+}
+
+interface LeftScreenChangeEvent {
+  isLeftScreen: boolean;
+}
+
+interface RightScreenChangeEvent {
+  isRightScreen: boolean;
+}
+
+interface ZoomChangeEvent {
+  zoomPercentage: Float;
+}
+
+// ── Component props ───────────────────────────────────────────────────────────
+
+export interface NativePdfViewerProps extends ViewProps {
+  /** PDF file URI (file:// or content://) */
+  pdfUri?: string;
+
+  /** 0-based page to scroll to on open. -1 = first page. */
+  initialPageIndex?: WithDefault<Int32, -1>;
+
+  /** Max pixel width available to the viewer (used in split-view) */
+  maxWidth?: Float;
+
+  /** Percentage of screen width the viewer occupies (0–100) */
+  screenWidthPercentage?: WithDefault<Float, 100>;
+
+  /** Whether the viewer is in full-screen mode */
+  isFullScreen?: WithDefault<boolean, false>;
+
+  /** PDF position: true = right side, false = left side (split-view) */
+  rightLayout?: WithDefault<boolean, false>;
+
+  /** Initial and minimum zoom level (1.0 = 100%) */
+  defaultZoom?: WithDefault<Float, 1.5>;
+
+  /** Text for the back button in the toolbar */
+  backButtonText?: string;
+
+  /** Text for the header in the toolbar */
+  headerText?: string;
+
+  /** Icon URIs passed from JS (resolved asset URIs from Image.resolveAssetSource) */
+  iconZoomIn?: string;
+  iconZoomOut?: string;
+  iconFullScreen?: string;
+  iconMinimizeScreen?: string;
+  iconLeftLayout?: string;
+  iconRightLayout?: string;
+
+  /** Icon size in logical pixels */
+  iconSize?: WithDefault<Float, 40>;
+
+  // ── Events ────────────────────────────────────────────────────────────────
+  onFullScreenChange?: DirectEventHandler<FullScreenChangeEvent>;
+  onLeftScreenChange?: DirectEventHandler<LeftScreenChangeEvent>;
+  onRightScreenChange?: DirectEventHandler<RightScreenChangeEvent>;
+  onZoomChange?: DirectEventHandler<ZoomChangeEvent>;
+}
+
+// The string 'PdfViewerView' must match PdfViewerFabricManager.VIEW_NAME in Kotlin.
+export default codegenNativeComponent<NativePdfViewerProps>(
+  'PdfViewerView'
+) as HostComponent<NativePdfViewerProps>;