Method insertPage

src/api/pdf.ts:1657–1680

* Insert an existing page at the given index. * * @param index - Position to insert (0 = first, negative = append) * @param page - The page dict or ref to insert * @returns The page reference * @throws {Error} If page reference does not point to a dictionary * @throws {RangeError}

(index: number, page: PdfDict | PdfRef)

   * @throws {RangeError} If index is out of bounds
   */
  insertPage(index: number, page: PdfDict | PdfRef): PdfRef {
    let pageRef: PdfRef;
    let pageDict: PdfDict;

    if (page instanceof PdfRef) {
      pageRef = page;
      // Get the dict from registry or throw
      const obj = this.ctx.registry.getObject(page);

      if (!(obj instanceof PdfDict)) {
        throw new Error("Page reference does not point to a dictionary");
      }

      pageDict = obj;
    } else {
      // Register the dict and get a ref
      pageRef = this.register(page);
      pageDict = page;
    }

    this.ctx.pages.insertPage(index, pageRef, pageDict);

    return pageRef;
  }

  /**
   * Remove the page at the given index.