@vue-pdf-viewer/viewer 3.0.0-alpha.9 → 3.0.0-beta.1

package/dist/types/composables/useAnnotationHighlight.d.ts

@@ -43,6 +43,7 @@ export declare const useAnnotationHighlight: (props: UseAnnotationHighlightProps
         drawLayerId: number;
         outlineId: number;
         pageIndex?: number | undefined;
+        id: string;
         annotationType: number;
         color?: {
             [x: number]: number;
@@ -98,23 +99,22 @@ export declare const useAnnotationHighlight: (props: UseAnnotationHighlightProps
             [Symbol.iterator]: () => IterableIterator<number>;
             readonly [Symbol.toStringTag]: "Uint8ClampedArray";
         } | undefined;
-        dest: string | [number | {
+        dest?: string | [number | {
             gen: number;
             num: number;
         }, {
             name: string;
-        }, ...any[]];
-        hasAppearance: boolean;
-        id: string;
-        rect: number[];
-        subtype: string;
-        borderStyle: {
+        }, ...any[]] | undefined;
+        hasAppearance?: boolean | undefined;
+        rect?: number[] | undefined;
+        subtype?: string | undefined;
+        borderStyle?: {
             dashArray: number[];
             horizontalCornerRadius: number;
             style: number;
             verticalCornerRadius: number;
             width: number;
-        };
+        } | undefined;
         hasPopup?: boolean | undefined;
         contents?: string | undefined;
         contentsObj?: {
@@ -191,7 +191,7 @@ export declare const useAnnotationHighlight: (props: UseAnnotationHighlightProps
             x: number;
             y: number;
         }[][] | undefined;
-        lineCoordinates: number[];
+        lineCoordinates?: number[] | undefined;
         action?: string | undefined;
         unsafeUrl?: string | undefined;
         url?: string | undefined;
@@ -201,8 +201,8 @@ export declare const useAnnotationHighlight: (props: UseAnnotationHighlightProps
             y: number;
         }[] | undefined;
         name?: string | undefined;
-        fieldType: string;
-        pushButton: boolean;
+        fieldType?: string | undefined;
+        pushButton?: boolean | undefined;
         deleted?: boolean | undefined;
         noView?: boolean | undefined;
         noPrint?: boolean | undefined;
@@ -211,6 +211,7 @@ export declare const useAnnotationHighlight: (props: UseAnnotationHighlightProps
         drawLayerId: number;
         outlineId: number;
         pageIndex?: number | undefined;
+        id: string;
         annotationType: number;
         color?: {
             [x: number]: number;
@@ -266,23 +267,22 @@ export declare const useAnnotationHighlight: (props: UseAnnotationHighlightProps
             [Symbol.iterator]: () => IterableIterator<number>;
             readonly [Symbol.toStringTag]: "Uint8ClampedArray";
         } | undefined;
-        dest: string | [number | {
+        dest?: string | [number | {
             gen: number;
             num: number;
         }, {
             name: string;
-        }, ...any[]];
-        hasAppearance: boolean;
-        id: string;
-        rect: number[];
-        subtype: string;
-        borderStyle: {
+        }, ...any[]] | undefined;
+        hasAppearance?: boolean | undefined;
+        rect?: number[] | undefined;
+        subtype?: string | undefined;
+        borderStyle?: {
             dashArray: number[];
             horizontalCornerRadius: number;
             style: number;
             verticalCornerRadius: number;
             width: number;
-        };
+        } | undefined;
         hasPopup?: boolean | undefined;
         contents?: string | undefined;
         contentsObj?: {
@@ -359,7 +359,7 @@ export declare const useAnnotationHighlight: (props: UseAnnotationHighlightProps
             x: number;
             y: number;
         }[][] | undefined;
-        lineCoordinates: number[];
+        lineCoordinates?: number[] | undefined;
         action?: string | undefined;
         unsafeUrl?: string | undefined;
         url?: string | undefined;
@@ -369,8 +369,8 @@ export declare const useAnnotationHighlight: (props: UseAnnotationHighlightProps
             y: number;
         }[] | undefined;
         name?: string | undefined;
-        fieldType: string;
-        pushButton: boolean;
+        fieldType?: string | undefined;
+        pushButton?: boolean | undefined;
         deleted?: boolean | undefined;
         noView?: boolean | undefined;
         noPrint?: boolean | undefined;

package/dist/types/composables/useAnnotationStamp.d.ts

@@ -1,6 +1,20 @@
 import { AnnotationStamp } from '@/utils/types';
 import { AnnotationLayer, type PDFPageProxy } from 'pdfjs-dist';
 import { Ref } from 'vue';
+/**
+ * Custom event system for stamp annotations
+ * This decouples stamp annotation updates from the global renderTrigger
+ */
+interface StampAnnotationEvent {
+    type: 'add' | 'update' | 'remove';
+    annotation: AnnotationStamp;
+    pageIndex: number;
+}
+export declare const stampEventEmitter: {
+    listeners: Set<(event: StampAnnotationEvent) => void>;
+    emit(event: StampAnnotationEvent): void;
+    subscribe(listener: (event: StampAnnotationEvent) => void): () => boolean;
+};
 /**
  * useAnnotationStamp - Extract bitmap data from stamp annotations with ImageManager
  *
@@ -86,6 +100,10 @@ export declare const useAnnotationStamp: (props: UseAnnotationStampProps) => {
             readonly height: number;
             readonly width: number;
         } | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+        isSvg?: boolean | undefined;
+        id: string;
         annotationType: number;
         color?: {
             [x: number]: number;
@@ -141,23 +159,22 @@ export declare const useAnnotationStamp: (props: UseAnnotationStampProps) => {
             [Symbol.iterator]: () => IterableIterator<number>;
             readonly [Symbol.toStringTag]: "Uint8ClampedArray";
         } | undefined;
-        dest: string | [number | {
+        dest?: string | [number | {
             gen: number;
             num: number;
         }, {
             name: string;
-        }, ...any[]];
-        hasAppearance: boolean;
-        id: string;
-        rect: number[];
-        subtype: string;
-        borderStyle: {
+        }, ...any[]] | undefined;
+        hasAppearance?: boolean | undefined;
+        rect?: number[] | undefined;
+        subtype?: string | undefined;
+        borderStyle?: {
             dashArray: number[];
             horizontalCornerRadius: number;
             style: number;
             verticalCornerRadius: number;
             width: number;
-        };
+        } | undefined;
         hasPopup?: boolean | undefined;
         contents?: string | undefined;
         contentsObj?: {
@@ -234,7 +251,7 @@ export declare const useAnnotationStamp: (props: UseAnnotationStampProps) => {
             x: number;
             y: number;
         }[][] | undefined;
-        lineCoordinates: number[];
+        lineCoordinates?: number[] | undefined;
         action?: string | undefined;
         unsafeUrl?: string | undefined;
         url?: string | undefined;
@@ -244,8 +261,8 @@ export declare const useAnnotationStamp: (props: UseAnnotationStampProps) => {
             y: number;
         }[] | undefined;
         name?: string | undefined;
-        fieldType: string;
-        pushButton: boolean;
+        fieldType?: string | undefined;
+        pushButton?: boolean | undefined;
         deleted?: boolean | undefined;
         noView?: boolean | undefined;
         noPrint?: boolean | undefined;
@@ -319,6 +336,10 @@ export declare const useAnnotationStamp: (props: UseAnnotationStampProps) => {
             readonly height: number;
             readonly width: number;
         } | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+        isSvg?: boolean | undefined;
+        id: string;
         annotationType: number;
         color?: {
             [x: number]: number;
@@ -374,23 +395,22 @@ export declare const useAnnotationStamp: (props: UseAnnotationStampProps) => {
             [Symbol.iterator]: () => IterableIterator<number>;
             readonly [Symbol.toStringTag]: "Uint8ClampedArray";
         } | undefined;
-        dest: string | [number | {
+        dest?: string | [number | {
             gen: number;
             num: number;
         }, {
             name: string;
-        }, ...any[]];
-        hasAppearance: boolean;
-        id: string;
-        rect: number[];
-        subtype: string;
-        borderStyle: {
+        }, ...any[]] | undefined;
+        hasAppearance?: boolean | undefined;
+        rect?: number[] | undefined;
+        subtype?: string | undefined;
+        borderStyle?: {
             dashArray: number[];
             horizontalCornerRadius: number;
             style: number;
             verticalCornerRadius: number;
             width: number;
-        };
+        } | undefined;
         hasPopup?: boolean | undefined;
         contents?: string | undefined;
         contentsObj?: {
@@ -467,7 +487,7 @@ export declare const useAnnotationStamp: (props: UseAnnotationStampProps) => {
             x: number;
             y: number;
         }[][] | undefined;
-        lineCoordinates: number[];
+        lineCoordinates?: number[] | undefined;
         action?: string | undefined;
         unsafeUrl?: string | undefined;
         url?: string | undefined;
@@ -477,8 +497,8 @@ export declare const useAnnotationStamp: (props: UseAnnotationStampProps) => {
             y: number;
         }[] | undefined;
         name?: string | undefined;
-        fieldType: string;
-        pushButton: boolean;
+        fieldType?: string | undefined;
+        pushButton?: boolean | undefined;
         deleted?: boolean | undefined;
         noView?: boolean | undefined;
         noPrint?: boolean | undefined;

package/dist/types/composables/useAnnotationStorage.d.ts

@@ -68,5 +68,5 @@ export declare const getGlobalStorageEntries: () => unknown[];
  * @param value - The annotation data to serialize
  * @returns A serializable version of the annotation data
  */
-export declare function createSerializableAnnotation(value: any): any;
+export declare function createSerializableAnnotation(value: any): Promise<any>;
 export default function useAnnotationStorage(): UseAnnotationStorageReturn;

package/dist/types/composables/usePlugins.d.ts

@@ -1,6 +1,6 @@
 import { ComputedRef } from 'vue';
 import type { Reactive } from 'vue';
-import type { Localization, PluginItem, Plugin } from '@vue-pdf-viewer/shared';
+import { type Localization, type PluginItem, type Plugin } from '@vue-pdf-viewer/shared';
 declare const usePlugins: (plugins?: Reactive<Plugin[]>, viewerLocalization?: ComputedRef<Localization>) => {
     currentInstance: import("vue").ComponentInternalInstance | null;
     sidebarItems: import("vue").Ref<{

package/dist/types/utils/annotation-free-text.d.ts

@@ -1,4 +1,3 @@
-export declare function getFreeTextFont(fontName: string, fontSize: number): {
-    fontSize: string;
-    fontFamily: string;
-};
+export declare function getFreeTextFontSize(fontSize: number): string;
+export declare function getFreeTextFontFamily(fontName: string): string;
+export declare function replaceNewlinesWithBackslashN(contentEditableElement: HTMLDivElement): string;

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

@@ -54,6 +54,25 @@ export declare function getSelectionBoxes(textLayer: HTMLElement): {
  * @param {PageViewport} viewport - PDF page viewport
  * @returns {number[]} Array of quadPoints in PDF coordinate system
  */
+/**
+ * Convert selection boxes to PDF quadPoints coordinates
+ *
+ * In PDF, quadPoints are used to define the coordinates of a quadrilateral.
+ * Each quadrilateral requires 8 numbers representing 4 points (x,y pairs).
+ * The points MUST be specified in the following order (x,y pairs):
+ * - (x1,y1): left x, bottom y  - bottom left
+ * - (x2,y2): right x, bottom y - bottom right
+ * - (x3,y3): left x, top y    - top left
+ * - (x4,y4): right x, top y   - top right
+ *
+ * This order is based on PDF.js implementation and real-world PDF files,
+ * which differs slightly from the PDF specification (which suggests a different order).
+ *
+ * @param boxes Array of normalized boxes (coordinates in 0-1 range)
+ * @param viewport PDF page viewport for coordinate conversion
+ * @returns Array of quadPoints in PDF coordinate system
+ * @throws Error if boxes array is empty
+ */
 export declare function boxesToQuadPoints(boxes: Array<{
     x: number;
     y: number;

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

@@ -56,14 +56,14 @@ interface Attachment {
 }
 type OutlineDestinationType = string | OutlineDestination;
 export interface Annotation {
+    id: string;
     annotationType: number;
     color?: Uint8ClampedArray;
-    dest: OutlineDestinationType;
-    hasAppearance: boolean;
-    id: string;
-    rect: number[];
-    subtype: string;
-    borderStyle: {
+    dest?: OutlineDestinationType;
+    hasAppearance?: boolean;
+    rect?: number[];
+    subtype?: string;
+    borderStyle?: {
         dashArray: number[];
         horizontalCornerRadius: number;
         style: number;
@@ -87,15 +87,15 @@ export interface Annotation {
     parentType?: string;
     file?: Attachment;
     inkLists?: AnnotationPoint[][];
-    lineCoordinates: number[];
+    lineCoordinates?: number[];
     action?: string;
     unsafeUrl?: string;
     url?: string;
     newWindow?: boolean;
     vertices?: AnnotationPoint[];
     name?: string;
-    fieldType: string;
-    pushButton: boolean;
+    fieldType?: string;
+    pushButton?: boolean;
     deleted?: boolean;
     noView?: boolean;
     noPrint?: boolean;
@@ -711,6 +711,9 @@ export interface AnnotationStamp extends Annotation {
     elementRect?: ElementRect;
     bitmapId?: string;
     bitmap?: ImageData;
+    width?: number;
+    height?: number;
+    isSvg?: boolean;
 }
 export interface FreeTextAppearance {
     fontColor: Uint8ClampedArray;
@@ -723,5 +726,16 @@ export interface AnnotationFreeText extends Annotation {
     color?: Uint8ClampedArray;
     fontSize?: number;
     value?: string;
+    richText?: {
+        html: {
+            attributes: {
+                style: Partial<CSSStyleDeclaration>;
+                class: string[];
+            };
+            name: string;
+        };
+        str: string;
+    };
+    isModified?: boolean;
 }
 export {};

package/dist/types/utils.d.ts

@@ -8,6 +8,7 @@ export declare const attachWatermarkShadowDOM: (rootViewer: HTMLDivElement) => H
 export declare const formatDate: (date: string) => string;
 export declare const formatCommentTimestamp: (date: string | Date) => string;
 export declare function calculateScale(container: HTMLElement, pageHeight: number, pageWidth: number, scale: ZoomLevel, viewMode: ViewMode, numPages: number): number;
+export declare const getTodayPdfDate: () => string;
 export declare const getPdfDate: (date: string) => string | Date;
 export declare const cssTextToObject: (cssText: string) => Record<string, string>;
 export declare function rectBoundingBox(x0: number, y0: number, x1: number, y1: number, minMax: number[]): void;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vue-pdf-viewer/viewer",
   "private": false,
-  "version": "3.0.0-alpha.9",
+  "version": "3.0.0-beta.1",
   "type": "module",
   "main": "./dist/index.umd.cjs",
   "module": "./dist/index.js",
@@ -59,7 +59,7 @@
     "prepare": "husky"
   },
   "dependencies": {
-    "@vue-pdf-viewer/shared": "1.0.0-alpha.3",
+    "@vue-pdf-viewer/shared": "1.0.0-beta.0",
     "@vueuse/core": "^13.6.0",
     "pdfjs-dist": "4.10.38",
     "reka-ui": "^2.4.1",
@@ -93,7 +93,6 @@
     "jsdom": "^26.1.0",
     "lint-staged": "^15.2.5",
     "lucide-vue-next": "^0.367.0",
-    "playwright": "^1.54.2",
     "prettier": "3.2.5",
     "radix-vue": "^1.6.2",
     "sass": "^1.75.0",
@@ -117,5 +116,6 @@
     "bun": ">=1.0.4",
     "pnpm": ">=8.8.0",
     "yarn": ">=1.20.0"
-  }
+  },
+  "packageManager": "pnpm@10.15.0+sha512.486ebc259d3e999a4e8691ce03b5cac4a71cbeca39372a9b762cb500cfdf0873e2cb16abe3d951b1ee2cf012503f027b98b6584e4df22524e0c7450d9ec7aa7b"
 }