@libpdf/core 0.0.1-beta.1 → 0.0.1-beta.4

package/dist/index.d.mts

@@ -1,4 +1,6 @@
 import { z } from "zod";
+import * as _google_cloud_kms0 from "@google-cloud/kms";
+import * as _google_cloud_secret_manager0 from "@google-cloud/secret-manager";
 
 //#region package.d.ts
 declare let version: string;
@@ -2495,6 +2497,12 @@ interface LtvValidationData {
   crls: Uint8Array[];
   /** Timestamp when validation data was gathered */
   timestamp: Date;
+  /**
+   * Embedded timestamp tokens (for VRI entries).
+   * Each timestamp token embedded in the signature's unsigned attributes
+   * needs its own VRI entry per ETSI EN 319 142-2.
+   */
+  embeddedTimestamps?: Uint8Array[];
 }
 /**
  * Result of signing operation.
@@ -2565,6 +2573,14 @@ declare class PlaceholderError extends SignatureError {
   readonly availableSize: number;
   constructor(requiredSize: number, availableSize: number);
 }
+/**
+ * Error with KMS signer (e.g., key issues, permission denied, unsupported algorithm).
+ */
+declare class KmsSignerError extends SignerError {
+  /** The original error that caused this error (if any) */
+  readonly cause?: Error;
+  constructor(message: string, cause?: Error);
+}
 //#endregion
 //#region src/text/types.d.ts
 /**
@@ -3002,181 +3018,1312 @@ declare class PDFPageTree {
    * @param toIndex The target page index
    * @throws {RangeError} if either index is out of bounds
    */
