@vue-pdf-viewer/viewer 0.0.0-experimental.87 → 0.0.0-experimental.89

package/dist/types/utils/annotation-highlight.d.ts

@@ -36,6 +36,19 @@ export declare function quadPointsToBoxesForRect(quadPoints: number[], rect: num
     width: number;
     height: number;
 }[];
+/**
+ * Reconstruct PDF-coordinate highlight `outlines` from `quadPoints` + `rect`.
+ *
+ * PDF.js's print/appearance generator (HighlightAnnotation.createNewAppearanceStream)
+ * iterates the `outlines` field; a highlight without it throws "n is not iterable",
+ * blanking the whole print preview. Highlights imported from XFDF carry only
+ * `quadPoints`, so this rebuilds the missing `outlines` using the same outline
+ * machinery as tool-created highlights — but normalized against the rect, so no live
+ * viewport/DOM is required (safe to call from the print path).
+ *
+ * @returns serialized outlines (array of point arrays in PDF coords), or null if input is unusable.
+ */
+export declare function buildHighlightOutlines(quadPoints: ArrayLike<number> | null | undefined, rect: ArrayLike<number> | null | undefined): number[][] | null;
 /**
  * Get selection boxes from text layer with proper rotation handling.
  * Adapted from PDF.js display/editor/tools.js

package/dist/types/utils/types.d.ts

@@ -2,7 +2,7 @@ import { ComputedRef, MaybeRef, PropType, Reactive, Ref } from 'vue';
 import type { PageViewport, RenderTask } from 'pdfjs-dist';
 import type { DocumentInitParameters, OnProgressParameters, PDFDataRangeTransport, TextContent, TypedArray, PDFPageProxy, PDFDocumentProxy, RenderParameters } from 'pdfjs-dist/types/src/display/api';
 import type { Metadata } from 'pdfjs-dist/types/src/display/metadata';
-import type { Annotation, AnnotationToolOption, TextSelectionOption } from '@vue-pdf-viewer/shared';
+import type { Annotation, AnnotationToolOption, TextSelectionOption, AnnotationTextSelectionControl, AnnotationFreeTextControl, XfdfImportResult, XfdfSkippedEntry } from '@vue-pdf-viewer/shared';
 import { ZoomLevel, ViewMode, ScrollMode, SelectionMode, VPVAnnotationType, LicenseType, LicenseProduct } from './enumerators';
 import { Localization, Plugin, AnnotationType } from '@vue-pdf-viewer/shared';
 export interface VirtualRange {
@@ -122,7 +122,8 @@ export type UpdatePasswordFn = (newPassword: string) => void;
 export type OnPasswordCallback = (updatePassword: UpdatePasswordFn, reason: any) => void;
 export type OnErrorCallback = (error: any) => void;
 export declare enum ErrorType {
-    NOT_SUPPORTED = "not-supported"
+    NOT_SUPPORTED = "not-supported",
+    PASSWORD_REQUIRED = "password-required"
 }
 /**
  * Payload for the password-required event.
@@ -184,7 +185,7 @@ export interface PDFOptions {
     password?: string;
 }
 export interface PDFInfoMetadata {
-    info: Object;
+    info: Record<string, any>;
     metadata: Metadata;
 }
 export interface PDFInfo {
@@ -230,6 +231,12 @@ export interface ViewerPdfPage {
     isEstimated: boolean;
     /** Inherent page rotation (0, 90, 180, 270). Cloned from page 1 when estimated; set to pdfPage.rotate when actual. */
     pdfPageRotate: number;
