Method getOrCreateForm

src/api/pdf.ts:2677–2731

* Get or create the document's interactive form. * * If the document has no AcroForm, one is created and added to the catalog * with proper default resources (Helvetica and ZapfDingbats fonts) and * default appearance settings. * * @returns The form (never null) * * @example

()

   * ```
   */
  getOrCreateForm(): PDFForm {
    const existing = this.getForm();

    if (existing) {
      return existing;
    }

    // Create standard Helvetica font dictionary
    const helveticaDict = PdfDict.of({
      Type: PdfName.of("Font"),
      Subtype: PdfName.of("Type1"),
      BaseFont: PdfName.of("Helvetica"),
    });

    // Create ZapfDingbats font dictionary (for checkboxes/radios)
    const zapfDingbatsDict = PdfDict.of({
      Type: PdfName.of("Font"),
      Subtype: PdfName.of("Type1"),
      BaseFont: PdfName.of("ZapfDingbats"),
    });

    // Create Font dictionary with standard fonts
    const fontsDict = PdfDict.of({
      Helv: helveticaDict,
      ZaDb: zapfDingbatsDict,
    });

    // Create Default Resources dictionary
    const drDict = PdfDict.of({
      Font: fontsDict,
    });

    // Create AcroForm dictionary with proper defaults
    const acroFormDict = PdfDict.of({
      Fields: new PdfArray([]),
      DR: drDict,
      DA: PdfString.fromString("/Helv 0 Tf 0 g"),
      NeedAppearances: PdfBool.of(false),
    });

    const acroFormRef = this.ctx.registry.register(acroFormDict);

    // Add to catalog
    const catalog = this.getCatalog();
    catalog.set("AcroForm", acroFormRef);

    // Reload form cache
    this._form = PDFForm.load(this.ctx);

    if (!this._form) {
      throw new Error("Failed to create form");
    }

    return this._form;
  }

  // ─────────────────────────────────────────────────────────────────────────────
  // Digital Signatures