-  movePage(fromIndex: number, toIndex: number): void;
+  movePage(fromIndex: number, toIndex: number): void;
+}
+//#endregion
+//#region src/api/pdf-context.d.ts
+/**
+ * Function type for resolving embedded font references.
+ * Synchronous because refs are pre-allocated when fonts are embedded.
+ */
+type FontRefResolver = (font: EmbeddedFont) => PdfRef;
+/**
+ * Document metadata stored in the context.
+ */
+interface DocumentInfo {
+  /** PDF version (e.g., "1.7", "2.0") */
+  version: string;
+  /** Whether the document is encrypted */
+  isEncrypted: boolean;
+  /** Whether authentication succeeded */
+  isAuthenticated: boolean;
+  /** Trailer dictionary */
+  trailer: PdfDict;
+  /** Security handler (if encrypted) */
+  securityHandler: StandardSecurityHandler | null;
+}
+/**
+ * Central context for PDF document operations.
+ *
+ * Encapsulates all the shared state and services that subsystems need:
+ * - Object registry for tracking and resolving objects
+ * - Catalog for document-level structures
+ * - Page tree for page access
+ * - Document info (version, encryption status, trailer)
+ */
+declare class PDFContext {
+  /** Object registry for tracking refs and objects */
+  readonly registry: ObjectRegistry;
+  /** Document catalog wrapper */
+  readonly catalog: PDFCatalog;
+  /** Page tree for page access and manipulation */
+  readonly pages: PDFPageTree;
+  /** Document metadata */
+  readonly info: DocumentInfo;
+  /** Font reference resolver (set by PDF class) */
+  private fontRefResolver;
+  constructor(registry: ObjectRegistry, catalog: PDFCatalog, pages: PDFPageTree, info: DocumentInfo);
+  /**
+   * Set the font reference resolver.
+   * @internal Called by PDF class to wire up font resolution.
+   */
+  setFontRefResolver(resolver: FontRefResolver): void;
+  /**
+   * Get a font reference for an embedded font.
+   *
+   * The reference is available immediately because refs are pre-allocated
+   * when fonts are embedded. Actual font objects are created at save time.
+   */
+  getFontRef(font: EmbeddedFont): PdfRef;
+  /**
+   * Register a new object, assigning it a reference.
+   */
+  register(obj: PdfObject): PdfRef;
+  /**
+   * Resolve an object by reference (async, fetches if needed).
+   */
+  resolve(ref: PdfRef): Promise<PdfObject | null>;
+  /**
+   * Get an object by reference (sync, only if already loaded).
+   */
+  getObject(ref: PdfRef): PdfObject | null;
+  /**
+   * Get the reference for an object.
+   */
+  getRef(obj: PdfObject): PdfRef | null;
+  /**
+   * Add a warning message.
+   */
+  addWarning(message: string): void;
+  /**
+   * Get all warnings.
+   */
+  get warnings(): string[];
+}
+//#endregion
+//#region src/api/pdf-attachments.d.ts
+/**
+ * PDFAttachments manages file attachments for a PDF document.
+ */
+declare class PDFAttachments {
+  /** PDF context */
+  private readonly ctx;
+  constructor(ctx: PDFContext);
+  /**
+   * List all attachments in the document.
+   *
+   * @returns Map of attachment name to attachment info
+   *
+   * @example
+   * ```typescript
+   * const attachments = await pdf.attachments.list();
+   * for (const [name, info] of attachments) {
+   *   console.log(`${name}: ${info.size} bytes`);
+   * }
+   * ```
+   */
+  list(): Promise<Map<string, AttachmentInfo>>;
+  /**
+   * Get the raw bytes of an attachment.
+   *
+   * @param name - The attachment name (key in the EmbeddedFiles tree)
+   * @returns The attachment bytes, or null if not found
+   *
+   * @example
+   * ```typescript
+   * const data = await pdf.attachments.get("document.txt");
+   * if (data) {
+   *   const text = new TextDecoder().decode(data);
+   *   console.log(text);
+   * }
+   * ```
+   */
+  get(name: string): Promise<Uint8Array | null>;
+  /**
+   * Check if an attachment exists.
+   *
+   * @param name - The attachment name
+   * @returns True if the attachment exists
+   *
+   * @example
+   * ```typescript
+   * if (await pdf.attachments.has("report.pdf")) {
+   *   const data = await pdf.attachments.get("report.pdf");
+   * }
+   * ```
+   */
+  has(name: string): Promise<boolean>;
+  /**
+   * Add a file attachment to the document.
+   *
+   * @param name - The attachment name (key in the EmbeddedFiles tree)
+   * @param data - The file data
+   * @param options - Attachment options (description, MIME type, dates)
+   * @throws {Error} if name already exists and overwrite !== true
+   *
+   * @example
+   * ```typescript
+   * // Add with auto-detected MIME type
+   * await pdf.attachments.add("report.pdf", pdfBytes);
+   *
+   * // Add with explicit options
+   * await pdf.attachments.add("data.json", jsonBytes, {
+   *   description: "Configuration data",
+   *   mimeType: "application/json",
+   * });
+   *
+   * // Replace existing attachment
+   * await pdf.attachments.add("report.pdf", newBytes, { overwrite: true });
+   * ```
+   */
+  add(name: string, data: Uint8Array, options?: AddAttachmentOptions): Promise<void>;
+  /**
+   * Remove an attachment from the document.
+   *
+   * @param name - The attachment name
+   * @returns True if the attachment was removed, false if not found
+   *
+   * @example
+   * ```typescript
+   * const removed = await pdf.attachments.remove("old-file.txt");
+   * if (removed) {
+   *   console.log("Attachment removed");
+   * }
+   * ```
+   */
+  remove(name: string): Promise<boolean>;
+}
+//#endregion
+//#region src/helpers/colors.d.ts
+/**
+ * Color types and helper functions for form fields.
+ *
+ * Provides RGB, Grayscale, and CMYK color types for use with form field styling.
+ */
+/**
+ * RGB color with values in the 0-1 range.
+ */
+interface RGB {
+  type: "RGB";
+  red: number;
+  green: number;
+  blue: number;
+}
+/**
+ * Grayscale color with value in the 0-1 range.
+ * 0 = black, 1 = white.
+ */
+interface Grayscale {
+  type: "Grayscale";
+  gray: number;
+}
+/**
+ * CMYK color with values in the 0-1 range.
+ */
+interface CMYK {
+  type: "CMYK";
+  cyan: number;
+  magenta: number;
+  yellow: number;
+  black: number;
+}
+/**
+ * Union type for all supported color types.
+ */
+type Color = RGB | Grayscale | CMYK;
+/**
+ * Create an RGB color.
+ *
+ * @param r Red component (0-1)
+ * @param g Green component (0-1)
+ * @param b Blue component (0-1)
+ * @returns RGB color object
+ *
+ * @example
+ * ```typescript
+ * const red = rgb(1, 0, 0);
+ * const gray50 = rgb(0.5, 0.5, 0.5);
+ * const cream = rgb(1, 1, 0.9);
+ * ```
+ */
+declare function rgb(r: number, g: number, b: number): RGB;
+/**
+ * Create a grayscale color.
+ *
+ * @param gray Gray value (0 = black, 1 = white)
+ * @returns Grayscale color object
+ *
+ * @example
+ * ```typescript
+ * const black = grayscale(0);
+ * const white = grayscale(1);
+ * const midGray = grayscale(0.5);
+ * ```
+ */
+declare function grayscale(gray: number): Grayscale;
+/**
+ * Create a CMYK color.
+ *
+ * @param c Cyan component (0-1)
+ * @param m Magenta component (0-1)
+ * @param y Yellow component (0-1)
+ * @param k Black component (0-1)
+ * @returns CMYK color object
+ *
+ * @example
+ * ```typescript
+ * const black = cmyk(0, 0, 0, 1);
+ * const cyan = cmyk(1, 0, 0, 0);
+ * ```
+ */
+declare function cmyk(c: number, m: number, y: number, k: number): CMYK;
+/** Black color (grayscale 0) */
+declare const black: Grayscale;
+/** White color (grayscale 1) */
+declare const white: Grayscale;
+/** Red color (RGB) */
+declare const red: RGB;
+/** Green color (RGB) */
+declare const green: RGB;
+/** Blue color (RGB) */
+declare const blue: RGB;
+//#endregion
+//#region src/annotations/types.d.ts
+/**
+ * Annotation subtype values as defined in PDF spec Table 169.
+ */
+type AnnotationSubtype = "Text" | "Link" | "FreeText" | "Line" | "Square" | "Circle" | "Polygon" | "PolyLine" | "Highlight" | "Underline" | "Squiggly" | "StrikeOut" | "Stamp" | "Caret" | "Ink" | "Popup" | "FileAttachment" | "Widget";
+/**
+ * Annotation flags (PDF spec Table 165).
+ */
+declare enum AnnotationFlags {
+  /** Don't display unknown types */
+  Invisible = 1,
+  /** Don't display or print */
+  Hidden = 2,
+  /** Print when page is printed */
+  Print = 4,
+  /** Don't scale with page zoom */
+  NoZoom = 8,
+  /** Don't rotate with page */
+  NoRotate = 16,
+  /** Don't display on screen */
+  NoView = 32,
+  /** Don't allow interaction */
+  ReadOnly = 64,
+  /** Don't allow deletion/modification */
+  Locked = 128,
+  /** Invert NoView for certain events */
+  ToggleNoView = 256,
+  /** Don't allow content modification */
+  LockedContents = 512,
+}
+/**
+ * A rectangle defined by x, y (bottom-left origin), width, and height.
+ */
+interface Rect {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+}
+/**
+ * A point in 2D space.
+ */
+interface Point {
+  x: number;
+  y: number;
+}
+/**
+ * Border style types.
+ */
+type BorderStyleType = "solid" | "dashed" | "beveled" | "inset" | "underline";
+/**
+ * Border style configuration.
+ */
+interface BorderStyle {
+  /** Border width in points (default: 1) */
+  width?: number;
+  /** Border style (default: "solid") */
+  style?: BorderStyleType;
+  /** Dash array for dashed style (default: [3]) */
+  dashArray?: number[];
+}
+/**
+ * Line ending styles (PDF spec Table 176).
+ */
+type LineEndingStyle = "None" | "Square" | "Circle" | "Diamond" | "OpenArrow" | "ClosedArrow" | "Butt" | "ROpenArrow" | "RClosedArrow" | "Slash";
+/**
+ * Text annotation icon names (PDF spec Table 172).
+ */
+type TextAnnotationIcon = "Comment" | "Key" | "Note" | "Help" | "NewParagraph" | "Paragraph" | "Insert";
+/**
+ * Stamp annotation standard names (PDF spec Table 181).
+ */
+type StampName = "Approved" | "Experimental" | "NotApproved" | "AsIs" | "Expired" | "NotForPublicRelease" | "Confidential" | "Final" | "Sold" | "Departmental" | "ForComment" | "TopSecret" | "Draft" | "ForPublicRelease";
+/**
+ * File attachment icon names.
+ */
+type FileAttachmentIcon = "Graph" | "Paperclip" | "PushPin" | "Tag";
+/**
+ * Options for creating a Text annotation (sticky note).
+ */
+interface TextAnnotationOptions {
+  /** Annotation rectangle */
+  rect: Rect;
+  /** Text content */
+  contents?: string;
+  /** Author/title */
+  title?: string;
+  /** Background color */
+  color?: Color;
+  /** Icon to display */
+  icon?: TextAnnotationIcon;
+  /** Whether the popup is initially open */
+  open?: boolean;
+}
+/**
+ * Options for creating a text markup annotation (Highlight, Underline, StrikeOut, Squiggly).
+ */
+interface TextMarkupAnnotationOptions {
+  /** Single rectangle for simple horizontal text */
+  rect?: Rect;
+  /** Multiple rectangles for multi-line selections */
+  rects?: Rect[];
+  /** Raw quadPoints for rotated/skewed text (advanced) */
+  quadPoints?: number[][];
+  /** Annotation color */
+  color?: Color;
+  /** Opacity (0-1, default: 1) */
+  opacity?: number;
+  /** Text content/comment */
+  contents?: string;
+  /** Author/title */
+  title?: string;
+}
+/**
+ * Destination types for links.
+ */
+type DestinationType = "Fit" | "FitH" | "FitV" | "FitB" | "FitBH" | "FitBV" | "XYZ" | "FitR";
+/**
+ * A link destination.
+ *
+ * For internal destinations, the page is typically a page reference.
+ * For remote destinations (GoToR), the page can be a 0-based page index.
+ */
+interface LinkDestination {
+  /**
+   * Target page for the destination.
+   *
+   * - Internal `GoTo` destinations: a `PdfRef` to a page object.
+   * - Remote `GoToR` destinations: a 0-based page index (`number`).
+   */
+  page: PdfRef | number;
+  /** Destination type */
+  type: DestinationType;
+  /** Top coordinate for FitH, FitBH, XYZ */
+  top?: number;
+  /** Left coordinate for FitV, FitBV, XYZ */
+  left?: number;
+  /** Zoom level for XYZ (null means no change) */
+  zoom?: number | null;
+  /** Bounds for FitR: [left, bottom, right, top] */
+  rect?: [number, number, number, number];
+}
+/**
+ * A link destination for internal links created in this document.
+ */
+type InternalLinkDestination = Omit<LinkDestination, "page"> & {
+  /** Target page in the current document. */
+  page: PdfRef | PDFPage;
+};
+/**
+ * Options for creating a Link annotation.
+ */
+interface LinkAnnotationOptions {
+  /** Annotation rectangle */
+  rect: Rect;
+  /** External URI */
+  uri?: string;
+  /**
+   * Internal destination within this document.
+   *
+   * Pass a `PDFPage` (recommended) or a `PdfRef` to the target page.
+   */
+  destination?: InternalLinkDestination;
+  /** Border width (default: 0 for invisible border) */
+  borderWidth?: number;
+  /** Border color */
+  borderColor?: Color;
+}
+/**
+ * Options for creating a FreeText annotation.
+ */
+interface FreeTextAnnotationOptions {
+  /** Annotation rectangle */
+  rect: Rect;
+  /** Text content */
+  contents: string;
+  /** Font size (default: 12) */
+  fontSize?: number;
+  /** Text color (default: black) */
+  color?: Color;
+  /** Background color */
+  backgroundColor?: Color;
+  /** Border color */
+  borderColor?: Color;
+  /** Border width */
+  borderWidth?: number;
+  /** Text alignment: 0=left, 1=center, 2=right */
+  justification?: 0 | 1 | 2;
+}
+/**
+ * Options for creating a Line annotation.
+ */
+interface LineAnnotationOptions {
+  /** Start point */
+  start: Point;
+  /** End point */
+  end: Point;
+  /** Line color */
+  color?: Color;
+  /** Line width (default: 1) */
+  width?: number;
+  /** Line ending style at start */
+  startStyle?: LineEndingStyle;
+  /** Line ending style at end */
+  endStyle?: LineEndingStyle;
+  /** Fill color for closed arrows */
+  interiorColor?: Color;
+  /** Text content/comment */
+  contents?: string;
+}
+/**
+ * Options for creating a Square annotation.
+ */
+interface SquareAnnotationOptions {
+  /** Annotation rectangle */
+  rect: Rect;
+  /** Stroke color */
+  color?: Color;
+  /** Fill color */
+  fillColor?: Color;
+  /** Border width (default: 1) */
+  borderWidth?: number;
+  /** Text content/comment */
+  contents?: string;
+}
+/**
+ * Options for creating a Circle annotation.
+ */
+interface CircleAnnotationOptions {
+  /** Annotation rectangle (bounding box of ellipse) */
+  rect: Rect;
+  /** Stroke color */
+  color?: Color;
+  /** Fill color */
+  fillColor?: Color;
+  /** Border width (default: 1) */
+  borderWidth?: number;
+  /** Text content/comment */
+  contents?: string;
+}
+/**
+ * Options for creating a Polygon annotation.
+ */
+interface PolygonAnnotationOptions {
+  /** Vertices of the polygon */
+  vertices: Point[];
+  /** Stroke color */
+  color?: Color;
+  /** Fill color */
+  fillColor?: Color;
+  /** Border width (default: 1) */
+  borderWidth?: number;
+  /** Text content/comment */
+  contents?: string;
+}
+/**
+ * Options for creating a PolyLine annotation.
+ */
+interface PolylineAnnotationOptions {
+  /** Vertices of the polyline */
+  vertices: Point[];
+  /** Line color */
+  color?: Color;
+  /** Line width (default: 1) */
+  width?: number;
+  /** Line ending style at start */
+  startStyle?: LineEndingStyle;
+  /** Line ending style at end */
+  endStyle?: LineEndingStyle;
+  /** Text content/comment */
+  contents?: string;
+}
+/**
+ * Options for creating a Stamp annotation.
+ */
+interface StampAnnotationOptions {
+  /** Annotation rectangle */
+  rect: Rect;
+  /** Standard stamp name */
+  name?: StampName | string;
+  /** Text content/comment */
+  contents?: string;
+}
+/**
+ * Options for creating an Ink annotation.
+ */
+interface InkAnnotationOptions {
+  /** Paths (array of point arrays) */
+  paths: Point[][];
+  /** Stroke color */
+  color?: Color;
+  /** Stroke width (default: 1) */
+  width?: number;
+  /** Text content/comment */
+  contents?: string;
+}
+/**
+ * Options for creating a Caret annotation.
+ */
+interface CaretAnnotationOptions {
+  /** Annotation rectangle */
+  rect: Rect;
+  /** Symbol: "P" for paragraph, "None" */
+  symbol?: "P" | "None";
+  /** Text content/comment */
+  contents?: string;
+  /** Annotation color */
+  color?: Color;
+}
+/**
+ * Options for creating a Popup annotation (linked to another annotation).
+ */
+interface PopupOptions {
+  /** Popup rectangle */
+  rect: Rect;
+  /** Initially open */
+  open?: boolean;
+}
+/**
+ * Options for removing annotations.
+ */
+interface RemoveAnnotationsOptions {
+  /** Filter by annotation type */
+  type?: AnnotationSubtype;
+}
+/**
+ * Options for flattening annotations.
+ */
+interface FlattenAnnotationsOptions {
+  /** Annotation types to exclude from flattening */
+  exclude?: AnnotationSubtype[];
+}
+//#endregion
+//#region src/annotations/base.d.ts
+/**
+ * Base class for PDF annotations.
+ */
+declare class PDFAnnotation {
+  /** The underlying annotation dictionary */
+  readonly dict: PdfDict;
+  /** Reference to this annotation object */
+  readonly ref: PdfRef | null;
+  /** Object registry for change tracking */
+  protected readonly registry: ObjectRegistry;
+  /** Track if annotation has been modified */
+  private _modified;
+  constructor(dict: PdfDict, ref: PdfRef | null, registry: ObjectRegistry);
+  /**
+   * Annotation subtype (e.g., "Text", "Highlight", "Link").
+   */
+  get type(): AnnotationSubtype;
+  /**
+   * Annotation rectangle in page coordinates.
+   */
+  get rect(): Rect;
+  /**
+   * Set the annotation rectangle.
+   */
+  setRect(rect: Rect): void;
+  /**
+   * Text content or description of the annotation.
+   */
+  get contents(): string | null;
+  /**
+   * Set the annotation contents.
+   */
+  setContents(contents: string): void;
+  /**
+   * Annotation name (unique identifier within page).
+   */
+  get name(): string | null;
+  /**
+   * Set the annotation name.
+   */
+  setName(name: string): void;
+  /**
+   * Modification date.
+   */
+  get modificationDate(): string | null;
+  /**
+   * Set the modification date (PDF date format).
+   */
+  setModificationDate(date: string): void;
+  /**
+   * Annotation flags.
+   */
+  get flags(): number;
+  /**
+   * Check if the annotation has a specific flag set.
+   */
+  hasFlag(flag: AnnotationFlags): boolean;
+  /**
+   * Set or clear a specific flag.
+   */
+  setFlag(flag: AnnotationFlags, value: boolean): void;
+  /**
+   * Whether the annotation is hidden.
+   */
+  get isHidden(): boolean;
+  /**
+   * Set whether the annotation is hidden.
+   */
+  setHidden(hidden: boolean): void;
+  /**
+   * Whether the annotation is printable.
+   */
+  get isPrintable(): boolean;
+  /**
+   * Set whether the annotation is printable.
+   */
+  setPrintable(printable: boolean): void;
+  /**
+   * Annotation color.
+   */
+  get color(): Color | null;
+  /**
+   * Set the annotation color.
+   */
+  setColor(color: Color): void;
+  /**
+   * Get the border style.
+   */
+  getBorderStyle(): BorderStyle | null;
+  /**
+   * Set the border style.
+   */
+  setBorderStyle(style: BorderStyle): void;
+  /**
+   * Check if the annotation has a normal appearance stream.
+   */
+  hasNormalAppearance(): boolean;
+  /**
+   * Get the normal appearance stream.
+   */
+  getNormalAppearance(): Promise<PdfStream | null>;
+  /**
+   * Get the rollover appearance stream.
+   */
+  getRolloverAppearance(): Promise<PdfStream | null>;
+  /**
+   * Get the down appearance stream.
+   */
+  getDownAppearance(): Promise<PdfStream | null>;
+  /**
+   * Set the normal appearance stream.
+   */
+  setNormalAppearance(stream: PdfStream): void;
+  /**
+   * Set the rollover appearance stream.
+   */
+  setRolloverAppearance(stream: PdfStream): void;
+  /**
+   * Set the down appearance stream.
+   */
+  setDownAppearance(stream: PdfStream): void;
+  /**
+   * Get an appearance stream by type.
+   */
+  private getAppearance;
+  /**
+   * Set an appearance stream by type.
+   */
+  private setAppearance;
+  /**
+   * Mark the annotation as modified.
+   * Called automatically by setters.
+   * Note: The dict's dirty flag is set automatically by PdfDict operations.
+   */
+  protected markModified(): void;
+  /**
+   * Check if the annotation has been modified.
+   */
+  get isModified(): boolean;
+}
+//#endregion
+//#region src/annotations/popup.d.ts
+/**
+ * Popup annotation - displays text in a pop-up window.
+ */
+declare class PDFPopupAnnotation extends PDFAnnotation {
+  /**
+   * Reference to the parent annotation that this popup is associated with.
+   */
+  get parentRef(): PdfRef | null;
+  /**
+   * Whether the popup is initially open.
+   */
+  get isOpen(): boolean;
+  /**
+   * Set whether the popup is open.
+   */
+  setOpen(open: boolean): void;
+}
+//#endregion
+//#region src/annotations/markup.d.ts
+/**
+ * Base class for markup annotations.
+ */
+declare class PDFMarkupAnnotation extends PDFAnnotation {
+  /** Cached popup annotation */
+  private _popup;
+  /**
+   * Text label for the annotation (often the author name).
+   */
+  get title(): string | null;
+  /**
+   * Set the title/author.
+   */
+  setTitle(title: string): void;
+  /**
+   * Opacity (CA) - constant opacity value for the annotation.
+   * Range 0-1, where 0 is fully transparent and 1 is fully opaque.
+   */
+  get opacity(): number;
+  /**
+   * Set the opacity.
+   */
+  setOpacity(opacity: number): void;
+  /**
+   * Creation date (CreationDate).
+   */
+  get creationDate(): string | null;
+  /**
+   * Set the creation date.
+   */
+  setCreationDate(date: string): void;
+  /**
+   * Subject - the subject of the annotation.
+   */
+  get subject(): string | null;
+  /**
+   * Set the subject.
+   */
+  setSubject(subject: string): void;
+  /**
+   * Reference to an associated popup annotation.
+   */
+  get popupRef(): PdfRef | null;
+  /**
+   * Get the associated popup annotation, if any.
+   */
+  getPopup(): Promise<PDFPopupAnnotation | null>;
+  /**
+   * Create a popup annotation associated with this annotation.
+   * The popup is added to the parent annotation and registered.
+   */
+  createPopup(options: PopupOptions): PDFPopupAnnotation;
+  /**
+   * Get the reply-to annotation reference (for replies).
+   */
+  get inReplyToRef(): PdfRef | null;
+  /**
+   * Intent (IT) - the intent of the markup annotation.
+   */
+  get intent(): string | null;
+}
+//#endregion
+//#region src/annotations/caret.d.ts
+/**
+ * Caret symbol types.
+ */
+type CaretSymbol = "P" | "None";
+/**
+ * Caret annotation - insertion point marker.
+ */
+declare class PDFCaretAnnotation extends PDFMarkupAnnotation {
+  /**
+   * Symbol to display.
+   * "P" = paragraph symbol, "None" = no symbol.
+   */
+  get symbol(): CaretSymbol;
+  /**
+   * Set the symbol.
+   */
+  setSymbol(symbol: CaretSymbol): void;
+}
+//#endregion
+//#region src/annotations/file-attachment.d.ts
+/**
+ * File attachment annotation - embedded file icon.
+ */
+declare class PDFFileAttachmentAnnotation extends PDFMarkupAnnotation {
+  /**
+   * Icon to display.
+   */
+  get icon(): FileAttachmentIcon;
+  /**
+   * Set the icon.
+   */
+  setIcon(icon: FileAttachmentIcon): void;
+  /**
+   * Reference to the file specification.
+   */
+  get fileSpecRef(): PdfRef | null;
+  /**
+   * Get the file specification dictionary.
+   */
+  getFileSpec(): Promise<PdfDict | null>;
+  /**
+   * Get the file name from the file specification.
+   */
+  getFileName(): Promise<string | null>;
+}
+//#endregion
+//#region src/annotations/free-text.d.ts
+/**
+ * Text justification for FreeText annotations.
+ */
+type FreeTextJustification = "left" | "center" | "right";
+/**
+ * FreeText annotation - text box displayed on page.
+ */
+declare class PDFFreeTextAnnotation extends PDFMarkupAnnotation {
+  /**
+   * Default appearance string (DA).
+   * Contains font and color operators.
+   */
+  get defaultAppearance(): string | null;
+  /**
+   * Set the default appearance.
+   */
+  setDefaultAppearance(da: string): void;
+  /**
+   * Text justification: 0=left, 1=center, 2=right.
+   */
+  get justification(): FreeTextJustification;
+  /**
+   * Set the text justification.
+   */
+  setJustification(justification: FreeTextJustification): void;
+  /**
+   * Default style string (DS).
+   * Contains CSS-style formatting.
+   */
+  get defaultStyle(): string | null;
+  /**
+   * Set the default style.
+   */
+  setDefaultStyle(ds: string): void;
+  /**
+   * Intent (IT) - specific to FreeText annotations.
+   * Can be "FreeText", "FreeTextCallout", or "FreeTextTypeWriter".
+   */
+  get freeTextIntent(): string | null;
+  /**
+   * Set the intent.
+   */
+  setFreeTextIntent(intent: "FreeText" | "FreeTextCallout" | "FreeTextTypeWriter"): void;
+}
+//#endregion
+//#region src/annotations/ink.d.ts
+/**
+ * Ink annotation - freehand drawing.
+ */
+declare class PDFInkAnnotation extends PDFMarkupAnnotation {
+  /**
+   * Create a new ink annotation dictionary.
+   */
+  static create(options: InkAnnotationOptions): PdfDict;
+  /**
+   * Get the ink paths.
+   * Each path is an array of points.
+   */
+  get inkPaths(): Point[][];
+  /**
+   * Set the ink paths.
+   */
+  setInkPaths(paths: Point[][]): void;
+  /**
+   * Stroke width from border style.
+   */
+  get strokeWidth(): number;
+}
+//#endregion
+//#region src/annotations/line.d.ts
+/**
+ * Line annotation - a line with optional arrow endings.
+ */
+declare class PDFLineAnnotation extends PDFMarkupAnnotation {
+  /**
+   * Create a new line annotation dictionary.
+   */
+  static create(options: LineAnnotationOptions): PdfDict;
+  /**
+   * Get the line endpoints.
+   */
+  get lineEndpoints(): {
+    start: Point;
+    end: Point;
+  };
+  /**
+   * Set the line endpoints.
+   */
+  setLineEndpoints(start: Point, end: Point): void;
+  /**
+   * Get the start point.
+   */
+  get start(): Point;
+  /**
+   * Get the end point.
+   */
+  get end(): Point;
+  /**
+   * Line ending styles [start, end].
+   */
+  get lineEndingStyles(): [LineEndingStyle, LineEndingStyle];
+  /**
+   * Set the line ending styles.
+   */
+  setLineEndingStyles(startStyle: LineEndingStyle, endStyle: LineEndingStyle): void;
+  /**
+   * Interior color (fill color for closed arrow heads).
+   */
+  get interiorColor(): Color | null;
+  /**
+   * Set the interior color.
+   */
+  setInteriorColor(color: Color): void;
+  /**
+   * Line leader length (for dimension lines).
+   */
+  get leaderLength(): number;
+  /**
+   * Line leader line extension.
+   */
+  get leaderExtension(): number;
+  /**
+   * Caption flag - whether to show caption with the line.
+   */
+  get hasCaption(): boolean;
+  /**
+   * Line width from border style.
+   */
+  get lineWidth(): number;
+}
+//#endregion
+//#region src/annotations/link.d.ts
+/**
+ * Parsed link action.
+ */
+type LinkAction = {
+  type: "uri";
+  uri: string;
+} | {
+  type: "goto";
+  destination: LinkDestination;
+} | {
+  type: "gotoRemote";
+  file: string;
+  destination: LinkDestination | null;
+} | null;
+/**
+ * Highlight mode for link annotations.
+ */
+type HighlightMode = "None" | "Invert" | "Outline" | "Push";
+/**
+ * Link annotation - hyperlinks and internal navigation.
+ */
+declare class PDFLinkAnnotation extends PDFAnnotation {
+  /**
+   * Create a new link annotation dictionary.
+   */
+  static create(options: LinkAnnotationOptions): PdfDict;
+  /**
+   * Get the URI if this is an external link.
+   */
+  get uri(): string | null;
+  /**
+   * Get the destination if this is an internal link.
+   */
+  get destination(): LinkDestination | null;
+  /**
+   * Get the parsed link action.
+   */
+  getAction(): Promise<LinkAction>;
+  /**
+   * Highlight mode when the link is clicked.
+   */
+  get highlightMode(): HighlightMode;
+  /**
+   * Parse a destination value.
+   */
+  private parseDestination;
+}
+//#endregion
+//#region src/annotations/polygon.d.ts
+/**
+ * Base class for Polygon and Polyline annotations.
+ */
+declare abstract class PDFPolyAnnotation extends PDFMarkupAnnotation {
+  /**
+   * Get the vertices of the polygon/polyline.
+   */
+  get vertices(): Point[];
+  /**
+   * Set the vertices.
+   */
+  setVertices(vertices: Point[]): void;
+  /**
+   * Border width from border style.
+   */
+  get borderWidth(): number;
+}
+/**
+ * Polygon annotation - closed polygon shape.
+ */
+declare class PDFPolygonAnnotation extends PDFPolyAnnotation {
+  /**
+   * Interior color (fill color).
+   */
+  get interiorColor(): Color | null;
+  /**
+   * Set the interior color.
+   */
+  setInteriorColor(color: Color): void;
+  /**
+   * Intent - specific to polygon annotations.
+   * Can be "PolygonCloud" or "PolygonDimension".
+   */
+  get polygonIntent(): string | null;
+}
+/**
+ * Polyline annotation - open polyline shape.
+ */
+declare class PDFPolylineAnnotation extends PDFPolyAnnotation {
+  /**
+   * Line ending styles [start, end].
+   */
+  get lineEndingStyles(): [LineEndingStyle, LineEndingStyle];
+  /**
+   * Set the line ending styles.
+   */
+  setLineEndingStyles(startStyle: LineEndingStyle, endStyle: LineEndingStyle): void;
+  /**
+   * Intent - specific to polyline annotations.
+   * Can be "PolyLineDimension".
+   */
+  get polylineIntent(): string | null;
+}
+//#endregion
+//#region src/annotations/square-circle.d.ts
+/**
+ * Base class for square and circle annotations.
+ */
+declare abstract class PDFShapeAnnotation extends PDFMarkupAnnotation {
+  /**
+   * Interior color (fill color).
+   */
+  get interiorColor(): Color | null;
+  /**
+   * Set the interior color.
+   */
+  setInteriorColor(color: Color): void;
+  /**
+   * Rectangle difference (RD) - inset of the drawing from the Rect.
+   * [left, bottom, right, top] offsets.
+   */
+  get rectDifference(): [number, number, number, number] | null;
+  /**
+   * Get the actual drawing rectangle (Rect minus RD).
+   */
+  getDrawingRect(): Rect;
+  /**
+   * Border width from border style.
+   */
+  get borderWidth(): number;
+}
+/**
+ * Square annotation - rectangle shape.
+ */
+declare class PDFSquareAnnotation extends PDFShapeAnnotation {
+  /**
+   * Create a new square annotation dictionary.
+   */
+  static create(options: SquareAnnotationOptions): PdfDict;
+}
+/**
+ * Circle annotation - ellipse shape.
+ */
+declare class PDFCircleAnnotation extends PDFShapeAnnotation {
+  /**
+   * Create a new circle annotation dictionary.
+   */
+  static create(options: CircleAnnotationOptions): PdfDict;
+}
+//#endregion
+//#region src/annotations/stamp.d.ts
+/**
+ * Standard stamp names as defined in PDF spec.
+ */
+declare const STANDARD_STAMPS: StampName[];
+/**
+ * Stamp annotation - rubber stamp.
+ */
+declare class PDFStampAnnotation extends PDFMarkupAnnotation {
+  /**
+   * Create a new stamp annotation dictionary.
+   */
+  static create(options: StampAnnotationOptions): PdfDict;
+  /**
+   * Stamp name/type.
+   */
+  get stampName(): string;
+  /**
+   * Set the stamp name.
+   */
+  setStampName(name: StampName | string): void;
+  /**
+   * Check if this is a standard stamp.
+   */
+  isStandardStamp(): boolean;
 }
 //#endregion
