Method removeWidgetsFromPages

src/api/pdf-form.ts:1043–1096

* Remove all widgets of a field from their respective pages.

(field: FormField)

   * Remove all widgets of a field from their respective pages.
   */
  private removeWidgetsFromPages(field: FormField): void {
    const widgets = field.getWidgets();
    const pageRefs = this._ctx.pages.getPages();

    // Build a set of widget refs for fast lookup
    const widgetRefKeys = new Set<string>();

    for (const widget of widgets) {
      if (widget.ref) {
        widgetRefKeys.add(`${widget.ref.objectNumber} ${widget.ref.generation}`);
      }
    }

    if (widgetRefKeys.size === 0) {
      return;
    }

    // Scan pages and remove widget annotations
    for (const pageRef of pageRefs) {
      const pageDict = this._ctx.registry.resolve(pageRef);

      if (!(pageDict instanceof PdfDict)) {
        continue;
      }

      const annots = pageDict.getArray(
        "Annots",
        this._ctx.registry.resolve.bind(this._ctx.registry),
      );

      if (!annots) {
        continue;
      }

      // Remove matching widget refs from this page's annotations
      // Iterate backwards to safely remove items
      for (let i = annots.length - 1; i >= 0; i--) {
        const item = annots.at(i);

        if (item instanceof PdfRef) {
          const key = `${item.objectNumber} ${item.generation}`;

          if (widgetRefKeys.has(key)) {
            annots.remove(i);
          }
        }
      }

      // If annots is now empty, remove the /Annots entry
      if (annots.length === 0) {
        pageDict.delete("Annots");
      }
    }
  }

  // ─────────────────────────────────────────────────────────────────────────────
  // Field Creation Helpers