Method createRadioGroup

src/api/pdf-form.ts:714–771

* Create a new radio button group. * * Radio groups must have at least one option. Each option gets its own widget * when you call `page.drawField()` with the `option` parameter. * * @param name - Field name (must be unique) * @param options - Radio group options (options array is

(name: string, options: RadioGroupOptions)

   * ```
   */
  createRadioGroup(name: string, options: RadioGroupOptions): RadioField {
    this.validateUniqueName(name);

    if (!options.options || options.options.length === 0) {
      throw new Error("Radio group must have at least one option");
    }

    // Button field type with Radio flag
    const flags = FieldFlags.RADIO;

    const selectedValue = options.defaultValue ?? null;

    // Create field dictionary with /Kids array (separate widget model)
    const fieldDict = PdfDict.of({
      FT: PdfName.of("Btn"),
      T: PdfString.fromString(name),
      Ff: PdfNumber.of(flags),
      Kids: new PdfArray([]),
    });

    if (selectedValue && options.options.includes(selectedValue)) {
      fieldDict.set("V", PdfName.of(selectedValue));
      fieldDict.set("DV", PdfName.of(selectedValue));
    } else {
      fieldDict.set("V", PdfName.of("Off"));
    }

    // Store options for validation in drawField
    fieldDict.set("Opt", PdfArray.of(...options.options.map(o => PdfString.fromString(o))));

    // Store symbol preference
    if (options.symbol) {
      fieldDict.set("_Symbol", PdfName.of(options.symbol));
    }

    // Store styling metadata
    this.storeFieldStyling(fieldDict, options);

    // Register and add to form
    const fieldRef = this._ctx.registry.register(fieldDict);
    this._acroForm.addField(fieldRef);

    // Create the RadioField instance
    // oxlint-disable-next-line typescript/no-unsafe-type-assertion
    const field = createFormField(
      fieldDict,
      fieldRef,
      this._ctx.registry,
      this._acroForm,
      name,
    ) as RadioField;

    // Add to cache
    this.allFields.push(field);
    this.fieldsByName.set(name, field);

    return field;
  }