-//#region src/api/pdf-context.d.ts
+//#region src/annotations/text.d.ts
 /**
- * Function type for resolving embedded font references.
- * Synchronous because refs are pre-allocated when fonts are embedded.
+ * Text annotation state (for review workflows).
  */
-type FontRefResolver = (font: EmbeddedFont) => PdfRef;
+type TextAnnotationState = "Marked" | "Unmarked" | "Accepted" | "Rejected" | "Cancelled" | "Completed" | "None";
 /**
- * Document metadata stored in the context.
+ * Text annotation state model.
  */
-interface DocumentInfo {
-  /** PDF version (e.g., "1.7", "2.0") */
-  version: string;
-  /** Whether the document is encrypted */
-  isEncrypted: boolean;
-  /** Whether authentication succeeded */
-  isAuthenticated: boolean;
-  /** Trailer dictionary */
-  trailer: PdfDict;
-  /** Security handler (if encrypted) */
-  securityHandler: StandardSecurityHandler | null;
-}
+type TextAnnotationStateModel = "Marked" | "Review";
 /**
- * Central context for PDF document operations.
- *
- * Encapsulates all the shared state and services that subsystems need:
- * - Object registry for tracking and resolving objects
- * - Catalog for document-level structures
- * - Page tree for page access
- * - Document info (version, encryption status, trailer)
+ * Text annotation - sticky note/comment.
  */
