@webority-technologies/mobile-ui 0.0.7 → 0.0.9

package/lib/commonjs/components/DocumentViewer/DocumentViewer.js

@@ -5,21 +5,57 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = exports.DocumentViewer = void 0;
 var _mobileCore = require("@webority-technologies/mobile-core");
+var _download = require("@webority-technologies/mobile-core/download");
 var _react = require("react");
 var _reactNative = require("react-native");
-var _reactNativePdf = _interopRequireDefault(require("react-native-pdf"));
+var _NativePdfRasterizer = _interopRequireDefault(require("../../specs/NativePdfRasterizer.js"));
 var _index = require("../Spinner/index.js");
 var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const HAS_SCHEME = /^[a-z][a-z0-9+.-]*:/i;
+const MAX_RENDER_SCALE = 3;
+/** How many pages beyond the current one stay mounted, each direction. */
+const RENDER_WINDOW = 1;
 const toError = value => value instanceof Error ? value : new Error(String(value));
 
+/** The renderPage scale is capped so a very wide view never asks the native
+ * rasterizer for an unbounded bitmap (see react-native.md's ARGB_8888 4-bytes/px
+ * guidance) — both native sides additionally clamp their own pixel ceiling. */
+const scaleForWidth = (viewWidthPx, pageWidthPt) => {
+  if (pageWidthPt <= 0) {
+    return 1;
+  }
+  const raw = viewWidthPx / pageWidthPt * _reactNative.PixelRatio.get();
+  return Math.min(Math.max(raw, 1), MAX_RENDER_SCALE);
+};
+const localPathFromSource = async source => {
+  if (!HAS_SCHEME.test(source.uri) || source.uri.startsWith('file://')) {
+    return source.uri.replace(/^file:\/\//, '');
+  }
+  const result = await (0, _download.downloadFile)({
+    url: source.uri,
+    headers: source.headers,
+    authenticated: false,
+    overwrite: source.cache === false
+  });
+  return result.path;
+};
+
 /**
- * Renders a PDF only — the WebView fallback consumer apps use for non-PDF
- * office documents is a distinct rendering strategy and stays app-side.
+ * Renders a PDF via our own native rasterizer (PDFKit on iOS, PdfRenderer on
+ * Android) — no third-party PDF dependency. Pages are paged through a plain
+ * `ScrollView` with manual windowed mounting (render the visible page ±
+ * `RENDER_WINDOW`), not a `FlatList` — a `VirtualizedList`-based component
+ * would trip React Native's "VirtualizedLists should never be nested inside
+ * plain ScrollViews" the moment a consumer embeds DocumentViewer in their own
+ * scrolling screen, which is a completely ordinary way to use it. Avoiding the
+ * VirtualizedList primitive entirely removes that whole class of warning
+ * rather than working around one instance of it. The WebView fallback
+ * consumer apps use for non-PDF office documents is a distinct rendering
+ * strategy and stays app-side.
  */
 const DocumentViewer = ({
   source,
-  trustAllCerts = false,
   onLoadComplete,
   onPageChanged,
   onError,
@@ -28,29 +64,162 @@ const DocumentViewer = ({
   testID,
   accessibilityLabel
 }) => {
-  const renderActivityIndicator = (0, _react.useCallback)(() => loadingIndicator ? loadingIndicator() : /*#__PURE__*/(0, _jsxRuntime.jsx)(_index.Spinner, {
-    size: "lg"
-  }), [loadingIndicator]);
-  const handleError = (0, _react.useCallback)(error => {
-    const err = toError(error);
-    _mobileCore.Logger.error('[@webority-technologies/mobile-ui] DocumentViewer failed to load.', err);
-    onError?.(err);
-  }, [onError]);
-  const handleLoadComplete = (0, _react.useCallback)(numberOfPages => onLoadComplete?.(numberOfPages), [onLoadComplete]);
+  const {
+    width: windowWidth
+  } = (0, _reactNative.useWindowDimensions)();
+  const [pageCount, setPageCount] = (0, _react.useState)(0);
+  const [pageSizePt, setPageSizePt] = (0, _react.useState)({
+    width: 612,
+    height: 792
+  }); // US Letter fallback
+  const pageAspect = pageSizePt.height / pageSizePt.width;
+  const [renderedPages, setRenderedPages] = (0, _react.useState)({});
+  const [currentPage, setCurrentPage] = (0, _react.useState)(0);
+  const handleRef = (0, _react.useRef)(null);
+  const onErrorRef = (0, _react.useRef)(onError);
+  onErrorRef.current = onError;
+  const onLoadCompleteRef = (0, _react.useRef)(onLoadComplete);
+  onLoadCompleteRef.current = onLoadComplete;
+  const onPageChangedRef = (0, _react.useRef)(onPageChanged);
+  onPageChangedRef.current = onPageChanged;
+  const documentSource = (0, _react.useMemo)(() => ({
+    uri: source.uri,
+    headers: source.headers,
+    cache: source.cache
+  }), [source.uri, source.headers, source.cache]);
+  (0, _react.useEffect)(() => {
+    let cancelled = false;
+    const load = async () => {
+      if (!_NativePdfRasterizer.default) {
+        onErrorRef.current?.(new Error('[@webority-technologies/mobile-ui] PdfRasterizer native module is not linked. ' + 'Run pod install / rebuild the app after adding @webority-technologies/mobile-ui.'));
+        return;
+      }
+      try {
+        const path = await localPathFromSource(documentSource);
+        if (cancelled) {
+          return;
+        }
+        const opened = await _NativePdfRasterizer.default.open(path);
+        if (cancelled) {
+          await _NativePdfRasterizer.default.close(opened.handle).catch(() => undefined);
+          return;
+        }
+        handleRef.current = opened.handle;
+        setPageCount(opened.pageCount);
+        setCurrentPage(0);
+        setRenderedPages({});
+        if (opened.pageWidth > 0 && opened.pageHeight > 0) {
+          setPageSizePt({
+            width: opened.pageWidth,
+            height: opened.pageHeight
+          });
+        }
+        onLoadCompleteRef.current?.(opened.pageCount);
+      } catch (error) {
+        if (!cancelled) {
+          const err = toError(error);
+          _mobileCore.Logger.error('[@webority-technologies/mobile-ui] DocumentViewer failed to load.', err);
+          onErrorRef.current?.(err);
+        }
+      }
+    };
+    void load();
+    return () => {
+      cancelled = true;
+    };
+  }, [documentSource]);
+  (0, _react.useEffect)(() => () => {
+    const openHandle = handleRef.current;
+    if (openHandle) {
+      _NativePdfRasterizer.default?.close(openHandle).catch(() => undefined);
+    }
+  }, []);
+  const renderPageImage = (0, _react.useCallback)(async pageIndex => {
+    const openHandle = handleRef.current;
+    if (!openHandle || !_NativePdfRasterizer.default) {
+      return;
+    }
+    try {
+      const scale = scaleForWidth(windowWidth, pageSizePt.width);
+      const uri = await _NativePdfRasterizer.default.renderPage(openHandle, pageIndex, scale);
+      setRenderedPages(prev => prev[pageIndex] ? prev : {
+        ...prev,
+        [pageIndex]: uri
+      });
+    } catch (error) {
+      _mobileCore.Logger.error(`[@webority-technologies/mobile-ui] DocumentViewer failed to render page ${pageIndex}.`, toError(error));
+    }
+  }, [pageSizePt.width, windowWidth]);
+  const pageHeight = windowWidth * pageAspect;
+
+  // Mount and rasterize the current page plus a small window around it;
+  // everything else stays an empty placeholder slot until scrolled near.
+  (0, _react.useEffect)(() => {
+    if (pageCount === 0) {
+      return;
+    }
+    const start = Math.max(0, currentPage - RENDER_WINDOW);
+    const end = Math.min(pageCount - 1, currentPage + RENDER_WINDOW);
+    for (let index = start; index <= end; index += 1) {
+      void renderPageImage(index);
+    }
+  }, [currentPage, pageCount, renderPageImage]);
+  const handleScroll = (0, _react.useCallback)(event => {
+    if (pageHeight <= 0) {
+      return;
+    }
+    const page = Math.min(pageCount - 1, Math.max(0, Math.round(event.nativeEvent.contentOffset.y / pageHeight)));
+    setCurrentPage(prev => {
+      if (prev !== page) {
+        onPageChangedRef.current?.(page + 1, pageCount);
+      }
+      return page;
+    });
+  }, [pageCount, pageHeight]);
+  const pages = (0, _react.useMemo)(() => Array.from({
+    length: pageCount
+  }, (_unused, i) => i), [pageCount]);
+  const renderWindowStart = Math.max(0, currentPage - RENDER_WINDOW);
+  const renderWindowEnd = Math.min(pageCount - 1, currentPage + RENDER_WINDOW);
   return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
     style: [styles.root, style],
     testID: testID,
     accessible: accessibilityLabel !== undefined,
     accessibilityLabel: accessibilityLabel,
     accessibilityRole: "none",
-    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNativePdf.default, {
-      source: source,
-      trustAllCerts: trustAllCerts,
-      style: styles.pdf,
-      renderActivityIndicator: renderActivityIndicator,
-      onLoadComplete: handleLoadComplete,
-      onPageChanged: onPageChanged,
-      onError: handleError
+    children: pageCount === 0 ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+      style: styles.pagePlaceholder,
+      children: loadingIndicator ? loadingIndicator() : /*#__PURE__*/(0, _jsxRuntime.jsx)(_index.Spinner, {
+        size: "lg"
+      })
+    }) : /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.ScrollView, {
+      onScroll: handleScroll,
+      scrollEventThrottle: 32,
+      showsVerticalScrollIndicator: true,
+      removeClippedSubviews: true,
+      children: pages.map(index => {
+        const withinWindow = index >= renderWindowStart && index <= renderWindowEnd;
+        const uri = withinWindow ? renderedPages[index] : undefined;
+        return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+          style: [styles.page, {
+            width: windowWidth,
+            height: pageHeight
+          }],
+          children: uri ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Image, {
+            source: {
+              uri
+            },
+            style: styles.pageImage,
+            resizeMode: "contain",
+            accessible: false
+          }) : /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+            style: styles.pagePlaceholder,
+            children: withinWindow ? loadingIndicator?.() ?? /*#__PURE__*/(0, _jsxRuntime.jsx)(_index.Spinner, {
+              size: "lg"
+            }) : null
+          })
+        }, index);
+      })
     })
   });
 };
