@embedpdf/models 2.4.1 → 2.6.0

package/dist/pdf.d.ts

@@ -61,6 +61,11 @@ export interface PdfDocumentObject {
      * Use PdfPermissionFlag to check individual permissions.
      */
     permissions: number;
+    /**
+     * Whether page rotation was normalized when opening the document.
+     * When true, all page coordinates are in 0° space regardless of original rotation.
+     */
+    normalizedRotation: boolean;
 }
 /**
  * metadata of pdf document
@@ -908,6 +913,17 @@ export interface PdfAnnotationObjectBase {
      * Rectangle of the annotation
      */
     rect: Rect;
+    /**
+     * Rotation angle in degrees (clockwise).
+     * When set, the annotation is visually rotated around its center.
+     * The rect becomes the axis-aligned bounding box after rotation.
+     */
+    rotation?: number;
+    /**
+     * The original unrotated rectangle of the annotation.
+     * This is stored when rotation is applied, allowing accurate editing.
+     */
+    unrotatedRect?: Rect;
     /**
      * Custom data of the annotation
      */
@@ -1819,11 +1835,11 @@ export interface PdfRedactAnnoObject extends PdfAnnotationObjectBase {
      */
     segmentRects: Rect[];
     /**
-     * Interior color - the preview color shown BEFORE redaction is applied
+     * Interior color (IC) - the fill color used to paint the redacted area after redaction is applied
      */
     color?: string;
     /**
-     * Overlay color - the fill color shown AFTER redaction is applied
+     * Overlay text color - the color of the overlay text displayed on the redacted area
      */
     overlayColor?: string;
     /**
@@ -2370,6 +2386,12 @@ export interface PdfOpenDocumentBufferOptions {
      * Password for the document
      */
     password?: string;
+    /**
+     * When true, normalizes page rotation so all coordinates are in 0° space.
+     * The original rotation is preserved in page.rotation for reference.
+     * @default false
+     */
+    normalizeRotation?: boolean;
 }
 export interface PdfRequestOptions {
     /**
@@ -2398,6 +2420,12 @@ export interface PdfOpenDocumentUrlOptions {
      * HTTP request options for fetching the PDF
      */
     requestOptions?: PdfRequestOptions;
+    /**
+     * When true, normalizes page rotation so all coordinates are in 0° space.
+     * The original rotation is preserved in page.rotation for reference.
+     * @default false
+     */
+    normalizeRotation?: boolean;
 }
 export interface PdfRenderOptions {
     /**
@@ -2446,6 +2474,12 @@ export interface PdfRenderPageAnnotationOptions extends PdfRenderOptions {
      * Appearance mode normal down or rollover
      */
     mode?: AppearanceMode;
+    /**
+     * When true and annotation.unrotatedRect is present, render using the
+     * unrotated path (ignores AP Matrix rotation). Falls back to normal
+     * rendering if unrotatedRect is not available on the annotation.
+     */
+    unrotated?: boolean;
 }
 export interface PdfRenderThumbnailOptions extends PdfRenderOptions {
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@embedpdf/models",
-  "version": "2.4.1",
+  "version": "2.6.0",
   "private": false,
   "description": "Shared type definitions, data models, and utility helpers (geometry, tasks, logging, PDF primitives) that underpin every package in the EmbedPDF ecosystem.",
   "type": "module",