Method addPage

src/api/pdf.ts:1618–1646

* Add a new blank page. * * @param options - Page size, rotation, and insertion position * @returns The new page * @throws {RangeError} If insertAt index is out of bounds

(options: AddPageOptions = {})

   * @throws {RangeError} If insertAt index is out of bounds
   */
  addPage(options: AddPageOptions = {}): PDFPage {
    const { width, height } = resolvePageSize(options);
    const rotate = options.rotate ?? 0;

    // Create minimal page dict
    const pageDict = PdfDict.of({
      Type: PdfName.Page,
      MediaBox: new PdfArray([
        PdfNumber.of(0),
        PdfNumber.of(0),
        PdfNumber.of(width),
        PdfNumber.of(height),
      ]),
      Resources: new PdfDict(),
    });

    if (rotate !== 0) {
      pageDict.set("Rotate", PdfNumber.of(rotate));
    }

    // Register the page
    const pageRef = this.register(pageDict);

    // Insert at specified position or append
    const index = options.insertAt ?? this.getPageCount();
    this.ctx.pages.insertPage(index, pageRef, pageDict);

    return new PDFPage(pageRef, pageDict, index, this.ctx);
  }

  /**
   * Insert an existing page at the given index.