Class PDF

src/api/pdf.ts:278–3342

 * ```
 */
export class PDF {
  /** Central context for document operations */
  private ctx: PDFContext;

  private originalBytes: Uint8Array;
  private originalXRefOffset: number;

  /** Font operations manager (created lazily) */
  private _fonts: PDFFonts | null = null;

  /** Attachment operations manager (created lazily) */
  private _attachments: PDFAttachments | null = null;

  /** Cached form (loaded lazily via getForm()) */
  private _form: PDFForm | null | undefined;

  /** Whether this document was recovered via brute-force parsing */
  private _recoveredViaBruteForce: boolean;

  /** Whether this document was recovered via brute-force parsing */
  get recoveredViaBruteForce(): boolean {
    return this._recoveredViaBruteForce;
  }

  /** Whether this document is linearized */
  private _isLinearized: boolean;

  /** Whether this document is linearized */
  get isLinearized(): boolean {
    return this._isLinearized;
  }

  /** Whether the original document uses XRef streams (PDF 1.5+) */
  private _usesXRefStreams: boolean;

  /** Whether the document uses XRef streams (PDF 1.5+) */
  get usesXRefStreams(): boolean {
    return this._usesXRefStreams;
  }

  /**
   * Whether this document was newly created (not loaded from bytes).
   * Newly created documents cannot use incremental save.
   */
  private _isNewlyCreated!: boolean;

  /**
   * Pending security state for save.
   * Tracks whether encryption should be added, removed, or unchanged.
   */
  private _pendingSecurity: PendingSecurityState = { action: "none" };

  /** Warnings from parsing and operations */
  get warnings(): string[] {
    return this.ctx.warnings;
  }

  /**