Method embedPage

src/api/pdf.ts:1861–1910

(source: PDF, pageIndex: number)

   */
  // oxlint-disable-next-line typescript/require-await -- Public async API kept for backward compat; ObjectCopier is sync.
  async embedPage(source: PDF, pageIndex: number): Promise<PDFEmbeddedPage> {
    const srcPage = source.getPage(pageIndex);

    if (!srcPage) {
      throw new RangeError(`Page index ${pageIndex} out of bounds`);
    }

    // Get page content streams and concatenate
    const contentData = this.getPageContentData(source, srcPage);

    // Copy resources from source to dest
    const copier = new ObjectCopier(source, this, { includeAnnotations: false });

    const srcResources = srcPage.dict.getDict("Resources", source.getObject.bind(source));

    let resources: PdfDict;

    if (srcResources) {
      const copied = copier.copyObject(srcResources);

      // This is guaranteed by our checks above
      resources = copied instanceof PdfDict ? copied : new PdfDict();
    } else {
      resources = new PdfDict();
    }

    // Get the MediaBox
    const mediaBox = srcPage.getMediaBox();

    // Create Form XObject
    const formXObject = PdfStream.fromDict(
      {
        Type: PdfName.of("XObject"),
        Subtype: PdfName.of("Form"),
        FormType: PdfNumber.of(1),
        BBox: new PdfArray([
          PdfNumber.of(mediaBox.x),
          PdfNumber.of(mediaBox.y),
          PdfNumber.of(mediaBox.x + mediaBox.width),
          PdfNumber.of(mediaBox.y + mediaBox.height),
        ]),
        Resources: resources,
      },
      contentData,
    );

    const ref = this.register(formXObject);

    return new PDFEmbeddedPage(ref, mediaBox, srcPage.width, srcPage.height);
  }

  /**
   * Get the concatenated content stream data from a page.