@embedpdf/models 2.6.1 → 2.7.0

package/dist/pdf.d.ts

@@ -382,6 +382,36 @@ export type ImageDataLike = {
     height: number;
     colorSpace?: PredefinedColorSpace;
 };
+/**
+ * Bitmask constants for annotation appearance stream modes.
+ * @public
+ */
+export declare const AP_MODE_NORMAL = 1;
+export declare const AP_MODE_ROLLOVER = 2;
+export declare const AP_MODE_DOWN = 4;
+/**
+ * A rendered appearance stream image for a single mode of an annotation.
+ * @public
+ */
+export interface AnnotationAppearanceImage<TImage = ImageDataLike> {
+    data: TImage;
+    rect: Rect;
+}
+/**
+ * All available appearance stream images for one annotation,
+ * keyed by mode (normal, rollover, down).
+ * @public
+ */
+export interface AnnotationAppearances<TImage = ImageDataLike> {
+    normal?: AnnotationAppearanceImage<TImage>;
+    rollover?: AnnotationAppearanceImage<TImage>;
+    down?: AnnotationAppearanceImage<TImage>;
+}
+/**
+ * Map of annotation ID to its rendered appearance stream images.
+ * @public
+ */
+export type AnnotationAppearanceMap<TImage = ImageDataLike> = Record<string, AnnotationAppearances<TImage>>;
 /**
  * Representation of pdf action
  *
@@ -928,6 +958,12 @@ export interface PdfAnnotationObjectBase {
      * Custom data of the annotation
      */
     custom?: any;
+    /**
+     * Bitmask of available appearance stream modes.
+     * bit 0 (1) = Normal, bit 1 (2) = Rollover, bit 2 (4) = Down.
+     * 0 or undefined = no appearance stream.
+     */
+    appearanceModes?: number;
     /**
      * In reply to annotation id (IRT - for grouping or reply threads)
      */