-declare class PDFContext {
-  /** Object registry for tracking refs and objects */
-  readonly registry: ObjectRegistry;
-  /** Document catalog wrapper */
-  readonly catalog: PDFCatalog;
-  /** Page tree for page access and manipulation */
-  readonly pages: PDFPageTree;
-  /** Document metadata */
-  readonly info: DocumentInfo;
-  /** Font reference resolver (set by PDF class) */
-  private fontRefResolver;
-  constructor(registry: ObjectRegistry, catalog: PDFCatalog, pages: PDFPageTree, info: DocumentInfo);
+declare class PDFTextAnnotation extends PDFMarkupAnnotation {
   /**
-   * Set the font reference resolver.
-   * @internal Called by PDF class to wire up font resolution.
+   * Create a new text annotation dictionary.
    */
-  setFontRefResolver(resolver: FontRefResolver): void;
+  static create(options: TextAnnotationOptions): PdfDict;
   /**
-   * Get a font reference for an embedded font.
-   *
-   * The reference is available immediately because refs are pre-allocated
-   * when fonts are embedded. Actual font objects are created at save time.
+   * Whether the annotation popup is initially open.
    */
-  getFontRef(font: EmbeddedFont): PdfRef;
+  get isOpen(): boolean;
   /**
-   * Register a new object, assigning it a reference.
+   * Set whether the popup is initially open.
    */
-  register(obj: PdfObject): PdfRef;
+  setOpen(open: boolean): void;
   /**
-   * Resolve an object by reference (async, fetches if needed).
+   * Icon name to display.
    */
-  resolve(ref: PdfRef): Promise<PdfObject | null>;
+  get icon(): TextAnnotationIcon;
   /**
-   * Get an object by reference (sync, only if already loaded).
+   * Set the icon to display.
    */
-  getObject(ref: PdfRef): PdfObject | null;
+  setIcon(icon: TextAnnotationIcon): void;
   /**
-   * Get the reference for an object.
+   * State of the annotation (for review workflows).
    */
-  getRef(obj: PdfObject): PdfRef | null;
+  get state(): TextAnnotationState | null;
   /**
-   * Add a warning message.
+   * Set the annotation state.
    */
-  addWarning(message: string): void;
+  setState(state: TextAnnotationState): void;
   /**
-   * Get all warnings.
+   * State model for the annotation.
    */
-  get warnings(): string[];
+  get stateModel(): TextAnnotationStateModel | null;
+  /**
+   * Set the state model.
+   */
+  setStateModel(model: TextAnnotationStateModel): void;
 }
 //#endregion
-//#region src/api/pdf-attachments.d.ts
+//#region src/annotations/text-markup.d.ts
 /**
- * PDFAttachments manages file attachments for a PDF document.
+ * Base class for text markup annotations (Highlight, Underline, StrikeOut, Squiggly).
  */
-declare class PDFAttachments {
-  /** PDF context */
-  private readonly ctx;
-  constructor(ctx: PDFContext);
+declare abstract class PDFTextMarkupAnnotation extends PDFMarkupAnnotation {
   /**
-   * List all attachments in the document.
+   * Get the raw QuadPoints as an array of quads.
+   * Each quad is an array of 8 numbers [x1,y1, x2,y2, x3,y3, x4,y4].
    *
-   * @returns Map of attachment name to attachment info
-   *
-   * @example
-   * ```typescript
-   * const attachments = await pdf.attachments.list();
-   * for (const [name, info] of attachments) {
-   *   console.log(`${name}: ${info.size} bytes`);
-   * }
-   * ```
+   * PDF spec order is: top-left, top-right, bottom-left, bottom-right
+   * (counterclockwise from top-left of text baseline)
    */
-  list(): Promise<Map<string, AttachmentInfo>>;
+  get quadPoints(): number[][];
   /**
-   * Get the raw bytes of an attachment.
-   *
-   * @param name - The attachment name (key in the EmbeddedFiles tree)
-   * @returns The attachment bytes, or null if not found
-   *
-   * @example
-   * ```typescript
-   * const data = await pdf.attachments.get("document.txt");
-   * if (data) {
-   *   const text = new TextDecoder().decode(data);
-   *   console.log(text);
-   * }
-   * ```
+   * Set the QuadPoints.
    */
-  get(name: string): Promise<Uint8Array | null>;
+  setQuadPoints(quads: number[][]): void;
   /**
-   * Check if an attachment exists.
-   *
-   * @param name - The attachment name
-   * @returns True if the attachment exists
-   *
-   * @example
-   * ```typescript
-   * if (await pdf.attachments.has("report.pdf")) {
-   *   const data = await pdf.attachments.get("report.pdf");
-   * }
-   * ```
+   * Get the bounding box that encompasses all QuadPoints.
+   * This is a convenience method for simple use cases.
    */
-  has(name: string): Promise<boolean>;
+  getBounds(): Rect;
   /**
-   * Add a file attachment to the document.
-   *
-   * @param name - The attachment name (key in the EmbeddedFiles tree)
-   * @param data - The file data
-   * @param options - Attachment options (description, MIME type, dates)
-   * @throws {Error} if name already exists and overwrite !== true
-   *
-   * @example
-   * ```typescript
-   * // Add with auto-detected MIME type
-   * await pdf.attachments.add("report.pdf", pdfBytes);
-   *
-   * // Add with explicit options
-   * await pdf.attachments.add("data.json", jsonBytes, {
-   *   description: "Configuration data",
-   *   mimeType: "application/json",
-   * });
-   *
-   * // Replace existing attachment
-   * await pdf.attachments.add("report.pdf", newBytes, { overwrite: true });
-   * ```
+   * Update the Rect entry to encompass all QuadPoints.
    */
-  add(name: string, data: Uint8Array, options?: AddAttachmentOptions): Promise<void>;
+  private updateRectFromQuadPoints;
+}
+/**
+ * Highlight annotation - yellow highlighter effect on text.
+ */
+declare class PDFHighlightAnnotation extends PDFTextMarkupAnnotation {
   /**
-   * Remove an attachment from the document.
-   *
-   * @param name - The attachment name
-   * @returns True if the attachment was removed, false if not found
-   *
-   * @example
-   * ```typescript
-   * const removed = await pdf.attachments.remove("old-file.txt");
-   * if (removed) {
-   *   console.log("Attachment removed");
-   * }
-   * ```
+   * Create a new highlight annotation dictionary.
    */
-  remove(name: string): Promise<boolean>;
+  static create(options: TextMarkupAnnotationOptions): PdfDict;
+}
+/**
+ * Underline annotation - line under text.
+ */
+declare class PDFUnderlineAnnotation extends PDFTextMarkupAnnotation {
+  /**
+   * Create a new underline annotation dictionary.
+   */
+  static create(options: TextMarkupAnnotationOptions): PdfDict;
+}
+/**
+ * StrikeOut annotation - line through text.
+ */
+declare class PDFStrikeOutAnnotation extends PDFTextMarkupAnnotation {
+  /**
+   * Create a new strikeout annotation dictionary.
+   */
+  static create(options: TextMarkupAnnotationOptions): PdfDict;
 }
+/**
+ * Squiggly annotation - wavy underline.
+ */
+declare class PDFSquigglyAnnotation extends PDFTextMarkupAnnotation {
+  /**
+   * Create a new squiggly annotation dictionary.
+   */
+  static create(options: TextMarkupAnnotationOptions): PdfDict;
+}
+/**
+ * Convert a single rect to QuadPoints format.
+ * Assumes horizontal text.
+ */
+declare function rectToQuadPoints(rect: Rect): number[];
+/**
+ * Convert multiple rects to QuadPoints format.
+ */
+declare function rectsToQuadPoints(rects: Rect[]): number[][];
 //#endregion
 //#region src/fonts/encodings/encoding.d.ts
 /**
@@ -3418,7 +4565,7 @@ interface AppearanceCharacteristics {
 /**
  * Border style from /BS dictionary.
  */
-interface BorderStyle {
+interface BorderStyle$1 {
   /** Border width in points */
   width: number;
   /** Border style: S=solid, D=dashed, B=beveled, I=inset, U=underline */
@@ -3511,7 +4658,7 @@ declare class WidgetAnnotation {
   /**
    * Get border style.
    */
-  getBorderStyle(): BorderStyle | null;
+  getBorderStyle(): BorderStyle$1 | null;
   /**
    * Get appearance characteristics (/MK dictionary).
    */
@@ -4014,134 +5161,40 @@ declare class TextField extends TerminalField {
  * Width tables are stored by glyph name (like pdf.js) which works
  * with any encoding. Use getWidthByGlyphName() for lookup.
  *
- * Widths are in glyph units (1000 units = 1 em).
- *
- * Data extracted from pdf.js metrics.js (Mozilla, Apache 2.0 License)
- */
-/**
- * Standard 14 font names.
- */
-declare const STANDARD_14_FONTS: readonly ["Courier", "Courier-Bold", "Courier-Oblique", "Courier-BoldOblique", "Helvetica", "Helvetica-Bold", "Helvetica-Oblique", "Helvetica-BoldOblique", "Times-Roman", "Times-Bold", "Times-Italic", "Times-BoldItalic", "Symbol", "ZapfDingbats"];
-type Standard14FontName = (typeof STANDARD_14_FONTS)[number];
-/**
- * Standard 14 fonts enum for convenient access.
- *
- * @example
- * ```typescript
- * page.drawText("Hello", { font: StandardFonts.Helvetica });
- * page.drawText("Bold", { font: StandardFonts.HelveticaBold });
- * ```
- */
-declare const StandardFonts: {
-  readonly Helvetica: "Helvetica";
-  readonly HelveticaBold: "Helvetica-Bold";
-  readonly HelveticaOblique: "Helvetica-Oblique";
-  readonly HelveticaBoldOblique: "Helvetica-BoldOblique";
-  readonly TimesRoman: "Times-Roman";
-  readonly TimesBold: "Times-Bold";
-  readonly TimesItalic: "Times-Italic";
-  readonly TimesBoldItalic: "Times-BoldItalic";
-  readonly Courier: "Courier";
-  readonly CourierBold: "Courier-Bold";
-  readonly CourierOblique: "Courier-Oblique";
-  readonly CourierBoldOblique: "Courier-BoldOblique";
-  readonly Symbol: "Symbol";
-  readonly ZapfDingbats: "ZapfDingbats";
-};
-//#endregion
-//#region src/helpers/colors.d.ts
-/**
- * Color types and helper functions for form fields.
- *
- * Provides RGB, Grayscale, and CMYK color types for use with form field styling.
- */
-/**
- * RGB color with values in the 0-1 range.
- */
-interface RGB {
-  type: "RGB";
-  red: number;
-  green: number;
-  blue: number;
-}
-/**
- * Grayscale color with value in the 0-1 range.
- * 0 = black, 1 = white.
- */
-interface Grayscale {
-  type: "Grayscale";
-  gray: number;
-}
-/**
- * CMYK color with values in the 0-1 range.
- */
-interface CMYK {
-  type: "CMYK";
-  cyan: number;
-  magenta: number;
-  yellow: number;
-  black: number;
-}
-/**
- * Union type for all supported color types.
- */
-type Color = RGB | Grayscale | CMYK;
-/**
- * Create an RGB color.
- *
- * @param r Red component (0-1)
- * @param g Green component (0-1)
- * @param b Blue component (0-1)
- * @returns RGB color object
- *
- * @example
- * ```typescript
- * const red = rgb(1, 0, 0);
- * const gray50 = rgb(0.5, 0.5, 0.5);
- * const cream = rgb(1, 1, 0.9);
- * ```
- */
-declare function rgb(r: number, g: number, b: number): RGB;
-/**
- * Create a grayscale color.
- *
- * @param gray Gray value (0 = black, 1 = white)
- * @returns Grayscale color object
+ * Widths are in glyph units (1000 units = 1 em).
  *
- * @example
- * ```typescript
- * const black = grayscale(0);
- * const white = grayscale(1);
- * const midGray = grayscale(0.5);
- * ```
+ * Data extracted from pdf.js metrics.js (Mozilla, Apache 2.0 License)
  */
-declare function grayscale(gray: number): Grayscale;
 /**
- * Create a CMYK color.
- *
- * @param c Cyan component (0-1)
- * @param m Magenta component (0-1)
- * @param y Yellow component (0-1)
- * @param k Black component (0-1)
- * @returns CMYK color object
+ * Standard 14 font names.
+ */
+declare const STANDARD_14_FONTS: readonly ["Courier", "Courier-Bold", "Courier-Oblique", "Courier-BoldOblique", "Helvetica", "Helvetica-Bold", "Helvetica-Oblique", "Helvetica-BoldOblique", "Times-Roman", "Times-Bold", "Times-Italic", "Times-BoldItalic", "Symbol", "ZapfDingbats"];
+type Standard14FontName = (typeof STANDARD_14_FONTS)[number];
+/**
+ * Standard 14 fonts enum for convenient access.
  *
  * @example
  * ```typescript
- * const black = cmyk(0, 0, 0, 1);
- * const cyan = cmyk(1, 0, 0, 0);
+ * page.drawText("Hello", { font: StandardFonts.Helvetica });
+ * page.drawText("Bold", { font: StandardFonts.HelveticaBold });
  * ```
  */
-declare function cmyk(c: number, m: number, y: number, k: number): CMYK;
-/** Black color (grayscale 0) */
-declare const black: Grayscale;
-/** White color (grayscale 1) */
-declare const white: Grayscale;
-/** Red color (RGB) */
-declare const red: RGB;
-/** Green color (RGB) */
-declare const green: RGB;
-/** Blue color (RGB) */
-declare const blue: RGB;
+declare const StandardFonts: {
+  readonly Helvetica: "Helvetica";
+  readonly HelveticaBold: "Helvetica-Bold";
+  readonly HelveticaOblique: "Helvetica-Oblique";
+  readonly HelveticaBoldOblique: "Helvetica-BoldOblique";
+  readonly TimesRoman: "Times-Roman";
+  readonly TimesBold: "Times-Bold";
+  readonly TimesItalic: "Times-Italic";
+  readonly TimesBoldItalic: "Times-BoldItalic";
+  readonly Courier: "Courier";
+  readonly CourierBold: "Courier-Bold";
+  readonly CourierOblique: "Courier-Oblique";
+  readonly CourierBoldOblique: "Courier-BoldOblique";
+  readonly Symbol: "Symbol";
+  readonly ZapfDingbats: "ZapfDingbats";
+};
 //#endregion
 //#region src/api/drawing/types.d.ts
 /**
@@ -4699,10 +5752,6 @@ declare class PDFPage {
    * Generate appearance stream for a widget.
    */
   private generateWidgetAppearance;
-  /**
-   * Add an annotation reference to the page's /Annots array.
-   */
-  private addAnnotation;
   /**
    * Draw a rectangle on the page.
    *
@@ -4864,6 +5913,252 @@ declare class PDFPage {
    * ```
    */
   drawPath(): PathBuilder;
+  /** Cached annotations for this page */
+  private _annotationCache;
+  /**
+   * Get all annotations on this page (excludes Widget and Popup annotations).
+   *
+   * Widget annotations are handled by the forms subsystem via PDFForm.
+   * Popup annotations are accessed via annotation.getPopup().
+   *
+   * Results are cached - repeated calls return the same instances.
+   * The cache is invalidated when annotations are added or removed.
+   *
+   * @returns Array of annotation objects
+   *
+   * @example
+   * ```typescript
+   * const annotations = await page.getAnnotations();
+   * for (const annot of annotations) {
+   *   console.log(annot.type, annot.contents);
+   * }
+   * ```
+   */
+  getAnnotations(): Promise<PDFAnnotation[]>;
+  /**
+   * Get all popup annotations on this page.
+   *
+   * Popups are typically accessed via their parent markup annotation
+   * using `annotation.getPopup()`, but this method allows direct access.
+   */
+  getPopupAnnotations(): Promise<PDFPopupAnnotation[]>;
+  /**
+   * Get all highlight annotations on this page.
+   */
+  getHighlightAnnotations(): Promise<PDFHighlightAnnotation[]>;
+  /**
+   * Get all underline annotations on this page.
+   */
+  getUnderlineAnnotations(): Promise<PDFUnderlineAnnotation[]>;
+  /**
+   * Get all strikeout annotations on this page.
+   */
+  getStrikeOutAnnotations(): Promise<PDFStrikeOutAnnotation[]>;
+  /**
+   * Get all squiggly annotations on this page.
+   */
+  getSquigglyAnnotations(): Promise<PDFSquigglyAnnotation[]>;
+  /**
+   * Get all link annotations on this page.
+   */
+  getLinkAnnotations(): Promise<PDFLinkAnnotation[]>;
+  /**
+   * Get all text annotations (sticky notes) on this page.
+   */
+  getTextAnnotations(): Promise<PDFTextAnnotation[]>;
+  /**
+   * Get all free text annotations on this page.
+   */
+  getFreeTextAnnotations(): Promise<PDFFreeTextAnnotation[]>;
+  /**
+   * Get all line annotations on this page.
+   */
+  getLineAnnotations(): Promise<PDFLineAnnotation[]>;
+  /**
+   * Get all square annotations on this page.
+   */
+  getSquareAnnotations(): Promise<PDFSquareAnnotation[]>;
+  /**
+   * Get all circle annotations on this page.
+   */
+  getCircleAnnotations(): Promise<PDFCircleAnnotation[]>;
+  /**
+   * Get all stamp annotations on this page.
+   */
+  getStampAnnotations(): Promise<PDFStampAnnotation[]>;
+  /**
+   * Get all ink annotations on this page.
+   */
+  getInkAnnotations(): Promise<PDFInkAnnotation[]>;
+  /**
+   * Get all polygon annotations on this page.
+   */
+  getPolygonAnnotations(): Promise<PDFPolygonAnnotation[]>;
+  /**
+   * Get all polyline annotations on this page.
+   */
+  getPolylineAnnotations(): Promise<PDFPolylineAnnotation[]>;
+  /**
+   * Get all caret annotations on this page.
+   */
+  getCaretAnnotations(): Promise<PDFCaretAnnotation[]>;
+  /**
+   * Get all file attachment annotations on this page.
+   */
+  getFileAttachmentAnnotations(): Promise<PDFFileAttachmentAnnotation[]>;
+  /**
+   * Add a highlight annotation.
+   *
+   * @param options - Highlight options (rect, rects, or quadPoints)
+   * @returns The created annotation
+   *
+   * @example
+   * ```typescript
+   * // Simple rect for horizontal text
+   * page.addHighlightAnnotation({
+   *   rect: { x: 100, y: 680, width: 200, height: 20 },
+   *   color: rgb(1, 1, 0),
+   * });
+   *
+   * // Multiple rects for multi-line selection
+   * page.addHighlightAnnotation({
+   *   rects: [
+   *     { x: 100, y: 700, width: 400, height: 14 },
+   *     { x: 100, y: 680, width: 250, height: 14 },
+   *   ],
+   *   color: rgb(1, 1, 0),
+   * });
+   * ```
+   */
+  addHighlightAnnotation(options: TextMarkupAnnotationOptions): PDFHighlightAnnotation;
+  /**
+   * Add an underline annotation.
+   */
+  addUnderlineAnnotation(options: TextMarkupAnnotationOptions): PDFUnderlineAnnotation;
+  /**
+   * Add a strikeout annotation.
+   */
+  addStrikeOutAnnotation(options: TextMarkupAnnotationOptions): PDFStrikeOutAnnotation;
+  /**
+   * Add a squiggly underline annotation.
+   */
+  addSquigglyAnnotation(options: TextMarkupAnnotationOptions): PDFSquigglyAnnotation;
+  /**
+   * Add a text markup annotation (internal helper).
+   */
+  private addTextMarkupAnnotation;
+  /**
+   * Add a link annotation.
+   *
+   * @param options - Link options (uri or destination)
+   * @returns The created annotation
+   *
+   * @example
+   * ```typescript
+   * // External link
+   * page.addLinkAnnotation({
+   *   rect: { x: 100, y: 600, width: 200, height: 20 },
+   *   uri: "https://example.com",
+   * });
+   *
+    * // Internal link to another page (recommended)
+    * page.addLinkAnnotation({
+    *   rect: { x: 100, y: 550, width: 200, height: 20 },
+    *   destination: { page: otherPage, type: "Fit" },
+    * });
+    *
+    * // Or using a page reference directly
+    * page.addLinkAnnotation({
+    *   rect: { x: 100, y: 520, width: 200, height: 20 },
+    *   destination: { page: otherPage.ref, type: "Fit" },
+    * });
+      * ```
+   */
+  addLinkAnnotation(options: LinkAnnotationOptions): PDFLinkAnnotation;
+  /**
+   * Add a text annotation (sticky note).
+   *
+   * @param options - Text annotation options
+   * @returns The created annotation
+   */
+  addTextAnnotation(options: TextAnnotationOptions): PDFTextAnnotation;
+  /**
+   * Add a line annotation.
+   *
+   * @param options - Line annotation options
+   * @returns The created annotation
+   */
+  addLineAnnotation(options: LineAnnotationOptions): PDFLineAnnotation;
+  /**
+   * Add a square (rectangle) annotation.
+   *
+   * @param options - Square annotation options
+   * @returns The created annotation
+   */
+  addSquareAnnotation(options: SquareAnnotationOptions): PDFSquareAnnotation;
+  /**
+   * Add a circle (ellipse) annotation.
+   *
+   * @param options - Circle annotation options
+   * @returns The created annotation
+   */
+  addCircleAnnotation(options: CircleAnnotationOptions): PDFCircleAnnotation;
+  /**
+   * Add a stamp annotation.
+   *
+   * @param options - Stamp annotation options
+   * @returns The created annotation
+   */
+  addStampAnnotation(options: StampAnnotationOptions): PDFStampAnnotation;
+  /**
+   * Add an ink (freehand drawing) annotation.
+   *
+   * @param options - Ink annotation options
+   * @returns The created annotation
+   */
+  addInkAnnotation(options: InkAnnotationOptions): PDFInkAnnotation;
+  /**
+   * Remove a specific annotation from the page.
+   *
+   * Also removes any linked Popup annotation.
+   *
+   * @param annotation - The annotation to remove
+   *
+   * @example
+   * ```typescript
+   * const highlights = await page.getHighlightAnnotations();
+   * await page.removeAnnotation(highlights[0]);
+   * ```
+   */
+  removeAnnotation(annotation: PDFAnnotation): Promise<void>;
+  /**
+   * Remove annotations from the page.
+   *
+   * Without options, removes all annotations (except Widget annotations).
+   * With type filter, removes only annotations of the specified type.
+   *
+   * @param options - Optional filter by annotation type
+   *
+   * @example
+   * ```typescript
+   * // Remove all highlights
+   * await page.removeAnnotations({ type: "Highlight" });
+   *
+   * // Remove all annotations
+   * await page.removeAnnotations();
+   * ```
+   */
+  removeAnnotations(options?: RemoveAnnotationsOptions): Promise<void>;
+  /**
+   * Add an annotation reference to the page's /Annots array.
+   * Internal method - also invalidates the annotation cache.
+   */
+  private addAnnotationRef;
+  /**
+   * Invalidate the annotation cache.
+   * Called when annotations are added or removed.
+   */
+  private invalidateAnnotationCache;
   /**
    * Add an XObject reference to the page's resources.
    * Returns the name assigned to the XObject.
@@ -7157,22 +8452,199 @@ declare class CryptoKeySigner implements Signer {
    */
   constructor(privateKey: CryptoKey, certificate: Uint8Array, keyType: KeyType, signatureAlgorithm: SignatureAlgorithm, certificateChain?: Uint8Array[]);
   /**
-   * Sign a digest.
+   * Sign data using the private key.
    *
-   * @param digest - The hash to sign
-   * @param algorithm - The digest algorithm used
+   * The data is hashed internally using the specified algorithm.
+   *
+   * @param data - The data to sign
+   * @param algorithm - The digest algorithm to use
    * @returns Raw signature bytes
    */
-  sign(digest: Uint8Array, algorithm: DigestAlgorithm): Promise<Uint8Array>;
+  sign(data: Uint8Array, algorithm: DigestAlgorithm): Promise<Uint8Array>;
+  /**
+   * Get the hash output length in bytes for a given algorithm.
+   */
+  private getHashLength;
+}
+//#endregion
+//#region src/signatures/signers/google-kms.d.ts
+/** KMS client type - dynamically imported */
+type KeyManagementServiceClient = _google_cloud_kms0.KeyManagementServiceClient;
+/** Secret Manager client type - dynamically imported */
+type SecretManagerServiceClient = _google_cloud_secret_manager0.SecretManagerServiceClient;
+/** Base options shared by both key reference styles */
+interface GoogleKmsSignerBaseOptions {
+  /** DER-encoded X.509 certificate issued for this KMS key */
+  certificate: Uint8Array;
+  /** Certificate chain [intermediate, ..., root] (optional) */
+  certificateChain?: Uint8Array[];
+  /** Build certificate chain via AIA extensions (default: false) */
+  buildChain?: boolean;
+  /** Timeout for AIA chain building in ms (default: 15000) */
+  chainTimeout?: number;
+  /** Pre-configured KMS client (optional, uses ADC if not provided) */
+  client?: KeyManagementServiceClient;
+}
+/** Full resource name style */
+interface GoogleKmsSignerFullNameOptions extends GoogleKmsSignerBaseOptions {
+  /** Full KMS key version resource name */
+  keyVersionName: string;
+}
+/** Shorthand style */
+interface GoogleKmsSignerShorthandOptions extends GoogleKmsSignerBaseOptions {
+  projectId: string;
+  locationId: string;
+  keyRingId: string;
+  keyId: string;
+  /** Key version number (default: "1") */
+  keyVersion?: string;
+}
+/** Options for GoogleKmsSigner.create() */
+type GoogleKmsSignerOptions = GoogleKmsSignerFullNameOptions | GoogleKmsSignerShorthandOptions;
+/** Mapped algorithm info from KMS algorithm */
+
+/**
+ * Signer that uses Google Cloud KMS for signing operations.
+ *
+ * Supports RSA and ECDSA keys stored in Cloud KMS, including HSM-backed keys.
+ * The private key never leaves KMS - only the digest is sent for signing.
+ *
+ * **Performance note:** Each `sign()` call makes a network request to KMS
+ * (~50-200ms latency). For bulk signing, consider the performance implications.
+ *
+ * @example
+ * ```typescript
+ * const signer = await GoogleKmsSigner.create({
+ *   keyVersionName: "projects/my-project/locations/us/keyRings/ring/cryptoKeys/key/cryptoKeyVersions/1",
+ *   certificate: certificateDer,
+ * });
+ *
+ * const pdf = await PDF.load(pdfBytes);
+ * const { bytes } = await pdf.sign({ signer });
+ * ```
+ */
+declare class GoogleKmsSigner implements Signer {
+  readonly certificate: Uint8Array;
+  readonly certificateChain: Uint8Array[];
+  readonly keyType: KeyType;
+  readonly signatureAlgorithm: SignatureAlgorithm;
+  /** The digest algorithm this KMS key uses (locked at key creation) */
+  readonly digestAlgorithm: DigestAlgorithm;
+  /** Full resource name of the KMS key version (for logging/debugging) */
+  readonly keyVersionName: string;
+  private readonly client;
+  private constructor();
+  /**
+   * Create a GoogleKmsSigner from KMS key reference.
+   *
+   * @param options - Configuration options (key reference, certificate, etc.)
+   * @returns A new GoogleKmsSigner instance
+   * @throws {KmsSignerError} if key is invalid, disabled, or certificate doesn't match
+   *
+   * @example
+   * ```typescript
+   * // Full resource name
+   * const signer = await GoogleKmsSigner.create({
+   *   keyVersionName: "projects/my-project/locations/us-east1/keyRings/my-ring/cryptoKeys/my-key/cryptoKeyVersions/1",
+   *   certificate: certificateDer,
+   * });
+   *
+   * // Shorthand
+   * const signer = await GoogleKmsSigner.create({
+   *   projectId: "my-project",
+   *   locationId: "us-east1",
+   *   keyRingId: "my-ring",
+   *   keyId: "my-key",
+   *   certificate: certificateDer,
+   *   buildChain: true,
+   * });
+   * ```
+   */
+  static create(options: GoogleKmsSignerOptions): Promise<GoogleKmsSigner>;
+  /**
+   * Load a certificate from Google Secret Manager.
+   *
+   * The secret must contain a DER-encoded certificate. PEM format is NOT supported -
+   * convert to DER before storing in Secret Manager.
+   *
+   * Supports cross-project access: the secret can be in a different GCP project
+   * than the KMS key.
+   *
+   * @param secretVersionName - Full resource name, e.g.
+   *   "projects/my-project/secrets/my-cert/versions/latest"
+   * @param options - Optional client configuration
+   * @throws {KmsSignerError} if @google-cloud/secret-manager is not installed
+   *
+   * @example
+   * ```typescript
+   * // From same project
+   * const cert = await GoogleKmsSigner.getCertificateFromSecretManager(
+   *   "projects/my-project/secrets/signing-cert/versions/latest"
+   * );
+   *
+   * // From different project (cross-project access)
+   * const cert = await GoogleKmsSigner.getCertificateFromSecretManager(
+   *   "projects/shared-certs-project/secrets/signing-cert/versions/1"
+   * );
+   * ```
+   */
+  static getCertificateFromSecretManager(secretVersionName: string, options?: {
+    client?: SecretManagerServiceClient;
+  }): Promise<Uint8Array>;
+  /**
+   * Sign data using the KMS key.
+   *
+   * The data is hashed locally using the key's digest algorithm before being
+   * sent to KMS for signing. This is more efficient than sending the full data.
+   *
+   * @param data - The data to sign
+   * @param algorithm - The digest algorithm to use (must match the key's algorithm)
+   * @returns The signature bytes
+   * @throws {KmsSignerError} if digest algorithm doesn't match the key's algorithm
+   */
+  sign(data: Uint8Array, algorithm: DigestAlgorithm): Promise<Uint8Array>;
+  /**
+   * Hash data using the specified algorithm.
+   *
+   * @returns The digest bytes and the KMS digest key name
+   */
+  private hashData;
 }
 //#endregion
 //#region src/signatures/signers/p12.d.ts
+/**
+ * Options for creating a P12Signer.
+ */
+interface P12SignerOptions {
+  /**
+   * Build complete certificate chain using AIA (Authority Information Access).
+   *
+   * When enabled, the signer will fetch missing intermediate certificates
+   * from URLs embedded in the certificates. This ensures the CMS signature
+   * contains the full chain, which is important for validation.
+   *
+   * @default false
+   */
+  buildChain?: boolean;
+  /**
+   * Timeout for AIA certificate fetching in milliseconds.
+   * Only used when `buildChain` is true.
+   *
+   * @default 15000
+   */
+  chainTimeout?: number;
+}
 /**
  * Signer that uses a PKCS#12 (.p12/.pfx) file.
  *
  * @example
  * ```typescript
+ * // Basic usage
  * const signer = await P12Signer.create(p12Bytes, "password");
+ *
+ * // With automatic chain building via AIA
+ * const signer = await P12Signer.create(p12Bytes, "password", { buildChain: true });
+ *
  * const signature = await signer.sign(digest, "SHA-256");
  * ```
  */
@@ -7188,10 +8660,22 @@ declare class P12Signer implements Signer {
    *
    * @param p12Bytes - The .p12/.pfx file contents
    * @param password - Password to decrypt the file
+   * @param options - Optional configuration
    * @returns A new P12Signer instance
    * @throws {SignerError} if the file is invalid or password is wrong
+   *
+   * @example
+   * ```typescript
+   * // Basic usage
+   * const signer = await P12Signer.create(p12Bytes, "password");
+   *
+   * // With automatic chain building (recommended for B-LT/B-LTA)
+   * const signer = await P12Signer.create(p12Bytes, "password", {
+   *   buildChain: true,
+   * });
+   * ```
    */
-  static create(p12Bytes: Uint8Array, password: string): Promise<P12Signer>;
+  static create(p12Bytes: Uint8Array, password: string, options?: P12SignerOptions): Promise<P12Signer>;
   /**
    * Extract private key from a shrouded key bag.
    */
@@ -7385,5 +8869,28 @@ declare function layoutText(text: string, font: FontInput, fontSize: number, max
  */
 declare function layoutJustifiedLine(words: string[], font: FontInput, fontSize: number, targetWidth: number): PositionedWord[];
 //#endregion
-export { type AuthenticationResult, type ButtonField, type CMYK, CertificateChainError, type CheckboxField, type CheckboxOptions, type CheckboxSymbol, type Color, type CopyPagesOptions, CryptoKeySigner, type Degrees, type DigestAlgorithm, type DocumentMetadata, type DrawCircleOptions, type DrawEllipseOptions, type DrawFieldOptions, type DrawImageOptions, type DrawLineOptions, type DrawPageOptions, type DrawRectangleOptions, type DrawTextOptions, type DropdownField, type DropdownOptions, type EmbedFontOptions, type EmbeddedFont, type EncryptionAlgorithmOption, type ExtractPagesOptions, type FieldOptions, type FieldType, type FieldValue, type FlattenLayersResult, type FlattenOptions, type FontInput, type FormField, type FormProperties, type Grayscale, HttpTimestampAuthority, type HttpTimestampAuthorityOptions, type KeyType, type LayerInfo, type LayoutResult, type LineCap, type LineJoin, type ListBoxField, type ListboxOptions, type LoadOptions, type MergeOptions, P12Signer, type PAdESLevel, PDF, PDFEmbeddedPage, PDFForm, PDFImage, PDFPage, PathBuilder, type PathOptions, PdfArray, PdfBool, PdfDict, PdfName, PdfNull, PdfNumber, type PdfObject, PdfRef, PdfStream, PdfString, PermissionDeniedError, type PermissionOptions, type Permissions, PlaceholderError, type PositionedWord, type ProtectionOptions, type RGB, type RadioField, type RadioGroupOptions, type RadioSymbol, type Rectangle, RevocationError, type RevocationProvider, type Rotation, type SaveOptions, SecurityError, type SecurityInfo, type SetTitleOptions, type SignOptions, type SignResult, type SignWarning, type SignatureAlgorithm, SignatureError, type SignatureField, type SignatureFieldOptions, type Signer, SignerError, type Standard14FontName, StandardFonts, type SubFilter, TextAlignment, type TextField, type TextFieldOptions, type TextLine, type TimestampAuthority, TimestampError, type TrappedStatus, black, blue, cmyk, degrees, grayscale, green, layoutJustifiedLine, layoutText, lineCapToNumber, lineJoinToNumber, measureText, red, rgb, version, white };
+//#region src/annotations/factory.d.ts
+/**
+ * Unknown annotation - fallback for unsupported types.
+ */
+declare class PDFUnknownAnnotation extends PDFAnnotation {}
+/**
+ * Create an annotation object from a PDF dictionary.
+ *
+ * @param dict - The annotation dictionary
+ * @param ref - The reference to the annotation object
+ * @param registry - The object registry for resolving references
+ * @returns The appropriate annotation class instance
+ */
+declare function createAnnotation(dict: PdfDict, ref: PdfRef | null, registry: ObjectRegistry): PDFAnnotation;
+/**
+ * Check if an annotation is a Widget (form field).
+ */
+declare function isWidgetAnnotation(dict: PdfDict): boolean;
+/**
+ * Check if an annotation is a Popup.
+ */
+declare function isPopupAnnotation(dict: PdfDict): boolean;
+//#endregion
+export { AnnotationFlags, type AnnotationSubtype, type AuthenticationResult, type BorderStyle, type BorderStyleType, type ButtonField, type CMYK, type CaretAnnotationOptions, type CaretSymbol, CertificateChainError, type CheckboxField, type CheckboxOptions, type CheckboxSymbol, type CircleAnnotationOptions, type Color, type CopyPagesOptions, CryptoKeySigner, type Degrees, type DestinationType, type DigestAlgorithm, type DocumentMetadata, type DrawCircleOptions, type DrawEllipseOptions, type DrawFieldOptions, type DrawImageOptions, type DrawLineOptions, type DrawPageOptions, type DrawRectangleOptions, type DrawTextOptions, type DropdownField, type DropdownOptions, type EmbedFontOptions, type EmbeddedFont, type EncryptionAlgorithmOption, type ExtractPagesOptions, type FieldOptions, type FieldType, type FieldValue, type FileAttachmentIcon, type FlattenAnnotationsOptions, type FlattenLayersResult, type FlattenOptions, type FontInput, type FormField, type FormProperties, type FreeTextAnnotationOptions, type FreeTextJustification, GoogleKmsSigner, type Grayscale, type HighlightMode, HttpTimestampAuthority, type HttpTimestampAuthorityOptions, type InkAnnotationOptions, type KeyType, KmsSignerError, type LayerInfo, type LayoutResult, type LineAnnotationOptions, type LineCap, type LineEndingStyle, type LineJoin, type LinkAction, type LinkAnnotationOptions, type LinkDestination, type ListBoxField, type ListboxOptions, type LoadOptions, type MergeOptions, P12Signer, type PAdESLevel, PDF, PDFAnnotation, PDFCaretAnnotation, PDFCircleAnnotation, PDFEmbeddedPage, PDFFileAttachmentAnnotation, PDFForm, PDFFreeTextAnnotation, PDFHighlightAnnotation, PDFImage, PDFInkAnnotation, PDFLineAnnotation, PDFLinkAnnotation, PDFMarkupAnnotation, PDFPage, PDFPolygonAnnotation, PDFPolylineAnnotation, PDFPopupAnnotation, PDFSquareAnnotation, PDFSquigglyAnnotation, PDFStampAnnotation, PDFStrikeOutAnnotation, PDFTextAnnotation, PDFTextMarkupAnnotation, PDFUnderlineAnnotation, PDFUnknownAnnotation, PathBuilder, type PathOptions, PdfArray, PdfBool, PdfDict, PdfName, PdfNull, PdfNumber, type PdfObject, PdfRef, PdfStream, PdfString, PermissionDeniedError, type PermissionOptions, type Permissions, PlaceholderError, type Point, type PolygonAnnotationOptions, type PolylineAnnotationOptions, type PopupOptions, type PositionedWord, type ProtectionOptions, type RGB, type RadioField, type RadioGroupOptions, type RadioSymbol, type Rect, type Rectangle, type RemoveAnnotationsOptions, RevocationError, type RevocationProvider, type Rotation, STANDARD_STAMPS, type SaveOptions, SecurityError, type SecurityInfo, type SetTitleOptions, type SignOptions, type SignResult, type SignWarning, type SignatureAlgorithm, SignatureError, type SignatureField, type SignatureFieldOptions, type Signer, SignerError, type SquareAnnotationOptions, type StampAnnotationOptions, type StampName, type Standard14FontName, StandardFonts, type SubFilter, TextAlignment, type TextAnnotationIcon, type TextAnnotationOptions, type TextAnnotationState, type TextAnnotationStateModel, type TextField, type TextFieldOptions, type TextLine, type TextMarkupAnnotationOptions, type TimestampAuthority, TimestampError, type TrappedStatus, black, blue, cmyk, createAnnotation, degrees, grayscale, green, isPopupAnnotation, isWidgetAnnotation, layoutJustifiedLine, layoutText, lineCapToNumber, lineJoinToNumber, measureText, rectToQuadPoints, rectsToQuadPoints, red, rgb, version, white };
 //# sourceMappingURL=index.d.mts.map