pdf-lite 1.6.3 → 1.7.0

package/dist/acroform/appearance/pdf-button-appearance-stream.js

@@ -39,7 +39,7 @@ export class PdfButtonAppearanceStream extends PdfAppearanceStream {
             g.restore();
         }
         else {
-            const checkSize = size * 0.8;
+            const checkSize = size * 0.65;
             const offset = (size - checkSize) / 2;
             g.save();
             g.beginText();

package/dist/acroform/appearance/pdf-text-appearance-stream.js

@@ -28,8 +28,8 @@ export class PdfTextAppearanceStream extends PdfAppearanceStream {
         g.setDefaultAppearance(new PdfDefaultAppearance(ctx.da.fontName, DEFAULT_FONT_SIZE, ctx.da.colorOp));
         // ── Determine font size ──────────────────────────────────────
         let finalFontSize;
-        if (autoSize) {
-            // Acrobat auto-size: default to 12pt with wrapping, then
+        if (autoSize && ctx.multiline) {
+            // Multiline auto-size: default to 12pt with wrapping, then
             // shrink only if the wrapped text still doesn't fit.
             finalFontSize = DEFAULT_FONT_SIZE;
             const testLines = g.wrapTextToLines(value, availableWidth);
@@ -38,6 +38,17 @@ export class PdfTextAppearanceStream extends PdfAppearanceStream {
             }
             finalFontSize = Math.max(finalFontSize, 0.5);
         }
+        else if (autoSize) {
+            // Single-line auto-size: fit to available height, then
+            // shrink further if text overflows the width.
+            finalFontSize = Math.min(DEFAULT_FONT_SIZE, availableHeight);
+            g.setDefaultAppearance(new PdfDefaultAppearance(ctx.da.fontName, finalFontSize, ctx.da.colorOp));
+            const textWidth = g.measureTextWidth(value);
+            if (textWidth > availableWidth) {
+                finalFontSize = g.calculateFittingFontSize(value, availableWidth);
+            }
+            finalFontSize = Math.max(finalFontSize, 0.5);
+        }
         else {
             finalFontSize = ctx.da.fontSize;
         }
@@ -45,30 +56,14 @@ export class PdfTextAppearanceStream extends PdfAppearanceStream {
         const finalDA = new PdfDefaultAppearance(ctx.da.fontName, finalFontSize, ctx.da.colorOp);
         g.setDefaultAppearance(finalDA);
         let lines = [];
-        if (ctx.multiline || autoSize) {
-            if (!autoSize) {
-                const testLines = g.wrapTextToLines(value, availableWidth);
-                const lineHeight = finalFontSize * 1.2;
-                if (testLines.length * lineHeight > availableHeight) {
-                    finalFontSize = g.calculateFittingFontSize(value, availableWidth, availableHeight, 1.2);
-                    g.setDefaultAppearance(new PdfDefaultAppearance(ctx.da.fontName, finalFontSize, ctx.da.colorOp));
-                }
-            }
-            lines = g.wrapTextToLines(value, availableWidth);
-            const renderLineHeight = finalFontSize * 1.2;
-            const startY = height - padding - finalFontSize;
-            g.beginText();
-            g.moveTo(padding, startY);
-            for (let i = 0; i < lines.length; i++) {
-                if (i > 0)
-                    g.moveTo(0, -renderLineHeight);
-                g.showText(lines[i].replace(/\r/g, ''), isUnicode, reverseEncodingMap);
-            }
-            g.endText();
-        }
-        else if (ctx.comb && ctx.maxLen) {
+        if (ctx.comb && ctx.maxLen) {
             const cellWidth = width / ctx.maxLen;
             const chars = [...value];
+            // For auto-size comb, fit font to cell height
+            if (autoSize) {
+                finalFontSize = Math.min(height - 2 * padding, cellWidth);
+                g.setDefaultAppearance(new PdfDefaultAppearance(ctx.da.fontName, finalFontSize, ctx.da.colorOp));
+            }
             let maxCharWidth = 0;
             let widestChar = chars[0] ?? '';
             for (const char of chars) {
@@ -85,13 +80,35 @@ export class PdfTextAppearanceStream extends PdfAppearanceStream {
             const textY = (height - finalFontSize) / 2 + finalFontSize * 0.2;
             g.beginText();
             for (let i = 0; i < chars.length && i < ctx.maxLen; i++) {
-                const cellX = cellWidth * i + cellWidth / 2 - finalFontSize * 0.3;
+                const charWidth = g.measureTextWidth(chars[i]);
+                const cellX = cellWidth * i + (cellWidth - charWidth) / 2;
                 g.moveTo(cellX, textY);
                 g.showText(chars[i], isUnicode, reverseEncodingMap);
                 g.moveTo(-cellX, -textY);
             }
             g.endText();
         }
+        else if (ctx.multiline) {
+            if (!autoSize) {
+                const testLines = g.wrapTextToLines(value, availableWidth);
+                const lineHeight = finalFontSize * 1.2;
+                if (testLines.length * lineHeight > availableHeight) {
+                    finalFontSize = g.calculateFittingFontSize(value, availableWidth, availableHeight, 1.2);
+                    g.setDefaultAppearance(new PdfDefaultAppearance(ctx.da.fontName, finalFontSize, ctx.da.colorOp));
+                }
+            }
+            lines = g.wrapTextToLines(value, availableWidth);
+            const renderLineHeight = finalFontSize * 1.2;
+            const startY = height - padding - finalFontSize;
+            g.beginText();
+            g.moveTo(padding, startY);
+            for (let i = 0; i < lines.length; i++) {
+                if (i > 0)
+                    g.moveTo(0, -renderLineHeight);
+                g.showText(lines[i].replace(/\r/g, ''), isUnicode, reverseEncodingMap);
+            }
+            g.endText();
+        }
         else {
             // Single line — for non-auto-size, shrink if text overflows
             if (!autoSize) {

package/dist/acroform/fields/pdf-button-form-field.d.ts

@@ -1,14 +1,23 @@
 import { PdfFormField } from './pdf-form-field.js';
 import { PdfString } from '../../core/objects/pdf-string.js';
+import type { PdfAcroForm } from '../pdf-acro-form.js';
+import type { PdfIndirectObject } from '../../core/objects/pdf-indirect-object.js';
 /**
  * Button form field subtype (checkboxes, radio buttons, push buttons).
  */
 export declare class PdfButtonFormField extends PdfFormField {
-    set defaultValue(val: string);
-    protected _storeValue(val: string | PdfString, fieldParent: PdfFormField | undefined): boolean;
+    constructor(other?: PdfIndirectObject | {
+        form?: PdfAcroForm;
+    });
+    private initWidget;
+    set isWidget(val: boolean);
+    get isGroup(): boolean;
+    get value(): string;
+    set value(val: string | PdfString);
     get checked(): boolean;
     set checked(isChecked: boolean);
     generateAppearance(options?: {
         makeReadOnly?: boolean;
+        onStateName?: string;
     }): boolean;
 }

package/dist/acroform/fields/pdf-button-form-field.js

@@ -1,6 +1,5 @@
 import { PdfFormField } from './pdf-form-field.js';
 import { PdfButtonAppearanceStream } from '../appearance/pdf-button-appearance-stream.js';
-import { PdfName } from '../../core/objects/pdf-name.js';
 import { PdfString } from '../../core/objects/pdf-string.js';
 /**
  * Button form field subtype (checkboxes, radio buttons, push buttons).
@@ -9,50 +8,80 @@ export class PdfButtonFormField extends PdfFormField {
     static {
         PdfFormField.registerFieldType('Btn', PdfButtonFormField);
     }
-    set defaultValue(val) {
-        this.content.set('DV', new PdfName(val));
-    }
-    _storeValue(val, fieldParent) {
-        const strVal = val instanceof PdfString ? val.value : val;
-        if (strVal.trim() === '') {
-            this.content.delete('V');
-            fieldParent?.content.delete('V');
-            this.content.delete('AS');
-            return false;
+    constructor(other) {
+        super(other);
+        if (this.isWidget && this.appearanceStates.length === 0) {
+            this.initWidget();
         }
-        // Check if the value matches an existing appearance state;
-        // otherwise map truthy values to the widget's "on" state (the
-        // first state that isn't "Off"), falling back to "Yes".
-        const states = this.appearanceStates;
-        let resolved;
-        if (states.includes(strVal)) {
-            resolved = strVal;
+    }
+    initWidget() {
+        this.rect ||= [0, 0, 50, 50];
+        this.generateAppearance({
+            onStateName: this.onState ?? 'Yes',
+        });
+        this.appearanceState ??= 'Off';
+    }
+    set isWidget(val) {
+        super.isWidget = val;
+        // Only initialize the widget if it has no existing appearances.
+        // `appearanceStream` is write-only on PdfFormField, so instead check
+        // the underlying appearance data structures.
+        if (val &&
+            !this.appearanceStreamDict &&
+            this.appearanceStates.length === 0) {
+            this.initWidget();
         }
-        else if (strVal === 'Off' || strVal === 'No') {
-            resolved = 'Off';
+    }
+    get isGroup() {
+        return this.children.length > 0;
+    }
+    get value() {
+        return super.value;
+    }
+    set value(val) {
+        const strVal = val instanceof PdfString ? val.value : val;
+        this.setRawValue(new PdfString(strVal));
+        if (this.isGroup) {
+            const children = this.children;
+            // 'Off' means explicitly uncheck all children
+            if (strVal === 'Off') {
+                for (const child of children) {
+                    child.appearanceState = 'Off';
+                    if (this._form)
+                        child.form = this._form;
+                }
+            }
+            else {
+                let wasSet = false;
+                for (const child of children) {
+                    const foundState = child.onStates.includes(strVal);
+                    if (!wasSet && foundState) {
+                        wasSet = true;
+                    }
+                    child.appearanceState = foundState ? strVal : 'Off';
+                    if (this._form)
+                        child.form = this._form;
+                }
+                if (!wasSet && children.length > 0) {
+                    // If value doesn't match any on-state, check first child by default
+                    children[0].appearanceState =
+                        children[0].onStates[0] ?? 'Off';
+                }
+            }
         }
         else {
-            resolved = states.find((s) => s !== 'Off') ?? 'Yes';
+            this.appearanceState = strVal;
         }
-        this.content.set('V', new PdfName(resolved));
-        fieldParent?.content.set('V', new PdfName(resolved));
-        this.content.set('AS', new PdfName(resolved));
-        return true;
     }
     get checked() {
-        const v = this.content.get('V') ?? this.parent?.content.get('V');
-        return v instanceof PdfName && v.value !== 'Off';
+        return !(this.appearanceState === 'Off' || this.value === 'Off');
     }
     set checked(isChecked) {
-        const target = this.parent ?? this;
         if (isChecked) {
-            const onState = this.appearanceStates.find((s) => s !== 'Off') ?? 'Yes';
-            target.content.set('V', new PdfName(onState));
-            this.content.set('AS', new PdfName(onState));
+            this.value = this.onState ?? 'Yes';
         }
         else {
-            target.content.set('V', new PdfName('Off'));
-            this.content.set('AS', new PdfName('Off'));
+            this.value = 'Off';
         }
     }
     generateAppearance(options) {
@@ -71,11 +100,21 @@ export class PdfButtonFormField extends PdfFormField {
             height,
             contentStream: '',
         });
-        const onState = this.appearanceStates.find((s) => s !== 'Off') ?? 'Yes';
-        this.setAppearanceStream({
-            [onState]: yesAppearance,
+        const existingOnState = this.onState;
+        const as = this.appearanceState;
+        const onKey = options?.onStateName ??
+            (as && as !== 'Off' ? as : (existingOnState ?? 'Yes'));
+        if (onKey === 'Off') {
+            throw new Error("Invalid on-state name 'Off' for button field appearance stream");
+        }
+        this.appearanceStream = {
+            [onKey]: yesAppearance,
             Off: noAppearance,
-        });
+        };
+        this.downAppearanceStream = {
+            [onKey]: yesAppearance,
+            Off: noAppearance,
+        };
         if (options?.makeReadOnly) {
             this.readOnly = true;
             this.print = true;

package/dist/acroform/fields/pdf-choice-form-field.js

@@ -91,7 +91,7 @@ export class PdfChoiceFormField extends PdfFormField {
         const fontResources = this.buildFontResources(parsed.fontName);
         const isUnicode = font?.isUnicode ?? false;
         const reverseEncodingMap = font?.reverseEncodingMap;
-        this.setAppearanceStream(new PdfChoiceAppearanceStream({
+        this.appearanceStream = new PdfChoiceAppearanceStream({
             rect: rect,
             value,
             da: parsed,
@@ -101,7 +101,7 @@ export class PdfChoiceFormField extends PdfFormField {
             reverseEncodingMap,
             displayOptions: this.options.map((opt) => opt.label),
             selectedIndex: this.selectedIndex,
-        }));
+        });
         if (options?.makeReadOnly) {
             this.readOnly = true;
             this.print = true;

package/dist/acroform/fields/pdf-form-field.d.ts

@@ -25,6 +25,7 @@ export declare abstract class PdfFormField extends PdfWidgetAnnotation {
         form?: PdfAcroForm;
     });
     set form(f: PdfAcroForm);
+    static getFieldType(other: PdfIndirectObject): 'Btn' | 'Sig' | 'Tx' | 'Ch' | null;
     static create(other?: PdfIndirectObject): PdfFormField;
     get parent(): PdfFormField | undefined;
     set parent(field: PdfFormField | PdfIndirectObject | undefined);
@@ -46,14 +47,12 @@ export declare abstract class PdfFormField extends PdfWidgetAnnotation {
     set name(name: string);
     get defaultValue(): string;
     set defaultValue(val: string);
+    get onStates(): string[];
+    get onState(): string | null;
+    set onState(state: string);
     get value(): string;
+    protected setRawValue(val: string | PdfString): void;
     set value(val: string | PdfString);
-    /**
-     * Writes the value to the dictionary. Returns true if appearance generation
-     * should proceed, false to skip it (e.g. when value was cleared).
-     * Override in subclasses to change the stored representation.
-     */
-    protected _storeValue(val: string | PdfString, fieldParent: PdfFormField | undefined): boolean;
     get fontSize(): number | null;
     set fontSize(size: number);
     get fontName(): string | null;
@@ -108,16 +107,23 @@ export declare abstract class PdfFormField extends PdfWidgetAnnotation {
     abstract generateAppearance(options?: {
         makeReadOnly?: boolean;
         textYOffset?: number;
+        onStateName?: string;
     }): boolean;
-    setAppearanceStream(stream: PdfIndirectObject | {
+    set appearanceStream(stream: PdfIndirectObject | {
         [key: string]: PdfIndirectObject;
-    }): void;
+    });
+    set downAppearanceStream(stream: PdfIndirectObject | {
+        [key: string]: PdfIndirectObject;
+    });
+    get appearanceState(): string | null;
+    set appearanceState(state: string | null);
     /**
      * Returns the list of appearance state names from the normal appearance
      * dictionary (e.g. ["Yes", "Off"] for a checkbox).
      */
-    get appearanceStates(): string[];
+    get appearanceStates(): ReadonlyArray<string>;
     getAppearanceStream(setting?: string): PdfIndirectObject<PdfStream> | null;
+    hasAppearanceStream(setting: string): boolean;
     private static _fallbackCtor?;
     private static _registry;
     static registerFieldType(ft: 'Sig' | 'Btn' | 'Tx' | 'Ch', ctor: new (other?: PdfIndirectObject) => PdfFormField, options?: {

package/dist/acroform/fields/pdf-form-field.js

@@ -32,10 +32,25 @@ export class PdfFormField extends PdfWidgetAnnotation {
     set form(f) {
         this._form = f;
     }
+    static getFieldType(other) {
+        if (!(other.content instanceof PdfDictionary))
+            return null;
+        const ft = other.content.get('FT')?.as(PdfName)?.value;
+        if (ft)
+            return ft;
+        const parentRef = other.content.get('Parent');
+        if (parentRef instanceof PdfObjectReference) {
+            const parentResolved = parentRef.resolve();
+            if (parentResolved?.content instanceof PdfDictionary) {
+                return (parentResolved.content.get('FT')?.as(PdfName)?.value ?? null);
+            }
+        }
+        return null;
+    }
     static create(other) {
         if (!(other?.content instanceof PdfDictionary))
             throw new Error('Invalid form field object');
-        const ft = other?.content.get('FT')?.as(PdfName)?.value;
+        const ft = PdfFormField.getFieldType(other);
         const cls = ft ? PdfFormField._registry.get(ft) : undefined;
         if (!cls) {
             if (PdfFormField._fallbackCtor) {
@@ -60,14 +75,23 @@ export class PdfFormField extends PdfWidgetAnnotation {
         if (field instanceof PdfFormField) {
             field.children = [...field.children, this];
         }
+        // Auto-add widget to page's Annots array
+        const page = this.page;
+        if (page) {
+            const annots = page.annotations;
+            const ref = this.reference;
+            const key = ref.key;
+            const alreadyPresent = annots.items.some((r) => r instanceof PdfObjectReference && r.key === key);
+            if (!alreadyPresent) {
+                annots.items.push(ref);
+            }
+        }
     }
     get children() {
         const kids = this.content.get('Kids')?.items ?? [];
         const result = [];
         for (const ref of kids) {
             const resolved = ref.resolve();
-            if (!resolved || !(resolved.content instanceof PdfDictionary))
-                continue;
             result.push(PdfFormField.create(resolved));
         }
         return result;
@@ -157,8 +181,7 @@ export class PdfFormField extends PdfWidgetAnnotation {
         return undefined;
     }
     get fieldType() {
-        const ft = this.content.get('FT')?.as(PdfName)?.value ??
-            this.parent?.content.get('FT')?.as(PdfName)?.value;
+        const ft = PdfFormField.getFieldType(this);
         switch (ft) {
             case 'Tx':
                 return 'Text';
@@ -202,6 +225,27 @@ export class PdfFormField extends PdfWidgetAnnotation {
     set defaultValue(val) {
         this.content.set('DV', new PdfString(val));
     }
+    get onStates() {
+        return this.appearanceStates.filter((s) => s !== 'Off');
+    }
+    get onState() {
+        return this.appearanceStates.find((s) => s !== 'Off') || null;
+    }
+    set onState(state) {
+        if (!this.appearanceStates.includes(state)) {
+            const currentOnState = this.onState;
+            if (currentOnState) {
+                this.appearanceStreamDict
+                    ?.get('N')
+                    ?.as(PdfDictionary)
+                    ?.move(currentOnState, state);
+            }
+            else {
+                // No existing on-state; generate a new appearance stream for the new state
+                this.generateAppearance({ onStateName: state });
+            }
+        }
+    }
     get value() {
         const v = this.content.get('V') ?? this.parent?.content.get('V');
         if (v instanceof PdfString) {
@@ -221,48 +265,51 @@ export class PdfFormField extends PdfWidgetAnnotation {
         }
         return '';
     }
-    set value(val) {
-        if (this.value === val)
-            return;
-        const fieldParent = this.parent?.content.get('FT')
-            ? this.parent
-            : undefined;
-        const generateAppearance = this._storeValue(val, fieldParent);
-        if (generateAppearance && this.defaultGenerateAppearance) {
-            this.generateAppearance();
-            for (const sibling of this.siblings) {
-                if (sibling !== this &&
-                    sibling.rect &&
-                    sibling.defaultGenerateAppearance) {
-                    sibling.generateAppearance();
-                }
+    setRawValue(val) {
+        const targets = [this];
+        const parent = this.parent;
+        if (parent?.fieldType) {
+            targets.push(parent);
+        }
+        const pdfVal = val instanceof PdfString ? val : new PdfString(val);
+        const isEmpty = pdfVal.length === 0;
+        for (const target of targets) {
+            if (isEmpty) {
+                target.content.delete('V');
+                target.appearanceState = null;
             }
-            // Separated field/widget structure: field has no Rect but its Kids
-            // are widget annotations that do. Generate appearances for them.
-            if (!this.rect) {
-                for (const child of this.children) {
-                    if (child.rect && child.defaultGenerateAppearance) {
-                        if (this._form)
-                            child.form = this._form;
-                        child.generateAppearance();
-                    }
-                }
+            else {
+                target.content.set('V', pdfVal);
             }
         }
-        if (this._form) {
-            this._form.xfa?.datasets?.updateField(this.name, this.value);
+        if (isEmpty) {
+            this._form?.xfa?.datasets?.updateField(this.name, '');
+        }
+        if (this.defaultGenerateAppearance) {
+            this.generateAppearance();
+        }
+        for (const sibling of this.siblings) {
+            if (sibling !== this && sibling.defaultGenerateAppearance) {
+                sibling.generateAppearance();
+            }
         }
+        // Separated field/widget structure: field has no Rect but its Kids
+        // are widget annotations that do. Clear stale V entries on children
+        // so they inherit the parent's value, then generate appearances.
+        for (const child of this.children) {
+            if (child.content.has('V')) {
+                child.content.delete('V');
+            }
+            if (child.defaultGenerateAppearance) {
+                if (this._form)
+                    child.form = this._form;
+                child.generateAppearance();
+            }
+        }
+        this._form?.xfa?.datasets?.updateField(this.name, this.value);
     }
-    /**
-     * Writes the value to the dictionary. Returns true if appearance generation
-     * should proceed, false to skip it (e.g. when value was cleared).
-     * Override in subclasses to change the stored representation.
-     */
-    _storeValue(val, fieldParent) {
-        const pdfVal = val instanceof PdfString ? val : new PdfString(val);
-        this.content.set('V', pdfVal);
-        fieldParent?.content.set('V', pdfVal);
-        return true;
+    set value(val) {
+        this.setRawValue(val);
     }
     get fontSize() {
         const da = this.defaultAppearance || '';
@@ -499,7 +546,7 @@ export class PdfFormField extends PdfWidgetAnnotation {
             engine: this._form?.jsEngine,
         });
     }
-    setAppearanceStream(stream) {
+    set appearanceStream(stream) {
         this.appearanceStreamDict ||= new PdfDictionary();
         if (stream instanceof PdfIndirectObject) {
             this.appearanceStreamDict.set('N', stream.reference);
@@ -512,6 +559,35 @@ export class PdfFormField extends PdfWidgetAnnotation {
             this.appearanceStreamDict.set('N', dict);
         }
     }
+    set downAppearanceStream(stream) {
+        this.appearanceStreamDict ||= new PdfDictionary();
+        if (stream instanceof PdfIndirectObject) {
+            this.appearanceStreamDict.set('D', stream.reference);
+        }
+        else {
+            const dict = new PdfDictionary();
+            for (const key in stream) {
+                dict.set(key, stream[key].reference);
+            }
+            this.appearanceStreamDict.set('D', dict);
+        }
+    }
+    get appearanceState() {
+        return this.content.get('AS')?.as(PdfName)?.value ?? null;
+    }
+    set appearanceState(state) {
+        if (state === null) {
+            this.content.delete('AS');
+            return;
+        }
+        else {
+            this.content.set('AS', new PdfName(state));
+        }
+        if (this.defaultGenerateAppearance &&
+            !this.hasAppearanceStream(state)) {
+            this.generateAppearance();
+        }
+    }
     /**
      * Returns the list of appearance state names from the normal appearance
      * dictionary (e.g. ["Yes", "Off"] for a checkbox).
@@ -519,7 +595,7 @@ export class PdfFormField extends PdfWidgetAnnotation {
     get appearanceStates() {
         const n = this.appearanceStreamDict?.get('N');
         if (n instanceof PdfDictionary) {
-            return Array.from(n.entries(), ([key]) => key);
+            return n.keys().map((k) => k.value);
         }
         return [];
     }
@@ -534,9 +610,7 @@ export class PdfFormField extends PdfWidgetAnnotation {
             }
         }
         else if (n instanceof PdfDictionary) {
-            const key = setting ??
-                this.content.get('AS')?.as(PdfName)?.value ??
-                undefined;
+            const key = setting ?? this.appearanceState ?? undefined;
             if (key) {
                 const entry = n.get(key);
                 if (entry instanceof PdfObjectReference) {
@@ -549,6 +623,9 @@ export class PdfFormField extends PdfWidgetAnnotation {
         }
         return null;
     }
+    hasAppearanceStream(setting) {
+        return this.appearanceStates.includes(setting);
+    }
     static _fallbackCtor;
     static _registry = new Map();
     static registerFieldType(ft, ctor, options) {

package/dist/acroform/fields/pdf-text-form-field.js

@@ -24,7 +24,7 @@ export class PdfTextFormField extends PdfFormField {
         const fontResources = this.buildFontResources(parsed.fontName);
         const isUnicode = font?.isUnicode ?? false;
         const reverseEncodingMap = font?.reverseEncodingMap;
-        this.setAppearanceStream(new PdfTextAppearanceStream({
+        this.appearanceStream = new PdfTextAppearanceStream({
             rect: rect,
             value: this.value,
             da: parsed,
@@ -34,7 +34,7 @@ export class PdfTextFormField extends PdfFormField {
             fontResources,
             isUnicode,
             reverseEncodingMap,
-        }));
+        });
         if (options?.makeReadOnly) {
             this.readOnly = true;
             if (!this.print)

package/dist/acroform/pdf-acro-form.d.ts

@@ -36,6 +36,7 @@ export declare class PdfAcroForm<T extends Record<string, string> = Record<strin
     set defaultResources(resources: PdfDefaultResourcesDictionary | null);
     get fields(): ReadonlyArray<PdfFormField>;
     addField(...fields: PdfFormField[]): void;
+    private _addWidgetToPage;
     set fields(newFields: PdfFormField[]);
     setValues(values: Partial<T>): void;
     importData(fields: T): void;

package/dist/acroform/pdf-acro-form.js

@@ -108,13 +108,24 @@ export class PdfAcroForm extends PdfIndirectObject {
         }
         for (const field of fields) {
             fieldsArray.items.push(field.reference);
-            // Auto-add to the page's Annots array
-            const page = field.page;
-            if (page) {
-                page.annotations.items.push(field.reference);
+            this._addWidgetToPage(field);
+            // Also register any child widgets (e.g. radio button group kids)
+            for (const child of field.children) {
+                this._addWidgetToPage(child);
             }
         }
     }
+    _addWidgetToPage(field) {
+        const page = field.page;
+        if (!page)
+            return;
+        const ref = field.reference;
+        const key = ref.key;
+        const alreadyPresent = page.annotations.items.some((r) => r instanceof PdfObjectReference && r.key === key);
+        if (!alreadyPresent) {
+            page.annotations.items.push(ref);
+        }
+    }
     set fields(newFields) {
         this.content.set('Fields', PdfArray.refs(newFields));
     }