@@ -2090,19 +2126,34 @@ export interface SearchAllPagesResult {
  */
 export interface PdfGlyphObject {
     /**
-     * Origin of the glyph
+     * Origin of the glyph (loose bounds from FPDFText_GetLooseCharBox)
      */
     origin: {
         x: number;
         y: number;
     };
     /**
-     * Size of the glyph
+     * Size of the glyph (loose bounds from FPDFText_GetLooseCharBox)
      */
     size: {
         width: number;
         height: number;
     };
+    /**
+     * Tight bounds origin (from FPDFText_GetCharBox, closely surrounds the actual glyph shape).
+     * Used for hit-testing to match Chrome's FPDFText_GetCharIndexAtPos behaviour.
+     */
+    tightOrigin?: {
+        x: number;
+        y: number;
+    };
+    /**
+     * Tight bounds size (from FPDFText_GetCharBox)
+     */
+    tightSize?: {
+        width: number;
+        height: number;
+    };
     /**
      * Whether the glyph is a space
      */
@@ -2119,25 +2170,42 @@ export interface PdfGlyphObject {
  */
 export interface PdfGlyphSlim {
     /**
-     * X coordinate of the glyph
+     * X coordinate of the glyph (loose bounds from FPDFText_GetLooseCharBox)
      */
     x: number;
     /**
-     * Y coordinate of the glyph
+     * Y coordinate of the glyph (loose bounds from FPDFText_GetLooseCharBox)
      */
     y: number;
     /**
-     * Width of the glyph
+     * Width of the glyph (loose bounds from FPDFText_GetLooseCharBox)
      */
     width: number;
     /**
-     * Height of the glyph
+     * Height of the glyph (loose bounds from FPDFText_GetLooseCharBox)
      */
     height: number;
     /**
      * Flags of the glyph
      */
     flags: number;
+    /**
+     * Tight X coordinate (from FPDFText_GetCharBox).
+     * Used for hit-testing to match Chrome's FPDFText_GetCharIndexAtPos behaviour.
+     */
+    tightX?: number;
+    /**
+     * Tight Y coordinate (from FPDFText_GetCharBox)
+     */
+    tightY?: number;
+    /**
+     * Tight width (from FPDFText_GetCharBox)
+     */
+    tightWidth?: number;
+    /**
+     * Tight height (from FPDFText_GetCharBox)
+     */
+    tightHeight?: number;
 }
 /**
  * Run object
@@ -2162,6 +2230,10 @@ export interface PdfRun {
      * Glyphs of the run
      */
     glyphs: PdfGlyphSlim[];
+    /**
+     * Font size of the run (all glyphs in a run share the same font size)
+     */
+    fontSize?: number;
 }
 /**
  * Page geometry
@@ -2734,6 +2806,24 @@ export interface PdfEngine<T = Blob> {
      * @param options - render options
      */
     renderPageAnnotation(doc: PdfDocumentObject, page: PdfPageObject, annotation: PdfAnnotationObject, options?: PdfRenderPageAnnotationOptions): PdfTask<T>;
+    /**
+     * Batch-render all annotation appearance streams for a page and encode
+     * each rendered image to the output type of this engine.
+     * Returns a map of annotation ID to rendered appearances (Normal/Rollover/Down).
+     * @param doc - pdf document
+     * @param page - pdf page
+     * @param options - render options
+     */
+    renderPageAnnotations(doc: PdfDocumentObject, page: PdfPageObject, options?: PdfRenderPageAnnotationOptions): PdfTask<AnnotationAppearanceMap<T>>;
+    /**
+     * Batch-render all annotation appearance streams for a page.
+     * Returns a map of annotation ID to rendered appearances (Normal/Rollover/Down).
+     * Skips EmbedPDF-rotated annotations and annotations without appearance streams.
+     * @param doc - pdf document
+     * @param page - pdf page
+     * @param options - render options (scaleFactor, dpr, rotation)
+     */
+    renderPageAnnotationsRaw(doc: PdfDocumentObject, page: PdfPageObject, options?: PdfRenderPageAnnotationOptions): PdfTask<AnnotationAppearanceMap<ImageDataLike>>;
     /**
      * Get annotations of pdf page
      * @param doc - pdf document
@@ -2757,7 +2847,9 @@ export interface PdfEngine<T = Blob> {
      * @param annotation - new annotations
      * @returns task that indicates whether the operation succeeded
      */
-    updatePageAnnotation: (doc: PdfDocumentObject, page: PdfPageObject, annotation: PdfAnnotationObject) => PdfTask<boolean>;
+    updatePageAnnotation: (doc: PdfDocumentObject, page: PdfPageObject, annotation: PdfAnnotationObject, options?: {
+        regenerateAppearance?: boolean;
+    }) => PdfTask<boolean>;
     /**
      * Remove a annotation on specified page
      * @param doc - pdf document
@@ -3027,10 +3119,13 @@ export interface IPdfiumExecutor {
     renderPageRect(doc: PdfDocumentObject, page: PdfPageObject, rect: Rect, options?: PdfRenderPageOptions): PdfTask<ImageDataLike>;
     renderThumbnailRaw(doc: PdfDocumentObject, page: PdfPageObject, options?: PdfRenderThumbnailOptions): PdfTask<ImageDataLike>;
     renderPageAnnotationRaw(doc: PdfDocumentObject, page: PdfPageObject, annotation: PdfAnnotationObject, options?: PdfRenderPageAnnotationOptions): PdfTask<ImageDataLike>;
+    renderPageAnnotationsRaw(doc: PdfDocumentObject, page: PdfPageObject, options?: PdfRenderPageAnnotationOptions): PdfTask<AnnotationAppearanceMap<ImageDataLike>>;
     getPageAnnotationsRaw(doc: PdfDocumentObject, page: PdfPageObject): PdfTask<PdfAnnotationObject[]>;
     getPageAnnotations(doc: PdfDocumentObject, page: PdfPageObject): PdfTask<PdfAnnotationObject[]>;
     createPageAnnotation<A extends PdfAnnotationObject>(doc: PdfDocumentObject, page: PdfPageObject, annotation: A, context?: AnnotationCreateContext<A>): PdfTask<string>;
-    updatePageAnnotation(doc: PdfDocumentObject, page: PdfPageObject, annotation: PdfAnnotationObject): PdfTask<boolean>;
+    updatePageAnnotation(doc: PdfDocumentObject, page: PdfPageObject, annotation: PdfAnnotationObject, options?: {
+        regenerateAppearance?: boolean;
+    }): PdfTask<boolean>;
     removePageAnnotation(doc: PdfDocumentObject, page: PdfPageObject, annotation: PdfAnnotationObject): PdfTask<boolean>;
     getPageTextRects(doc: PdfDocumentObject, page: PdfPageObject): PdfTask<PdfTextRectObject[]>;
     searchInPage(doc: PdfDocumentObject, page: PdfPageObject, keyword: string, flags: number): PdfTask<SearchResult[]>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@embedpdf/models",
-  "version": "2.6.1",
+  "version": "2.7.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",