pdf-lite 1.6.1 → 1.6.3

package/EXAMPLES.md

@@ -1989,3 +1989,292 @@ async function main() {
 
 main().catch(console.error)
 ```
+
+## JavaScript Actions example - Executing JS actions in PDF form fields
+
+```typescript
+//
+// PDF forms generated by Adobe Acrobat and LiveCycle often include JavaScript
+// actions for formatting, validation, and field calculations. The
+// PdfJavaScriptEngine executes these automatically when setting field values,
+// with built-in support for common Acrobat JS functions.
+
+import { PdfArray } from 'pdf-lite/core/objects/pdf-array'
+import { PdfBoolean } from 'pdf-lite/core/objects/pdf-boolean'
+import { PdfDictionary } from 'pdf-lite/core/objects/pdf-dictionary'
+import { PdfIndirectObject } from 'pdf-lite/core/objects/pdf-indirect-object'
+import { PdfName } from 'pdf-lite/core/objects/pdf-name'
+import { PdfNumber } from 'pdf-lite/core/objects/pdf-number'
+import { PdfObjectReference } from 'pdf-lite/core/objects/pdf-object-reference'
+import { PdfStream } from 'pdf-lite/core/objects/pdf-stream'
+import { PdfString } from 'pdf-lite/core/objects/pdf-string'
+import { PdfDocument } from 'pdf-lite/pdf/pdf-document'
+import { PdfJavaScriptEngine } from 'pdf-lite/acroform/js/pdf-js-engine-impl'
+import fs from 'fs/promises'
+
+const tmpFolder = `${import.meta.dirname}/tmp`
+await fs.mkdir(tmpFolder, { recursive: true })
+
+// ============================================
+// Helpers
+// ============================================
+
+function createPage(
+    contentStreamRef: PdfObjectReference,
+): PdfIndirectObject<PdfDictionary> {
+    const d = new PdfDictionary()
+    d.set('Type', new PdfName('Page'))
+    d.set(
+        'MediaBox',
+        new PdfArray([
+            new PdfNumber(0),
+            new PdfNumber(0),
+            new PdfNumber(612),
+            new PdfNumber(792),
+        ]),
+    )
+    d.set('Contents', contentStreamRef)
+    return new PdfIndirectObject({ content: d })
+}
+
+function createPages(
+    pages: PdfIndirectObject<PdfDictionary>[],
+): PdfIndirectObject<PdfDictionary> {
+    const d = new PdfDictionary()
+    d.set('Type', new PdfName('Pages'))
+    d.set('Kids', new PdfArray(pages.map((x) => x.reference)))
+    d.set('Count', new PdfNumber(pages.length))
+    return new PdfIndirectObject({ content: d })
+}
+
+function createCatalog(
+    pagesRef: PdfObjectReference,
+): PdfIndirectObject<PdfDictionary> {
+    const d = new PdfDictionary()
+    d.set('Type', new PdfName('Catalog'))
+    d.set('Pages', pagesRef)
+    return new PdfIndirectObject({ content: d })
+}
+
+/** Create a text field with an optional JavaScript format action. */
+function createTextField(
+    fieldName: string,
+    pageRef: PdfObjectReference,
+    rect: [number, number, number, number],
+    jsFormatCode?: string,
+    jsCalcCode?: string,
+): PdfIndirectObject<PdfDictionary> {
+    const d = new PdfDictionary()
+    d.set('Type', new PdfName('Annot'))
+    d.set('Subtype', new PdfName('Widget'))
+    d.set('FT', new PdfName('Tx'))
+    d.set('T', new PdfString(fieldName))
+    d.set(
+        'Rect',
+        new PdfArray([
+            new PdfNumber(rect[0]),
+            new PdfNumber(rect[1]),
+            new PdfNumber(rect[2]),
+            new PdfNumber(rect[3]),
+        ]),
+    )
+    d.set('F', new PdfNumber(4))
+    d.set('P', pageRef)
+    d.set('DA', new PdfString('/Helv 12 Tf 0 g'))
+
+    // Add /AA (additional actions) dictionary with JS format/calculate actions
+    if (jsFormatCode || jsCalcCode) {
+        const aa = new PdfDictionary()
+        if (jsFormatCode) {
+            const fmtAction = new PdfDictionary()
+            fmtAction.set('S', new PdfName('JavaScript'))
+            fmtAction.set('JS', new PdfString(jsFormatCode))
+            aa.set('F', fmtAction)
+        }
+        if (jsCalcCode) {
+            const calcAction = new PdfDictionary()
+            calcAction.set('S', new PdfName('JavaScript'))
+            calcAction.set('JS', new PdfString(jsCalcCode))
+            aa.set('C', calcAction)
+        }
+        d.set('AA', aa)
+    }
+
+    return new PdfIndirectObject({ content: d })
+}
+
+// ============================================
+// Build a PDF with JS-powered form fields
+// ============================================
+
+const document = new PdfDocument()
+
+// Font
+const font = new PdfDictionary()
+font.set('Type', new PdfName('Font'))
+font.set('Subtype', new PdfName('Type1'))
+font.set('BaseFont', new PdfName('Helvetica'))
+const fontObj = new PdfIndirectObject({ content: font })
+document.add(fontObj)
+
+// Resources
+const resources = new PdfDictionary()
+const fontDict = new PdfDictionary()
+fontDict.set('F1', fontObj.reference)
+resources.set('Font', fontDict)
+const resourcesObj = new PdfIndirectObject({ content: resources })
+document.add(resourcesObj)
+
+// Content stream with labels
+const contentStream = new PdfIndirectObject({
+    content: new PdfStream({
+        header: new PdfDictionary(),
+        original: `BT
+/F1 18 Tf 72 720 Td (Invoice - JS Actions Demo) Tj
+/F1 12 Tf 0 -50 Td (Price:) Tj
+0 -30 Td (Quantity:) Tj
+0 -30 Td (Total:) Tj
+0 -40 Td (Phone:) Tj
+ET `,
+    }),
+})
+document.add(contentStream)
+
+// Page
+const page = createPage(contentStream.reference)
+page.content.set('Resources', resourcesObj.reference)
+document.add(page)
+
+// Form fields with JavaScript actions:
+
+// Price field — formats as currency via AFNumber_Format
+const priceField = createTextField(
+    'Price',
+    page.reference,
+    [150, 655, 350, 675],
+    'AFNumber_Format(2, 0, 0, 0, "$", true)',
+)
+document.add(priceField)
+
+// Quantity field — plain number format
+const qtyField = createTextField(
+    'Quantity',
+    page.reference,
+    [150, 625, 350, 645],
+    'AFNumber_Format(0, 0, 0, 0, "", false)',
+)
+document.add(qtyField)
+
+// Total field — calculated as Price * Quantity via AFSimple_Calculate
+const totalField = createTextField(
+    'Total',
+    page.reference,
+    [150, 595, 350, 615],
+    'AFNumber_Format(2, 0, 0, 0, "$", true)',
+    'AFSimple_Calculate("PRD", ["Price", "Quantity"])',
+)
+document.add(totalField)
+
+// Phone field — formatted via AFSpecial_Format (phone)
+const phoneField = createTextField(
+    'Phone',
+    page.reference,
+    [150, 555, 350, 575],
+    'AFSpecial_Format(2)',
+)
+document.add(phoneField)
+
+// Annotations on page
+page.content.set(
+    'Annots',
+    new PdfArray([
+        priceField.reference,
+        qtyField.reference,
+        totalField.reference,
+        phoneField.reference,
+    ]),
+)
+
+// Pages / catalog
+const pages = createPages([page])
+page.content.set('Parent', pages.reference)
+document.add(pages)
+
+const catalog = createCatalog(pages.reference)
+
+// AcroForm with fields and calculation order
+const acroForm = new PdfDictionary()
+acroForm.set(
+    'Fields',
+    new PdfArray([
+        priceField.reference,
+        qtyField.reference,
+        totalField.reference,
+        phoneField.reference,
+    ]),
+)
+// Calculation order — Total depends on Price and Quantity
+acroForm.set('CO', new PdfArray([totalField.reference]))
+acroForm.set('NeedAppearances', new PdfBoolean(true))
+
+// Form default resources
+const formResources = new PdfDictionary()
+const formFontDict = new PdfDictionary()
+const helvetica = new PdfDictionary()
+helvetica.set('Type', new PdfName('Font'))
+helvetica.set('Subtype', new PdfName('Type1'))
+helvetica.set('BaseFont', new PdfName('Helvetica'))
+const helveticaObj = new PdfIndirectObject({ content: helvetica })
+document.add(helveticaObj)
+formFontDict.set('Helv', helveticaObj.reference)
+formResources.set('Font', formFontDict)
+acroForm.set('DR', formResources)
+acroForm.set('DA', new PdfString('/Helv 12 Tf 0 g'))
+
+const acroFormObj = new PdfIndirectObject({ content: acroForm })
+document.add(acroFormObj)
+catalog.content.set('AcroForm', acroFormObj.reference)
+document.add(catalog)
+document.trailerDict.set('Root', catalog.reference)
+
+await document.finalize()
+await fs.writeFile(`${tmpFolder}/js-actions-form.pdf`, document.toBytes())
+console.log('Created js-actions-form.pdf with JavaScript action fields')
+
+// ============================================
+// Fill the form with the JS engine enabled
+// ============================================
+
+const formBytes = await fs.readFile(`${tmpFolder}/js-actions-form.pdf`)
+const filledDoc = await PdfDocument.fromBytes([formBytes])
+const form = filledDoc.acroform!
+
+// Attach the JS engine with a field value resolver for AFSimple_Calculate
+form.jsEngine = new PdfJavaScriptEngine({
+    getFieldValue: (name) => {
+        const field = form.fields.find((f) => f.name === name)
+        return field?.value ?? ''
+    },
+})
+
+// Set values — JS format actions fire automatically
+form.setValues({
+    Price: '49.99',
+    Quantity: '3',
+    Phone: '5551234567',
+})
+
+// Print resulting values (after JS actions have run)
+console.log('\nField values after JS actions:')
+for (const field of form.fields) {
+    console.log(`  ${field.name}: "${field.value}"`)
+}
+// Expected output:
+//   Price: "$49.99"
+//   Quantity: "3"
+//   Total: "$149.97"  (calculated via AFSimple_Calculate PRD)
+//   Phone: "(555) 123-4567"  (formatted via AFSpecial_Format)
+
+await fs.writeFile(`${tmpFolder}/js-actions-filled.pdf`, filledDoc.toBytes())
+console.log('\nCreated js-actions-filled.pdf with JS-formatted values')
+```

package/README.md

@@ -52,7 +52,7 @@ import { PdfArray } from 'pdf-lite/core/objects/pdf-array'
 import { PdfNumber } from 'pdf-lite/core/objects/pdf-number'
 
 // Create the document
-const document = new PdfDocument()
+const doc = new PdfDocument()
 
 // Create content stream
 const contentStream = new PdfIndirectObject({
@@ -62,12 +62,12 @@ const contentStream = new PdfIndirectObject({
     }),
 })
 
-// Create and commit objects
-document.commit(contentStream)
+// Create and add objects
+doc.add(contentStream)
 // ... create pages, catalog, etc.
 
 // Output the PDF
-console.log(document.toString())
+console.log(doc.toString())
 ```
 
 ### Working with Encryption
@@ -92,6 +92,103 @@ await document.encrypt()
 console.log(document.toString())
 ```
 
+### Filling AcroForms
+
+```typescript
+import { PdfDocument } from 'pdf-lite/pdf/pdf-document'
+import { readFile, writeFile } from 'fs/promises'
+
+const pdfBytes = await readFile('form.pdf')
+const doc = await PdfDocument.fromBytes([pdfBytes])
+
+const form = doc.acroform
+if (!form) throw new Error('No AcroForm found')
+
+// Set multiple field values at once
+form.setValues({
+    name: 'John Doe',
+    email: 'john@example.com',
+    subscribe: 'Yes', // checkbox: 'Yes' or 'Off'
+})
+
+// Or work with individual fields
+const field = form.fields.find((f) => f.name === 'name')
+if (field) field.value = 'Jane Doe'
+
+// Export all current values
+const values = form.exportData()
+// => { name: 'Jane Doe', email: 'john@example.com', subscribe: 'Yes' }
+
+await writeFile('filled.pdf', doc.toBytes())
+```
+
+### Generating Appearances
+
+Appearance streams control how form fields render visually. The library can automatically generate them when field values are set, or you can generate them manually.
+
+```typescript
+import { PdfButtonFormField } from 'pdf-lite/acroform/fields/pdf-button-form-field'
+import { PdfChoiceFormField } from 'pdf-lite/acroform/fields/pdf-choice-form-field'
+import { PdfAcroForm } from 'pdf-lite/acroform/pdf-acro-form'
+import { PdfTextFormField } from 'pdf-lite/acroform/fields/pdf-text-form-field'
+
+declare const form: PdfAcroForm
+declare const field: PdfTextFormField
+
+// Auto-generate appearances when setting values (default behavior)
+field.value = 'Hello' // appearance is generated automatically
+
+// Or generate manually with options
+field.generateAppearance({ makeReadOnly: true })
+
+// Configure font and size for a field
+field.fontSize = 14
+field.fontName = 'Helv'
+
+// For checkbox fields
+const checkbox = form.fields.find(
+    (f) => f.name === 'agree',
+) as PdfButtonFormField
+checkbox.checked = true
+checkbox.generateAppearance()
+
+// For choice fields (dropdowns/listboxes)
+const dropdown = form.fields.find(
+    (f) => f.name === 'country',
+) as PdfChoiceFormField
+dropdown.value = 'US'
+dropdown.generateAppearance()
+```
+
+### Working with Fonts
+
+```typescript
+import { PdfFont } from 'pdf-lite'
+import { PdfDocument } from 'pdf-lite/pdf/pdf-document'
+import { readFileSync } from 'fs'
+
+// Standard PDF fonts (built into all PDF readers)
+const helvetica = PdfFont.fromStandardFont('Helvetica')
+const timesBold = PdfFont.fromStandardFont('Times-Bold')
+const courier = PdfFont.fromStandardFont('Courier')
+
+// Embed custom fonts from file bytes (auto-detects TTF, OTF, WOFF)
+const fontData = readFileSync('MyFont.ttf')
+const customFont = PdfFont.fromBytes(fontData)
+
+// Use pre-defined font constants
+const font = PdfFont.HELVETICA_BOLD
+
+// Assign resource names for use in content streams
+customFont.resourceName = 'F1'
+
+// Add to document
+const doc = new PdfDocument()
+doc.add(customFont)
+```
+
+**Standard font names:** Helvetica, Helvetica-Bold, Helvetica-Oblique, Helvetica-BoldOblique, Times-Roman, Times-Bold, Times-Italic, Times-BoldItalic, Courier, Courier-Bold, Courier-Oblique, Courier-BoldOblique, Symbol, ZapfDingbats
+
 ### Signing PDFs
 
 ```typescript
@@ -187,14 +284,57 @@ Long-Term Validation (LTV) support ensures that digital signatures remain valid
 - [x] Timestamping
 - [x] Verification of existing signatures
 
-### AcroForm filling
+### AcroForms
+
+Supports reading, filling, and creating AcroForm fields within PDF documents.
 
-Supports filling out AcroForm forms within PDF documents, allowing for dynamic content generation and user interaction.
+**Field types:**
 
-- [x] Text fields
+- [x] Text fields (single-line, multi-line, comb, password)
 - [x] Checkboxes
 - [x] Radio buttons
-- [x] Dropdowns
+- [x] Dropdowns (combo boxes)
+- [x] List boxes
+- [x] Signature fields
+
+**Form operations:**
+
+- [x] Import/export field values (`importData`, `exportData`, `setValues`)
+- [x] Read individual field properties (name, value, type, flags)
+- [x] Hierarchical field support (parent/child/sibling fields)
+
+**JavaScript actions:**
+
+- [x] JavaScript action execution via `PdfJavaScriptEngine`
+- [x] Validate, keystroke, calculate, and format action triggers
+- [x] Built-in Acrobat JS functions: `util.printd`, `util.scand`, `util.printf`
+- [x] `AFNumber_Format` / `AFNumber_Keystroke` — number formatting and validation
+- [x] `AFDate_FormatEx` / `AFDate_KeystrokeEx` — date formatting and validation
+- [x] `AFSimple_Calculate` — SUM, AVG, PRD, MIN, MAX across fields
+- [x] `AFSpecial_Format` / `AFSpecial_Keystroke` — zip, SSN, phone formatting
+
+### Appearance Streams
+
+Automatic generation of visual appearance streams for form fields, so filled forms render correctly in all PDF viewers without relying on `NeedAppearances`.
+
+- [x] Text field rendering (word wrap, auto-sizing, comb layout)
+- [x] Checkbox/radio button rendering
+- [x] Dropdown/list box rendering
+- [x] Font resolution from field, form, or document resources
+- [x] Auto-size font (fontSize=0) for single-line text fields
+- [x] Custom font color via Default Appearance strings
+
+### Fonts
+
+Supports standard PDF fonts and embedding custom fonts.
+
+- [x] All 14 standard PDF fonts (Helvetica, Times, Courier, Symbol, ZapfDingbats + variants)
+- [x] TrueType font embedding (TTF)
+- [x] OpenType font embedding (OTF, non-CFF)
+- [x] WOFF font embedding
+- [x] Auto-detect font format via `PdfFont.fromBytes()`
+- [x] Font encoding maps (WinAnsi, Unicode/Identity-H)
+- [x] Character width metrics
 
 ### XFA Forms
 

package/dist/acroform/appearance/pdf-graphics.js

@@ -192,13 +192,14 @@ export class PdfGraphics {
         const startSize = this.currentFont.size;
         const minSize = 0.5;
         const fits = (size) => {
-            if (this.measureTextWidth(text, size) > maxWidth)
-                return false;
             if (maxHeight !== undefined) {
+                // Wrapping mode: text is allowed to span multiple lines,
+                // so only check that the wrapped result fits the box.
                 const lines = this.wrapTextToLines(text, maxWidth, size);
                 return lines.length * size * lineHeight <= maxHeight;
             }
-            return true;
+            // Single-line mode: text must fit within maxWidth.
+            return this.measureTextWidth(text, size) <= maxWidth;
         };
         if (fits(startSize))
             return startSize;

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

@@ -1,6 +1,7 @@
 import { PdfDefaultAppearance } from '../fields/pdf-default-appearance.js';
 import { PdfAppearanceStream } from './pdf-appearance-stream.js';
 import { PdfGraphics } from './pdf-graphics.js';
+const DEFAULT_FONT_SIZE = 12;
 /**
  * Appearance stream for text fields (single-line, multiline, comb).
  * Enhanced with word wrapping and automatic font scaling.
@@ -16,29 +17,44 @@ export class PdfTextAppearanceStream extends PdfAppearanceStream {
         const padding = 2;
         const availableWidth = width - 2 * padding;
         const availableHeight = height - 2 * padding;
+        const autoSize = ctx.da.fontSize <= 0;
         // Create graphics with font context for text measurement
         const g = new PdfGraphics({
             resolvedFonts: ctx.resolvedFonts,
         });
         g.beginMarkedContent();
         g.save();
-        // Set initial font to enable measurement
-        g.setDefaultAppearance(ctx.da);
-        let finalFontSize = ctx.da.fontSize;
-        let lines = [];
-        if (ctx.multiline) {
+        // Bootstrap with a reference size so measureTextWidth works
+        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
+            // shrink only if the wrapped text still doesn't fit.
+            finalFontSize = DEFAULT_FONT_SIZE;
             const testLines = g.wrapTextToLines(value, availableWidth);
-            const lineHeight = finalFontSize * 1.2;
-            if (testLines.length * lineHeight > availableHeight) {
-                // Scale font down to fit
+            if (testLines.length * DEFAULT_FONT_SIZE * 1.2 > availableHeight) {
                 finalFontSize = g.calculateFittingFontSize(value, availableWidth, availableHeight, 1.2);
-                const adjustedDA = new PdfDefaultAppearance(ctx.da.fontName, finalFontSize, ctx.da.colorOp);
-                g.setDefaultAppearance(adjustedDA);
-                lines = g.wrapTextToLines(value, availableWidth);
             }
-            else {
-                lines = testLines;
+            finalFontSize = Math.max(finalFontSize, 0.5);
+        }
+        else {
+            finalFontSize = ctx.da.fontSize;
+        }
+        // ── Render ───────────────────────────────────────────────────
+        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();
@@ -53,7 +69,6 @@ export class PdfTextAppearanceStream extends PdfAppearanceStream {
         else if (ctx.comb && ctx.maxLen) {
             const cellWidth = width / ctx.maxLen;
             const chars = [...value];
-            // Calculate font size to fit the widest character in its cell
             let maxCharWidth = 0;
             let widestChar = chars[0] ?? '';
             for (const char of chars) {
@@ -65,8 +80,7 @@ export class PdfTextAppearanceStream extends PdfAppearanceStream {
             }
             if (maxCharWidth > cellWidth) {
                 finalFontSize = g.calculateFittingFontSize(widestChar, cellWidth);
-                const adjustedDA = new PdfDefaultAppearance(ctx.da.fontName, finalFontSize, ctx.da.colorOp);
-                g.setDefaultAppearance(adjustedDA);
+                g.setDefaultAppearance(new PdfDefaultAppearance(ctx.da.fontName, finalFontSize, ctx.da.colorOp));
             }
             const textY = (height - finalFontSize) / 2 + finalFontSize * 0.2;
             g.beginText();
@@ -79,12 +93,13 @@ export class PdfTextAppearanceStream extends PdfAppearanceStream {
             g.endText();
         }
         else {
-            // Single line text
-            const textWidth = g.measureTextWidth(value);
-            if (textWidth > availableWidth) {
-                finalFontSize = g.calculateFittingFontSize(value, availableWidth);
-                const adjustedDA = new PdfDefaultAppearance(ctx.da.fontName, finalFontSize, ctx.da.colorOp);
-                g.setDefaultAppearance(adjustedDA);
+            // Single line — for non-auto-size, shrink if text overflows
+            if (!autoSize) {
+                const textWidth = g.measureTextWidth(value);
+                if (textWidth > availableWidth) {
+                    finalFontSize = g.calculateFittingFontSize(value, availableWidth);
+                    g.setDefaultAppearance(new PdfDefaultAppearance(ctx.da.fontName, finalFontSize, ctx.da.colorOp));
+                }
             }
             const textY = (height - finalFontSize) / 2 + finalFontSize * 0.2;
             g.beginText();

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

@@ -20,20 +20,35 @@ export class PdfButtonFormField extends PdfFormField {
             this.content.delete('AS');
             return false;
         }
-        this.content.set('V', new PdfName(strVal));
-        fieldParent?.content.set('V', new PdfName(strVal));
-        this.content.set('AS', new PdfName(strVal));
+        // 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;
+        }
+        else if (strVal === 'Off' || strVal === 'No') {
+            resolved = 'Off';
+        }
+        else {
+            resolved = states.find((s) => s !== 'Off') ?? 'Yes';
+        }
+        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 === 'Yes';
+        return v instanceof PdfName && v.value !== 'Off';
     }
     set checked(isChecked) {
         const target = this.parent ?? this;
         if (isChecked) {
-            target.content.set('V', new PdfName('Yes'));
-            this.content.set('AS', new PdfName('Yes'));
+            const onState = this.appearanceStates.find((s) => s !== 'Off') ?? 'Yes';
+            target.content.set('V', new PdfName(onState));
+            this.content.set('AS', new PdfName(onState));
         }
         else {
             target.content.set('V', new PdfName('Off'));
@@ -56,8 +71,9 @@ export class PdfButtonFormField extends PdfFormField {
             height,
             contentStream: '',
         });
+        const onState = this.appearanceStates.find((s) => s !== 'Off') ?? 'Yes';
         this.setAppearanceStream({
-            Yes: yesAppearance,
+            [onState]: yesAppearance,
             Off: noAppearance,
         });
         if (options?.makeReadOnly) {

package/dist/acroform/fields/pdf-default-appearance.js

@@ -50,10 +50,7 @@ export class PdfDefaultAppearance extends PdfString {
         if (!fontMatch)
             return null;
         const fontName = fontMatch[1];
-        let fontSize = parseFloat(fontMatch[2]);
-        if (!fontSize || fontSize <= 0) {
-            fontSize = 12;
-        }
+        const fontSize = parseFloat(fontMatch[2]) || 0;
         let colorOp = '0 g';
         const rgMatch = da.match(/([\d.]+\s+[\d.]+\s+[\d.]+)\s+rg/);
         const gMatch = da.match(/([\d.]+)\s+g/);