@papyrus-sdk/ui-react-native 0.2.32 → 0.2.34

package/README.md

@@ -83,11 +83,13 @@ await engine.load({ type: 'pdf', source: { uri: 'https://example.com/book.pdf' }
 
 ## Mobile Tuning Flags
 
-Performance tuning props are available on `Viewer` and `RightSheet`:
+Layout and performance options are available on `Viewer` and `RightSheet`:
 
 ```tsx
 <Viewer
   engine={engine}
+  maxPageWidth={760}
+  fitPageToViewportHeight
   virtualWindowSize={8}
   maxToRenderPerBatch={6}
   removeClippedSubviews
@@ -97,6 +99,12 @@ Performance tuning props are available on `Viewer` and `RightSheet`:
 ```
 
 - `virtualWindowSize` (`Viewer`): FlatList window size. Default: `8`.
+- `maxPageWidth` (`Viewer`): optional fit-zoom width limit in React Native points. A narrower page is centered in the viewport; pinch zoom may enlarge it. Omitted by default.
+- `fitPageToViewportHeight` (`Viewer`): opt-in page fitting to the measured
+  viewer height while preserving each page's aspect ratio; pinch zoom may
+  enlarge it. Defaults to `false`. This option is only supported by the React
+  Native compatibility renderer; it is not applied by the WebView or dedicated
+  Android PDF renderer.
 - `maxToRenderPerBatch` (`Viewer`): max items per render batch. Default: `6`.
 - `removeClippedSubviews` (`Viewer`): detach offscreen rows. Default: `false`
   for Android `viewerMode="compat"` and `true` otherwise. An explicit value is

package/dist/index.d.mts

@@ -6,6 +6,14 @@ import { StyleProp, ViewStyle } from 'react-native';
 
 interface ViewerProps {
     engine: DocumentEngine;
+    /** Maximum page width at fit zoom, in React Native points; pinch zoom may enlarge it. */
+    maxPageWidth?: number;
+    /**
+     * Fit each page's aspect ratio within the measured viewer height at fit zoom.
+     * Supported by the React Native compatibility renderer; not applied by the
+     * WebView or dedicated Android PDF renderer.
+     */
+    fitPageToViewportHeight?: boolean;
     virtualWindowSize?: number;
     maxToRenderPerBatch?: number;
     removeClippedSubviews?: boolean;
@@ -50,6 +58,8 @@ interface PageRendererProps {
     pageAspectRatio?: number;
     PageViewComponent?: PageViewComponentType;
     availableWidth?: number;
+    maxPageWidth?: number;
+    maxPageHeight?: number;
     pageViewportWidth?: number;
     horizontalPadding?: number;
     spacing?: number;
@@ -133,8 +143,9 @@ declare function ReadingShell({ engine, title, documentType, thumbsInitialCount,
 
 type DedicatedAndroidPdfViewerProps = {
     engine: DocumentEngine;
+    maxPageWidth?: number;
 };
-declare function DedicatedAndroidPdfViewer({ engine, }: DedicatedAndroidPdfViewerProps): react_jsx_runtime.JSX.Element;
+declare function DedicatedAndroidPdfViewer({ engine, maxPageWidth, }: DedicatedAndroidPdfViewerProps): react_jsx_runtime.JSX.Element;
 
 type OverflowSheetProps = {
     visible: boolean;

package/dist/index.d.ts

@@ -6,6 +6,14 @@ import { StyleProp, ViewStyle } from 'react-native';
 
 interface ViewerProps {
     engine: DocumentEngine;
+    /** Maximum page width at fit zoom, in React Native points; pinch zoom may enlarge it. */
+    maxPageWidth?: number;
+    /**
+     * Fit each page's aspect ratio within the measured viewer height at fit zoom.
+     * Supported by the React Native compatibility renderer; not applied by the
+     * WebView or dedicated Android PDF renderer.
+     */
+    fitPageToViewportHeight?: boolean;
     virtualWindowSize?: number;
     maxToRenderPerBatch?: number;
     removeClippedSubviews?: boolean;
@@ -50,6 +58,8 @@ interface PageRendererProps {
     pageAspectRatio?: number;
     PageViewComponent?: PageViewComponentType;
     availableWidth?: number;
+    maxPageWidth?: number;
+    maxPageHeight?: number;
     pageViewportWidth?: number;
     horizontalPadding?: number;
     spacing?: number;
@@ -133,8 +143,9 @@ declare function ReadingShell({ engine, title, documentType, thumbsInitialCount,
 
 type DedicatedAndroidPdfViewerProps = {
     engine: DocumentEngine;
+    maxPageWidth?: number;
 };
-declare function DedicatedAndroidPdfViewer({ engine, }: DedicatedAndroidPdfViewerProps): react_jsx_runtime.JSX.Element;
+declare function DedicatedAndroidPdfViewer({ engine, maxPageWidth, }: DedicatedAndroidPdfViewerProps): react_jsx_runtime.JSX.Element;
 
 type OverflowSheetProps = {
     visible: boolean;