@papyrus-sdk/ui-react-native 0.2.32 → 0.2.35-beta.0

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,12 +6,30 @@ 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;
     useDedicatedAndroidPdfViewer?: boolean;
     viewerMode?: PdfViewerMode;
     pageScrubActive?: boolean;
+    /** Called when the native iOS PDF viewer selects non-empty text. */
+    onTextSelected?: (payload: {
+        text: string;
+        pageIndex: number;
+    }) => void;
+    /** Called when the reader's Define action is pressed for the current selection. */
+    onDefineSelection?: (payload: {
+        text: string;
+        pageIndex: number;
+    }) => void;
 }
 declare const Viewer: React.FC<ViewerProps>;
 
@@ -50,6 +68,8 @@ interface PageRendererProps {
     pageAspectRatio?: number;
     PageViewComponent?: PageViewComponentType;
     availableWidth?: number;
+    maxPageWidth?: number;
+    maxPageHeight?: number;
     pageViewportWidth?: number;
     horizontalPadding?: number;
     spacing?: number;
@@ -131,10 +151,19 @@ type ReadingShellProps = {
 };
 declare function ReadingShell({ engine, title, documentType, thumbsInitialCount, viewerProps, }: ReadingShellProps): react_jsx_runtime.JSX.Element;
 
-type DedicatedAndroidPdfViewerProps = {
+type NativePdfDocumentViewerProps = {
     engine: DocumentEngine;
+    maxPageWidth?: number;
+    onTextSelected?: (payload: {
+        text: string;
+        pageIndex: number;
+    }) => void;
+    onDefineSelection?: (payload: {
+        text: string;
+        pageIndex: number;
+    }) => void;
 };
-declare function DedicatedAndroidPdfViewer({ engine, }: DedicatedAndroidPdfViewerProps): react_jsx_runtime.JSX.Element;
+declare function NativePdfDocumentViewer({ engine, maxPageWidth, onTextSelected, onDefineSelection, }: NativePdfDocumentViewerProps): react_jsx_runtime.JSX.Element;
 
 type OverflowSheetProps = {
     visible: boolean;
@@ -216,4 +245,4 @@ declare const IconUnderline: React.FC<IconProps>;
 declare const IconMessageSquareQuote: React.FC<IconProps>;
 declare const IconQuote: React.FC<IconProps>;
 
-export { AnnotationEditor, BottomBar, CoverPreview, DocumentActionsSheet, IconCopy, IconMessageSquareQuote, IconPageNav, IconPencilLine, IconQuote, IconUnderline, InfoSheet, MOBILE_CHROME_METRICS, MobilePerfProvider, DedicatedAndroidPdfViewer as NativePdfDocumentViewer, OverflowSheet, _default as PageRenderer, ProgressPill, ReadingShell, RightSheet, SearchOverlay, SearchResultsSheet, SettingsSheet, ToolDock, Topbar, Viewer, createPerfSession, createRunId, useMobilePerf };
+export { AnnotationEditor, BottomBar, CoverPreview, DocumentActionsSheet, IconCopy, IconMessageSquareQuote, IconPageNav, IconPencilLine, IconQuote, IconUnderline, InfoSheet, MOBILE_CHROME_METRICS, MobilePerfProvider, NativePdfDocumentViewer, OverflowSheet, _default as PageRenderer, ProgressPill, ReadingShell, RightSheet, SearchOverlay, SearchResultsSheet, SettingsSheet, ToolDock, Topbar, Viewer, type ViewerProps, createPerfSession, createRunId, useMobilePerf };

package/dist/index.d.ts

@@ -6,12 +6,30 @@ 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;
     useDedicatedAndroidPdfViewer?: boolean;
     viewerMode?: PdfViewerMode;
     pageScrubActive?: boolean;
+    /** Called when the native iOS PDF viewer selects non-empty text. */
+    onTextSelected?: (payload: {
+        text: string;
+        pageIndex: number;
+    }) => void;
+    /** Called when the reader's Define action is pressed for the current selection. */
+    onDefineSelection?: (payload: {
+        text: string;
+        pageIndex: number;
+    }) => void;
 }
 declare const Viewer: React.FC<ViewerProps>;
 
@@ -50,6 +68,8 @@ interface PageRendererProps {
     pageAspectRatio?: number;
     PageViewComponent?: PageViewComponentType;
     availableWidth?: number;
+    maxPageWidth?: number;
+    maxPageHeight?: number;
     pageViewportWidth?: number;
     horizontalPadding?: number;
     spacing?: number;
@@ -131,10 +151,19 @@ type ReadingShellProps = {
 };
 declare function ReadingShell({ engine, title, documentType, thumbsInitialCount, viewerProps, }: ReadingShellProps): react_jsx_runtime.JSX.Element;
 
-type DedicatedAndroidPdfViewerProps = {
+type NativePdfDocumentViewerProps = {
     engine: DocumentEngine;
+    maxPageWidth?: number;
+    onTextSelected?: (payload: {
+        text: string;
+        pageIndex: number;
+    }) => void;
+    onDefineSelection?: (payload: {
+        text: string;
+        pageIndex: number;
+    }) => void;
 };
-declare function DedicatedAndroidPdfViewer({ engine, }: DedicatedAndroidPdfViewerProps): react_jsx_runtime.JSX.Element;
+declare function NativePdfDocumentViewer({ engine, maxPageWidth, onTextSelected, onDefineSelection, }: NativePdfDocumentViewerProps): react_jsx_runtime.JSX.Element;
 
 type OverflowSheetProps = {
     visible: boolean;
@@ -216,4 +245,4 @@ declare const IconUnderline: React.FC<IconProps>;
 declare const IconMessageSquareQuote: React.FC<IconProps>;
 declare const IconQuote: React.FC<IconProps>;
 
-export { AnnotationEditor, BottomBar, CoverPreview, DocumentActionsSheet, IconCopy, IconMessageSquareQuote, IconPageNav, IconPencilLine, IconQuote, IconUnderline, InfoSheet, MOBILE_CHROME_METRICS, MobilePerfProvider, DedicatedAndroidPdfViewer as NativePdfDocumentViewer, OverflowSheet, _default as PageRenderer, ProgressPill, ReadingShell, RightSheet, SearchOverlay, SearchResultsSheet, SettingsSheet, ToolDock, Topbar, Viewer, createPerfSession, createRunId, useMobilePerf };
+export { AnnotationEditor, BottomBar, CoverPreview, DocumentActionsSheet, IconCopy, IconMessageSquareQuote, IconPageNav, IconPencilLine, IconQuote, IconUnderline, InfoSheet, MOBILE_CHROME_METRICS, MobilePerfProvider, NativePdfDocumentViewer, OverflowSheet, _default as PageRenderer, ProgressPill, ReadingShell, RightSheet, SearchOverlay, SearchResultsSheet, SettingsSheet, ToolDock, Topbar, Viewer, type ViewerProps, createPerfSession, createRunId, useMobilePerf };