@@ -60,10 +229,16 @@ const styles = _reactNative.StyleSheet.create({
   root: {
     flex: 1
   },
-  pdf: {
+  page: {
+    alignSelf: 'center'
+  },
+  pageImage: {
+    flex: 1
+  },
+  pagePlaceholder: {
     flex: 1,
-    width: '100%',
-    height: '100%'
+    alignItems: 'center',
+    justifyContent: 'center'
   }
 });
 var _default = exports.default = DocumentViewer;

package/lib/commonjs/specs/NativePdfRasterizer.js

@@ -0,0 +1,9 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _reactNative = require("react-native");
+var _default = exports.default = _reactNative.TurboModuleRegistry.get('PdfRasterizer');
+//# sourceMappingURL=NativePdfRasterizer.js.map

package/lib/module/components/DocumentViewer/DocumentViewer.js

@@ -1,20 +1,56 @@
 "use strict";
 
 import { Logger } from '@webority-technologies/mobile-core';
-import { useCallback } from 'react';
-import { StyleSheet, View } from 'react-native';
-import Pdf from 'react-native-pdf';
+import { downloadFile } from '@webority-technologies/mobile-core/download';
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { Image, PixelRatio, ScrollView, StyleSheet, useWindowDimensions, View } from 'react-native';
+import PdfRasterizer from "../../specs/NativePdfRasterizer.js";
 import { Spinner } from "../Spinner/index.js";
 import { jsx as _jsx } from "react/jsx-runtime";
+const HAS_SCHEME = /^[a-z][a-z0-9+.-]*:/i;
+const MAX_RENDER_SCALE = 3;
+/** How many pages beyond the current one stay mounted, each direction. */
+const RENDER_WINDOW = 1;
 const toError = value => value instanceof Error ? value : new Error(String(value));
 
+/** The renderPage scale is capped so a very wide view never asks the native
+ * rasterizer for an unbounded bitmap (see react-native.md's ARGB_8888 4-bytes/px
+ * guidance) — both native sides additionally clamp their own pixel ceiling. */
+const scaleForWidth = (viewWidthPx, pageWidthPt) => {
+  if (pageWidthPt <= 0) {
+    return 1;
+  }
+  const raw = viewWidthPx / pageWidthPt * PixelRatio.get();
+  return Math.min(Math.max(raw, 1), MAX_RENDER_SCALE);
+};
+const localPathFromSource = async source => {
+  if (!HAS_SCHEME.test(source.uri) || source.uri.startsWith('file://')) {
+    return source.uri.replace(/^file:\/\//, '');
+  }
+  const result = await downloadFile({
+    url: source.uri,
+    headers: source.headers,
+    authenticated: false,
+    overwrite: source.cache === false
+  });
+  return result.path;
+};
+
 /**
- * Renders a PDF only — the WebView fallback consumer apps use for non-PDF
- * office documents is a distinct rendering strategy and stays app-side.
+ * Renders a PDF via our own native rasterizer (PDFKit on iOS, PdfRenderer on
+ * Android) — no third-party PDF dependency. Pages are paged through a plain
+ * `ScrollView` with manual windowed mounting (render the visible page ±
+ * `RENDER_WINDOW`), not a `FlatList` — a `VirtualizedList`-based component
+ * would trip React Native's "VirtualizedLists should never be nested inside
+ * plain ScrollViews" the moment a consumer embeds DocumentViewer in their own
+ * scrolling screen, which is a completely ordinary way to use it. Avoiding the
+ * VirtualizedList primitive entirely removes that whole class of warning
+ * rather than working around one instance of it. The WebView fallback
+ * consumer apps use for non-PDF office documents is a distinct rendering
+ * strategy and stays app-side.
  */
 export const DocumentViewer = ({
   source,
-  trustAllCerts = false,
   onLoadComplete,
   onPageChanged,
   onError,
@@ -23,29 +59,162 @@ export const DocumentViewer = ({
   testID,
   accessibilityLabel
 }) => {
-  const renderActivityIndicator = useCallback(() => loadingIndicator ? loadingIndicator() : /*#__PURE__*/_jsx(Spinner, {
-    size: "lg"
-  }), [loadingIndicator]);
-  const handleError = useCallback(error => {
-    const err = toError(error);
-    Logger.error('[@webority-technologies/mobile-ui] DocumentViewer failed to load.', err);
-    onError?.(err);
-  }, [onError]);
-  const handleLoadComplete = useCallback(numberOfPages => onLoadComplete?.(numberOfPages), [onLoadComplete]);
+  const {
+    width: windowWidth
+  } = useWindowDimensions();
+  const [pageCount, setPageCount] = useState(0);
+  const [pageSizePt, setPageSizePt] = useState({
+    width: 612,
+    height: 792
+  }); // US Letter fallback
+  const pageAspect = pageSizePt.height / pageSizePt.width;
+  const [renderedPages, setRenderedPages] = useState({});
+  const [currentPage, setCurrentPage] = useState(0);
+  const handleRef = useRef(null);
+  const onErrorRef = useRef(onError);
+  onErrorRef.current = onError;
+  const onLoadCompleteRef = useRef(onLoadComplete);
+  onLoadCompleteRef.current = onLoadComplete;
+  const onPageChangedRef = useRef(onPageChanged);
+  onPageChangedRef.current = onPageChanged;
+  const documentSource = useMemo(() => ({
+    uri: source.uri,
+    headers: source.headers,
+    cache: source.cache
+  }), [source.uri, source.headers, source.cache]);
+  useEffect(() => {
+    let cancelled = false;
+    const load = async () => {
+      if (!PdfRasterizer) {
+        onErrorRef.current?.(new Error('[@webority-technologies/mobile-ui] PdfRasterizer native module is not linked. ' + 'Run pod install / rebuild the app after adding @webority-technologies/mobile-ui.'));
+        return;
+      }
+      try {
+        const path = await localPathFromSource(documentSource);
+        if (cancelled) {
+          return;
+        }
+        const opened = await PdfRasterizer.open(path);
+        if (cancelled) {
+          await PdfRasterizer.close(opened.handle).catch(() => undefined);
+          return;
+        }
+        handleRef.current = opened.handle;
+        setPageCount(opened.pageCount);
+        setCurrentPage(0);
+        setRenderedPages({});
+        if (opened.pageWidth > 0 && opened.pageHeight > 0) {
+          setPageSizePt({
+            width: opened.pageWidth,
+            height: opened.pageHeight
+          });
+        }
+        onLoadCompleteRef.current?.(opened.pageCount);
+      } catch (error) {
+        if (!cancelled) {
+          const err = toError(error);
+          Logger.error('[@webority-technologies/mobile-ui] DocumentViewer failed to load.', err);
+          onErrorRef.current?.(err);
+        }
+      }
+    };
+    void load();
+    return () => {
+      cancelled = true;
+    };
+  }, [documentSource]);
+  useEffect(() => () => {
+    const openHandle = handleRef.current;
+    if (openHandle) {
+      PdfRasterizer?.close(openHandle).catch(() => undefined);
+    }
+  }, []);
+  const renderPageImage = useCallback(async pageIndex => {
+    const openHandle = handleRef.current;
+    if (!openHandle || !PdfRasterizer) {
+      return;
+    }
+    try {
+      const scale = scaleForWidth(windowWidth, pageSizePt.width);
+      const uri = await PdfRasterizer.renderPage(openHandle, pageIndex, scale);
+      setRenderedPages(prev => prev[pageIndex] ? prev : {
+        ...prev,
+        [pageIndex]: uri
+      });
+    } catch (error) {
+      Logger.error(`[@webority-technologies/mobile-ui] DocumentViewer failed to render page ${pageIndex}.`, toError(error));
+    }
+  }, [pageSizePt.width, windowWidth]);
+  const pageHeight = windowWidth * pageAspect;
+
+  // Mount and rasterize the current page plus a small window around it;
+  // everything else stays an empty placeholder slot until scrolled near.
+  useEffect(() => {
+    if (pageCount === 0) {
+      return;
+    }
+    const start = Math.max(0, currentPage - RENDER_WINDOW);
+    const end = Math.min(pageCount - 1, currentPage + RENDER_WINDOW);
+    for (let index = start; index <= end; index += 1) {
+      void renderPageImage(index);
+    }
+  }, [currentPage, pageCount, renderPageImage]);
+  const handleScroll = useCallback(event => {
+    if (pageHeight <= 0) {
+      return;
+    }
+    const page = Math.min(pageCount - 1, Math.max(0, Math.round(event.nativeEvent.contentOffset.y / pageHeight)));
+    setCurrentPage(prev => {
+      if (prev !== page) {
+        onPageChangedRef.current?.(page + 1, pageCount);
+      }
+      return page;
+    });
+  }, [pageCount, pageHeight]);
+  const pages = useMemo(() => Array.from({
+    length: pageCount
+  }, (_unused, i) => i), [pageCount]);
+  const renderWindowStart = Math.max(0, currentPage - RENDER_WINDOW);
+  const renderWindowEnd = Math.min(pageCount - 1, currentPage + RENDER_WINDOW);
   return /*#__PURE__*/_jsx(View, {
     style: [styles.root, style],
     testID: testID,
     accessible: accessibilityLabel !== undefined,
     accessibilityLabel: accessibilityLabel,
     accessibilityRole: "none",
-    children: /*#__PURE__*/_jsx(Pdf, {
-      source: source,
-      trustAllCerts: trustAllCerts,
-      style: styles.pdf,
-      renderActivityIndicator: renderActivityIndicator,
-      onLoadComplete: handleLoadComplete,
-      onPageChanged: onPageChanged,
-      onError: handleError
+    children: pageCount === 0 ? /*#__PURE__*/_jsx(View, {
+      style: styles.pagePlaceholder,
+      children: loadingIndicator ? loadingIndicator() : /*#__PURE__*/_jsx(Spinner, {
+        size: "lg"
+      })
+    }) : /*#__PURE__*/_jsx(ScrollView, {
+      onScroll: handleScroll,
+      scrollEventThrottle: 32,
+      showsVerticalScrollIndicator: true,
+      removeClippedSubviews: true,
+      children: pages.map(index => {
+        const withinWindow = index >= renderWindowStart && index <= renderWindowEnd;
+        const uri = withinWindow ? renderedPages[index] : undefined;
+        return /*#__PURE__*/_jsx(View, {
+          style: [styles.page, {
+            width: windowWidth,
+            height: pageHeight
+          }],
+          children: uri ? /*#__PURE__*/_jsx(Image, {
+            source: {
+              uri
+            },
+            style: styles.pageImage,
+            resizeMode: "contain",
+            accessible: false
+          }) : /*#__PURE__*/_jsx(View, {
+            style: styles.pagePlaceholder,
+            children: withinWindow ? loadingIndicator?.() ?? /*#__PURE__*/_jsx(Spinner, {
+              size: "lg"
+            }) : null
+          })
+        }, index);
+      })
     })
   });
 };
@@ -54,10 +223,16 @@ const styles = StyleSheet.create({
   root: {
     flex: 1
   },
-  pdf: {
+  page: {
+    alignSelf: 'center'
+  },
+  pageImage: {
+    flex: 1
+  },
+  pagePlaceholder: {
     flex: 1,
-    width: '100%',
-    height: '100%'
+    alignItems: 'center',
+    justifyContent: 'center'
   }
 });
 export default DocumentViewer;

package/lib/module/specs/NativePdfRasterizer.js

@@ -0,0 +1,5 @@
+"use strict";
+
+import { TurboModuleRegistry } from 'react-native';
+export default TurboModuleRegistry.get('PdfRasterizer');
+//# sourceMappingURL=NativePdfRasterizer.js.map

package/lib/typescript/commonjs/components/DocumentViewer/DocumentViewer.d.ts

@@ -3,12 +3,11 @@ import type { StyleProp, ViewStyle } from 'react-native';
 export interface DocumentViewerSource {
     uri: string;
     headers?: Record<string, string>;
+    /** Reuse a previously downloaded copy of this URL instead of re-fetching. Default true. */
     cache?: boolean;
 }
 export interface DocumentViewerProps {
     source: DocumentViewerSource;
-    /** Trust self-signed / invalid certs on the document request. Default false. */
-    trustAllCerts?: boolean;
     onLoadComplete?: (numberOfPages: number) => void;
     onPageChanged?: (page: number, numberOfPages: number) => void;
     onError?: (error: Error) => void;
@@ -19,8 +18,17 @@ export interface DocumentViewerProps {
     accessibilityLabel?: string;
 }
 /**
- * Renders a PDF only — the WebView fallback consumer apps use for non-PDF
- * office documents is a distinct rendering strategy and stays app-side.
+ * Renders a PDF via our own native rasterizer (PDFKit on iOS, PdfRenderer on
+ * Android) — no third-party PDF dependency. Pages are paged through a plain
+ * `ScrollView` with manual windowed mounting (render the visible page ±
+ * `RENDER_WINDOW`), not a `FlatList` — a `VirtualizedList`-based component
+ * would trip React Native's "VirtualizedLists should never be nested inside
+ * plain ScrollViews" the moment a consumer embeds DocumentViewer in their own
+ * scrolling screen, which is a completely ordinary way to use it. Avoiding the
+ * VirtualizedList primitive entirely removes that whole class of warning
+ * rather than working around one instance of it. The WebView fallback
+ * consumer apps use for non-PDF office documents is a distinct rendering
+ * strategy and stays app-side.
  */
 export declare const DocumentViewer: React.FC<DocumentViewerProps>;
 export default DocumentViewer;

package/lib/typescript/commonjs/specs/NativePdfRasterizer.d.ts

@@ -0,0 +1,40 @@
+import type { TurboModule } from 'react-native';
+export interface PdfDocumentInfo {
+    /** Opaque handle for every subsequent call (getPageInfo/renderPage/close) — NOT the file path. */
+    handle: string;
+    pageCount: number;
+    /** Points (1/72 in), the unrotated page size of page 0 — a per-page size read happens in renderPage. */
+    pageWidth: number;
+    pageHeight: number;
+}
+export interface PdfPageInfo {
+    width: number;
+    height: number;
+}
+export interface Spec extends TurboModule {
+    /**
+     * Opens a LOCAL pdf file (a file:// path or bare absolute path — no http(s), no
+     * headers, no auth: callers download remote documents with mobile-core's
+     * `downloadFile` first). Returns a handle used by every other call. Throws
+     * (rejects) on a missing file, a corrupt PDF, or a password-protected PDF.
+     */
+    open(path: string): Promise<PdfDocumentInfo>;
+    /**
+     * Reads one page's own size without rasterizing it (pages in a PDF can each
+     * have a different size/rotation).
+     */
+    getPageInfo(handle: string, pageIndex: number): Promise<PdfPageInfo>;
+    /**
+     * Rasterizes one page to a PNG file in the cache directory and returns its
+     * absolute path. `scale` is a multiplier on the page's own point size (pass
+     * the view width / page width ratio, capped by the caller — see
+     * react-native.md's "RGBA_8888 is 4 bytes/px" guidance). Renders are
+     * serialized per handle on both platforms; call sequentially per document.
+     */
+    renderPage(handle: string, pageIndex: number, scale: number): Promise<string>;
+    /** Releases the native document and evicts any cached page renders for it. */
+    close(handle: string): Promise<void>;
+}
+declare const _default: Spec | null;
+export default _default;
+//# sourceMappingURL=NativePdfRasterizer.d.ts.map

package/lib/typescript/module/components/DocumentViewer/DocumentViewer.d.ts

@@ -3,12 +3,11 @@ import type { StyleProp, ViewStyle } from 'react-native';
 export interface DocumentViewerSource {
     uri: string;
     headers?: Record<string, string>;
+    /** Reuse a previously downloaded copy of this URL instead of re-fetching. Default true. */
     cache?: boolean;
 }
 export interface DocumentViewerProps {
     source: DocumentViewerSource;
-    /** Trust self-signed / invalid certs on the document request. Default false. */
-    trustAllCerts?: boolean;
     onLoadComplete?: (numberOfPages: number) => void;
     onPageChanged?: (page: number, numberOfPages: number) => void;
     onError?: (error: Error) => void;
@@ -19,8 +18,17 @@ export interface DocumentViewerProps {
     accessibilityLabel?: string;
 }
 /**
- * Renders a PDF only — the WebView fallback consumer apps use for non-PDF
- * office documents is a distinct rendering strategy and stays app-side.
+ * Renders a PDF via our own native rasterizer (PDFKit on iOS, PdfRenderer on
+ * Android) — no third-party PDF dependency. Pages are paged through a plain
+ * `ScrollView` with manual windowed mounting (render the visible page ±
+ * `RENDER_WINDOW`), not a `FlatList` — a `VirtualizedList`-based component
+ * would trip React Native's "VirtualizedLists should never be nested inside
+ * plain ScrollViews" the moment a consumer embeds DocumentViewer in their own
+ * scrolling screen, which is a completely ordinary way to use it. Avoiding the
+ * VirtualizedList primitive entirely removes that whole class of warning
+ * rather than working around one instance of it. The WebView fallback
+ * consumer apps use for non-PDF office documents is a distinct rendering
+ * strategy and stays app-side.
  */
 export declare const DocumentViewer: React.FC<DocumentViewerProps>;
 export default DocumentViewer;