+    /**
+     * 1-indexed page number this entry represents. Unlike `page.pageNumber`, always
+     * available — estimated pages have `page: null`, so consumers must not derive
+     * the page index from the proxy.
+     */
+    pageNumber: number;
 }
 export interface ItemMeasurement {
     index: number;
@@ -383,6 +390,11 @@ export interface VPdfViewerProps {
      * If unspecified, the viewer will use the worker from pdfjs-dist@3.11.174
      */
     workerUrl?: string;
+    /**
+     * The URL directory where the pdf.js WASM files are located. Include the trailing slash.
+     * Required when hosting WASM assets at a custom path (e.g. for JPEG 2000 decoding).
+     */
+    wasmUrl?: string;
     /**
      * The number of page that will be displayed initially
      */
@@ -507,6 +519,10 @@ export declare const VPVBaseProps: {
         readonly type: PropType<string>;
         readonly default: undefined;
     };
+    readonly wasmUrl: {
+        readonly type: PropType<string>;
+        readonly default: undefined;
+    };
     readonly initialPage: {
         readonly type: PropType<number>;
         readonly default: () => number;
@@ -675,6 +691,7 @@ export interface PageControl {
     goToPage: (page: number) => void;
     currentPage: number;
     totalPages: number;
+    rotatePage: (pageNumber: number, degree: 90 | 180 | 270 | -90 | ((currentDegree: number) => 90 | 180 | 270 | -90)) => void;
 }
 export interface DownloadPdfProgress {
     bytesDownloaded: number;
@@ -702,6 +719,19 @@ export interface UseScaleCallback {
     mode?: ZoomLevel;
     error?: string;
 }
+export interface XfdfExportOptions {
+    pdfFilename?: string;
+    download?: boolean;
+}
+export interface AnnotationXfdfControl {
+    exportToXfdf: (options?: XfdfExportOptions) => Promise<string>;
+    importFromXfdf: (xfdfString: string) => XfdfImportResult;
+}
+export interface AnnotationControl {
+    getAnnotations: () => Annotation[];
+    clearAnnotations: () => void;
+}
+export type { XfdfImportResult, XfdfSkippedEntry };
 export interface VPVInstance {
     printControl: Reactive<PrintControl> | undefined;
     searchControl: SearchControl | undefined;
@@ -710,6 +740,10 @@ export interface VPVInstance {
     downloadControl: Reactive<DownloadControl> | undefined;
     zoomControl: Reactive<ZoomControl> | undefined;
     passwordControl: Reactive<PasswordControl> | undefined;
+    annotationTextSelectionControl: Reactive<AnnotationTextSelectionControl> | undefined;
+    annotationFreeTextControl: Reactive<AnnotationFreeTextControl> | undefined;
+    annotationXfdfControl: Reactive<AnnotationXfdfControl> | undefined;
+    annotationControl: Reactive<AnnotationControl> | undefined;
 }
 export interface NavigationAnnotation {
     action: 'FirstPage' | 'LastPage' | 'NextPage' | 'PrevPage';

package/dist/types/utils/zoomStretch.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Composited zoom-stretch helpers.
+ *
+ * During a zoom gesture the DOM layout stays frozen at the gesture-start scale
+ * (`baseScale`) and visual feedback comes from a single composited
+ * `transform: scale()` on the pages wrapper — a ~3ms compositor operation instead
+ * of a style-recalc + layout across every page placeholder (O(N) per zoom step,
+ * ~1s main-thread block on a 6000-page document). The real layout is committed
+ * once when the gesture settles.
+ */
+import type { CSSProperties } from 'vue';
+export type StretchTransformStyle = Pick<CSSProperties, 'transform' | 'transformOrigin' | 'willChange'>;
+/**
+ * Compute the wrapper transform that visually stretches the frozen layout from
+ * `baseScale` to `currentScale`, anchored so the content point under `origin`
+ * (viewport coordinates, relative to the scroll container) stays stationary.
+ *
+ * @param currentScale - The scale the gesture has reached
+ * @param baseScale - The scale the DOM layout is committed at (gesture start)
+ * @param origin - Zoom anchor in container-viewport coordinates, or null for the top-left
+ * @param baseScroll - Scroll offsets captured at gesture start (layout is frozen, so these stay valid)
+ * @param fit - Frozen-scale page size + container inner size. Used to decide PER AXIS whether
+ *   the page fits at the current gesture scale: on an axis where it fits, that axis cannot
+ *   scroll and the committed layout keeps the page centered, so the transform scales about the
+ *   viewport CENTER on that axis (page grows centered, no left/right shift) instead of the
+ *   cursor. Omit to always cursor-anchor both axes.
+ * @returns Style properties for the wrapper, or null when no transform is needed
+ */
+export declare function computeStretchTransform(currentScale: number, baseScale: number, origin: [number, number] | null, baseScroll: {
+    top: number;
+    left: number;
+}, fit?: {
+    pageWidth: number;
+    pageHeight: number;
+    containerWidth: number;
+    containerHeight: number;
+} | null): StretchTransformStyle | null;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vue-pdf-viewer/viewer",
   "private": false,
-  "version": "0.0.0-experimental.87",
+  "version": "0.0.0-experimental.89",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -65,7 +65,7 @@
     "prepare": "husky"
   },
   "dependencies": {
-    "@vue-pdf-viewer/shared": "1.4.0",
+    "@vue-pdf-viewer/shared": "1.6.1",
     "@vueuse/core": "^13.6.0",
     "node-forge": "^1.3.2",
     "pdfjs-dist": "5.4.530",
@@ -77,9 +77,10 @@
     "vue": "^3.2.37"
   },
   "devDependencies": {
-    "@laynezh/vite-plugin-lib-assets": "^0.5.24",
     "@esbuild/darwin-arm64": "0.21.5",
     "@esbuild/darwin-x64": "0.21.5",
+    "@laynezh/vite-plugin-lib-assets": "^0.5.24",
+    "@rollup/rollup-darwin-arm64": "^4.60.4",
     "@rollup/rollup-darwin-x64": "^4.60.1",
     "@types/node": "^20.11.30",
     "@types/node-forge": "^1.3.14",