pdf-lite 1.3.3 → 1.5.0

package/dist/fonts/pdf-font.js

@@ -27,11 +27,6 @@ export class PdfFont extends PdfDictionary {
      * Includes FontDescriptor, FontFile2, CIDFont, ToUnicode, etc.
      */
     auxiliaryObjects = [];
-    /**
-     * @internal
-     * Reference to the font manager that created this font.
-     */
-    manager;
     /**
      * @internal
      * Font descriptor with metrics and properties.
@@ -42,15 +37,22 @@ export class PdfFont extends PdfDictionary {
      * Original font file bytes.
      */
     _fontData;
-    constructor(options) {
+    constructor(optionsOrFontName) {
         super();
+        // Handle string parameter (simple fontName)
+        if (typeof optionsOrFontName === 'string') {
+            this.fontName = optionsOrFontName;
+            this.resourceName = optionsOrFontName;
+            return;
+        }
+        // Handle options object (existing behavior)
+        const options = optionsOrFontName;
         if (options.dict) {
             this.copyFrom(options.dict);
         }
         this.fontName = options.fontName;
         this.resourceName = options.resourceName ?? '';
         this.encoding = options.encoding;
-        this.manager = options.manager;
         this.container = options.container;
         this._descriptor = options.descriptor;
         this._fontData = options.fontData;
@@ -169,6 +171,60 @@ export class PdfFont extends PdfDictionary {
             this.delete('Widths');
         }
     }
+    /**
+     * Gets the raw character width (in 1000-unit em square) for a character code.
+     * Returns null if the character is not in the font's width table.
+     *
+     * @param charCode - The character code to get the width for
+     * @returns The raw character width or null if not found
+     */
+    getRawCharacterWidth(charCode) {
+        if (this.widths === undefined || this.firstChar === undefined) {
+            return null;
+        }
+        const widthIndex = charCode - this.firstChar;
+        if (widthIndex >= 0 && widthIndex < this.widths.length) {
+            return this.widths[widthIndex];
+        }
+        return null;
+    }
+    /**
+     * Gets the character width scaled to the specified font size.
+     * Returns null if the character is not in the font's width table.
+     *
+     * @param charCode - The character code to get the width for
+     * @param fontSize - The font size to scale to
+     * @returns The scaled character width or null if not found
+     */
+    getCharacterWidth(charCode, fontSize) {
+        const rawWidth = this.getRawCharacterWidth(charCode);
+        return rawWidth !== null ? (rawWidth * fontSize) / 1000 : null;
+    }
+    /**
+     * Checks if the font has width data for a character code.
+     *
+     * @param charCode - The character code to check
+     * @returns True if width data is available, false otherwise
+     */
+    hasCharacterWidth(charCode) {
+        return this.getRawCharacterWidth(charCode) !== null;
+    }
+    /**
+     * Gets character widths for all characters in a string.
+     * Returns null for characters not in the font's width table.
+     *
+     * @param text - The text to get character widths for
+     * @param fontSize - The font size to scale to
+     * @returns Array of character widths (null for missing characters)
+     */
+    getCharacterWidthsForString(text, fontSize) {
+        const widths = [];
+        for (const char of text) {
+            const charCode = char.charCodeAt(0);
+            widths.push(this.getCharacterWidth(charCode, fontSize));
+        }
+        return widths;
+    }
     /**
      * Returns the resource name for string coercion.
      * This enables using PdfFont objects in template literals like:
@@ -235,16 +291,140 @@ export class PdfFont extends PdfDictionary {
      * These fonts don't require font data as they're built into PDF viewers.
      *
      * @param fontName - One of the 14 standard PDF fonts
+     * @param widths - Optional AFM widths array (1/1000 em units) for chars 32–126
      * @returns A PdfFont instance ready to be written to the PDF
      */
-    static fromStandardFont(fontName) {
+    static fromStandardFont(fontName, widths) {
         const font = new PdfFont({ fontName });
         // Build Type1 font dictionary
         font.set('Type', new PdfName('Font'));
         font.set('Subtype', new PdfName('Type1'));
         font.set('BaseFont', new PdfName(fontName));
+        if (widths) {
+            font.firstChar = 32;
+            font.lastChar = 32 + widths.length - 1;
+            font.widths = widths;
+        }
         return font;
     }
+    // Helvetica AFM widths, chars 32–126 (95 values, 1/1000 em units)
+    static _HELVETICA_WIDTHS = [
+        278, 278, 355, 556, 556, 889, 667, 191, 333, 333, 389, 584, 278, 333,
+        278, 278, 556, 556, 556, 556, 556, 556, 556, 556, 556, 556, 278, 278,
+        584, 584, 584, 556, 1015, 667, 667, 722, 722, 667, 611, 778, 722, 278,
+        500, 667, 556, 833, 722, 778, 667, 778, 722, 667, 611, 722, 667, 944,
+        667, 667, 611, 278, 278, 278, 469, 556, 333, 556, 556, 500, 556, 556,
+        278, 556, 556, 222, 222, 500, 222, 833, 556, 556, 556, 556, 333, 500,
+        278, 556, 500, 722, 500, 500, 500, 334, 260, 334, 584,
+    ];
+    // Helvetica-Bold AFM widths, chars 32–126
+    static _HELVETICA_BOLD_WIDTHS = [
+        278, 333, 474, 556, 556, 889, 722, 238, 333, 333, 389, 584, 278, 333,
+        278, 278, 556, 556, 556, 556, 556, 556, 556, 556, 556, 556, 333, 333,
+        584, 584, 584, 611, 975, 722, 722, 722, 722, 667, 611, 778, 722, 278,
+        556, 722, 611, 833, 722, 778, 667, 778, 722, 667, 611, 722, 667, 944,
+        667, 667, 611, 333, 278, 333, 584, 556, 333, 556, 611, 556, 611, 556,
+        333, 611, 611, 278, 278, 556, 278, 889, 611, 611, 611, 611, 389, 556,
+        333, 611, 556, 778, 556, 556, 500, 389, 280, 389, 584,
+    ];
+    // Times-Roman AFM widths, chars 32–126
+    static _TIMES_ROMAN_WIDTHS = [
+        250, 333, 408, 500, 500, 833, 778, 180, 333, 333, 500, 564, 250, 333,
+        250, 278, 500, 500, 500, 500, 500, 500, 500, 500, 500, 500, 278, 278,
+        564, 564, 564, 444, 921, 722, 667, 667, 722, 611, 556, 722, 722, 333,
+        389, 722, 611, 889, 722, 722, 556, 722, 667, 556, 611, 722, 722, 944,
+        722, 722, 611, 333, 278, 333, 469, 500, 333, 444, 500, 444, 500, 444,
+        333, 500, 500, 278, 278, 500, 278, 778, 500, 500, 500, 500, 333, 389,
+        278, 500, 500, 722, 500, 500, 444, 480, 200, 480, 541,
+    ];
+    // Times-Bold AFM widths, chars 32–126
+    static _TIMES_BOLD_WIDTHS = [
+        250, 333, 555, 500, 500, 1000, 833, 278, 333, 333, 500, 570, 250, 333,
+        250, 278, 500, 500, 500, 500, 500, 500, 500, 500, 500, 500, 333, 333,
+        570, 570, 570, 500, 930, 722, 667, 722, 722, 667, 611, 778, 778, 389,
+        500, 778, 667, 944, 722, 778, 611, 778, 722, 556, 667, 722, 722, 1000,
+        722, 722, 667, 333, 278, 333, 581, 500, 333, 500, 556, 444, 556, 444,
+        333, 500, 556, 278, 333, 556, 278, 833, 556, 500, 556, 556, 444, 389,
+        333, 556, 500, 722, 500, 500, 444, 394, 220, 394, 520,
+    ];
+    // Times-Italic AFM widths, chars 32–126
+    static _TIMES_ITALIC_WIDTHS = [
+        250, 333, 420, 500, 500, 833, 778, 214, 333, 333, 500, 675, 250, 333,
+        250, 278, 500, 500, 500, 500, 500, 500, 500, 500, 500, 500, 333, 333,
+        675, 675, 675, 500, 920, 611, 611, 667, 722, 611, 611, 722, 722, 333,
+        444, 667, 556, 833, 667, 722, 611, 722, 611, 500, 556, 722, 611, 833,
+        611, 556, 556, 389, 278, 389, 422, 500, 333, 500, 500, 444, 500, 444,
+        278, 500, 500, 278, 278, 444, 278, 722, 500, 500, 500, 500, 389, 389,
+        278, 500, 444, 667, 444, 444, 389, 400, 275, 400, 541,
+    ];
+    // Times-BoldItalic AFM widths, chars 32–126
+    static _TIMES_BOLD_ITALIC_WIDTHS = [
+        250, 389, 555, 500, 500, 833, 778, 278, 333, 333, 500, 570, 250, 333,
+        250, 278, 500, 500, 500, 500, 500, 500, 500, 500, 500, 500, 333, 333,
+        570, 570, 570, 500, 832, 667, 667, 667, 722, 667, 667, 722, 778, 389,
+        500, 667, 611, 889, 722, 722, 611, 722, 667, 556, 611, 722, 667, 889,
+        667, 611, 611, 333, 278, 333, 570, 500, 333, 500, 500, 444, 500, 444,
+        333, 500, 556, 278, 278, 500, 278, 778, 556, 500, 500, 500, 389, 389,
+        278, 556, 444, 667, 500, 444, 389, 348, 220, 348, 570,
+    ];
+    static HELVETICA = PdfFont.fromStandardFont('Helvetica', [
+        ...PdfFont._HELVETICA_WIDTHS,
+    ]);
+    static HELVETICA_BOLD = PdfFont.fromStandardFont('Helvetica-Bold', [...PdfFont._HELVETICA_BOLD_WIDTHS]);
+    static HELVETICA_OBLIQUE = PdfFont.fromStandardFont('Helvetica-Oblique', [...PdfFont._HELVETICA_WIDTHS]);
+    static HELVETICA_BOLD_OBLIQUE = PdfFont.fromStandardFont('Helvetica-BoldOblique', [...PdfFont._HELVETICA_BOLD_WIDTHS]);
+    static TIMES_ROMAN = PdfFont.fromStandardFont('Times-Roman', [
+        ...PdfFont._TIMES_ROMAN_WIDTHS,
+    ]);
+    static TIMES_BOLD = PdfFont.fromStandardFont('Times-Bold', [
+        ...PdfFont._TIMES_BOLD_WIDTHS,
+    ]);
+    static TIMES_ITALIC = PdfFont.fromStandardFont('Times-Italic', [
+        ...PdfFont._TIMES_ITALIC_WIDTHS,
+    ]);
+    static TIMES_BOLD_ITALIC = PdfFont.fromStandardFont('Times-BoldItalic', [...PdfFont._TIMES_BOLD_ITALIC_WIDTHS]);
+    static COURIER = PdfFont.fromStandardFont('Courier', Array(95).fill(600));
+    static COURIER_BOLD = PdfFont.fromStandardFont('Courier-Bold', Array(95).fill(600));
+    static COURIER_OBLIQUE = PdfFont.fromStandardFont('Courier-Oblique', Array(95).fill(600));
+    static COURIER_BOLD_OBLIQUE = PdfFont.fromStandardFont('Courier-BoldOblique', Array(95).fill(600));
+    static SYMBOL = PdfFont.fromStandardFont('Symbol');
+    static ZAPF_DINGBATS = PdfFont.fromStandardFont('ZapfDingbats');
+    static BY_BASE_FONT = new Map([
+        ['Helvetica', PdfFont.HELVETICA],
+        ['Helv', PdfFont.HELVETICA], // Alias for backward compatibility with old code using 'Helv'
+        ['Helvetica-Bold', PdfFont.HELVETICA_BOLD],
+        ['Helv-Bold', PdfFont.HELVETICA_BOLD], // Alias for backward compatibility with old code using 'Helv-Bold'
+        ['Helvetica-Oblique', PdfFont.HELVETICA_OBLIQUE],
+        ['Helv-Oblique', PdfFont.HELVETICA_OBLIQUE], // Alias for backward compatibility with old code using 'Helv-Oblique'
+        ['Helvetica-BoldOblique', PdfFont.HELVETICA_BOLD_OBLIQUE],
+        ['Helv-BoldOblique', PdfFont.HELVETICA_BOLD_OBLIQUE], // Alias for backward compatibility with old code using 'Helv-BoldOblique'
+        ['Times-Roman', PdfFont.TIMES_ROMAN],
+        ['TiRo', PdfFont.TIMES_ROMAN],
+        ['Times-Bold', PdfFont.TIMES_BOLD],
+        ['TiBo', PdfFont.TIMES_BOLD],
+        ['Times-Italic', PdfFont.TIMES_ITALIC],
+        ['TiIt', PdfFont.TIMES_ITALIC],
+        ['Times-BoldItalic', PdfFont.TIMES_BOLD_ITALIC],
+        ['TiBI', PdfFont.TIMES_BOLD_ITALIC],
+        ['Courier', PdfFont.COURIER],
+        ['Cour', PdfFont.COURIER], // Alias for backward compatibility with old code using 'Cour'
+        ['Courier-Bold', PdfFont.COURIER_BOLD],
+        ['Cour-Bold', PdfFont.COURIER_BOLD], // Alias for backward compatibility with old code using 'Cour-Bold'
+        ['Courier-Oblique', PdfFont.COURIER_OBLIQUE],
+        ['Cour-Oblique', PdfFont.COURIER_OBLIQUE], // Alias for backward compatibility with old code using 'Cour-Oblique'
+        ['Courier-BoldOblique', PdfFont.COURIER_BOLD_OBLIQUE],
+        ['Cour-BoldOblique', PdfFont.COURIER_BOLD_OBLIQUE], // Alias for backward compatibility with old code using 'Cour-BoldOblique'
+        ['Symbol', PdfFont.SYMBOL],
+        ['ZapfDingbats', PdfFont.ZAPF_DINGBATS],
+        ['ZaDb', PdfFont.ZAPF_DINGBATS],
+    ]);
+    /**
+     * Returns the static PdfFont instance for a standard font name, or null if not found.
+     */
+    static getStandardFont(fontName) {
+        const font = PdfFont.BY_BASE_FONT.get(fontName);
+        return font ?? null;
+    }
     /**
      * Creates a TrueType font from font file data.
      * Uses WinAnsiEncoding for standard 8-bit character support.

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from './types.js';
+export * from './errors.js';
 export * from './core/index.js';
 export * from './crypto/index.js';
 export * from './filters/index.js';
@@ -7,3 +8,4 @@ export * from './pdf/index.js';
 export * from './security/index.js';
 export * from './signing/index.js';
 export * from './utils/index.js';
+export * from './annotations/index.js';

package/dist/index.js

@@ -1,4 +1,5 @@
 export * from './types.js';
+export * from './errors.js';
 export * from './core/index.js';
 export * from './crypto/index.js';
 export * from './filters/index.js';
@@ -7,3 +8,4 @@ export * from './pdf/index.js';
 export * from './security/index.js';
 export * from './signing/index.js';
 export * from './utils/index.js';
+export * from './annotations/index.js';

package/dist/pdf/index.d.ts

@@ -1,4 +1,3 @@
-export * from './errors.js';
 export * from './pdf-document.js';
 export * from './pdf-reader.js';
 export * from './pdf-revision.js';

package/dist/pdf/index.js

@@ -1,4 +1,3 @@
-export * from './errors.js';
 export * from './pdf-document.js';
 export * from './pdf-reader.js';
 export * from './pdf-revision.js';

package/dist/pdf/pdf-document.d.ts

@@ -12,9 +12,8 @@ import { PdfTrailerEntries } from '../core/objects/pdf-trailer.js';
 import { PdfDocumentSecurityStoreObject } from '../signing/document-security-store.js';
 import { ByteArray } from '../types.js';
 import { PdfDocumentVerificationResult, PdfSigner } from '../signing/signer.js';
-import { PdfXfaManager } from '../xfa/manager.js';
 import { PdfAcroFormManager } from '../acroform/manager.js';
-import { PdfFontManager } from '../fonts/font-manager.js';
+import { PdfFontManager } from '../fonts/manager.js';
 /**
  * Represents a PDF document with support for reading, writing, and modifying PDF files.
  * Handles document structure, revisions, encryption, and digital signatures.
@@ -39,9 +38,9 @@ export declare class PdfDocument extends PdfObject {
     signer: PdfSigner;
     /** Security handler for encryption/decryption operations */
     securityHandler?: PdfSecurityHandler;
-    private _xfa?;
-    private _acroForm?;
-    private _fonts?;
+    /**  */
+    readonly acroForm: PdfAcroFormManager;
+    readonly fonts: PdfFontManager;
     private hasEncryptionDictionary?;
     private toBeCommitted;
     /**
@@ -65,12 +64,6 @@ export declare class PdfDocument extends PdfObject {
     });
     get header(): PdfComment | undefined;
     set header(comment: PdfComment | undefined);
-    /** XFA manager for handling XFA forms */
-    get xfa(): PdfXfaManager;
-    /** AcroForm manager for handling form fields */
-    get acroForm(): PdfAcroFormManager;
-    /** Font manager for embedding and managing fonts */
-    get fonts(): PdfFontManager;
     /**
      * Creates a PdfDocument from an array of PDF objects.
      * Parses objects into revisions based on EOF comments.
@@ -93,6 +86,16 @@ export declare class PdfDocument extends PdfObject {
      * @param objects - PDF objects to add to the document
      */
     add(...objects: PdfObject[]): void;
+    /**
+     * Packs non-stream indirect objects into compressed ObjStm containers.
+     * Objects that already have an object number are left unchanged.
+     * Appearance streams and other PdfStream objects must NOT be passed here —
+     * only non-stream indirect objects (dictionaries, arrays, etc.) are eligible.
+     *
+     * @param objects - Non-stream indirect objects to compress into ObjStm
+     * @param batchSize - Maximum objects per ObjStm container (default 100)
+     */
+    addObjectsAsStream(objects: PdfIndirectObject[], batchSize?: number): void;
     /**
      * Gets the latest (most recent) revision of the document.
      *
@@ -243,6 +246,7 @@ export declare class PdfDocument extends PdfObject {
      * @param newObjects - Additional objects to add before committing
      */
     commit(...newObjects: PdfObject[]): Promise<void>;
+    private ensureEncryptionDictionary;
     /**
      * Sets the Document Security Store (DSS) for the document.
      * Used for long-term validation of digital signatures.
@@ -284,7 +288,7 @@ export declare class PdfDocument extends PdfObject {
      *
      * @returns A cloned PdfDocument instance
      */
-    clone(): this;
+    cloneImpl(): this;
     /**
      * Creates a PdfDocument from a byte stream.
      *

package/dist/pdf/pdf-document.js

@@ -14,12 +14,11 @@ import { PdfByteOffsetToken } from '../core/tokens/byte-offset-token.js';
 import { PdfNumberToken } from '../core/tokens/number-token.js';
 import { PdfXRefTableEntryToken } from '../core/tokens/xref-table-entry-token.js';
 import { PdfStartXRef } from '../core/objects/pdf-start-xref.js';
-import { FoundCompressedObjectError } from './errors.js';
+import { FoundCompressedObjectError } from '../errors.js';
 import { PdfReader } from './pdf-reader.js';
 import { PdfSigner } from '../signing/signer.js';
-import { PdfXfaManager } from '../xfa/manager.js';
 import { PdfAcroFormManager } from '../acroform/manager.js';
-import { PdfFontManager } from '../fonts/font-manager.js';
+import { PdfFontManager } from '../fonts/manager.js';
 import { concatUint8Arrays } from '../utils/concatUint8Arrays.js';
 /**
  * Represents a PDF document with support for reading, writing, and modifying PDF files.
@@ -45,9 +44,9 @@ export class PdfDocument extends PdfObject {
     signer;
     /** Security handler for encryption/decryption operations */
     securityHandler;
-    _xfa;
-    _acroForm;
-    _fonts;
+    /**  */
+    acroForm;
+    fonts;
     hasEncryptionDictionary = false;
     toBeCommitted = [];
     /**
@@ -81,6 +80,8 @@ export class PdfDocument extends PdfObject {
         this.calculateOffsets();
         this.securityHandler =
             options?.securityHandler ?? this.getSecurityHandler();
+        this.acroForm = new PdfAcroFormManager(this);
+        this.fonts = new PdfFontManager(this);
     }
     get header() {
         return this.revisions[0].header;
@@ -89,27 +90,6 @@ export class PdfDocument extends PdfObject {
         if (comment)
             this.revisions[0].header = comment;
     }
-    /** XFA manager for handling XFA forms */
-    get xfa() {
-        if (!this._xfa) {
-            this._xfa = new PdfXfaManager(this);
-        }
-        return this._xfa;
-    }
-    /** AcroForm manager for handling form fields */
-    get acroForm() {
-        if (!this._acroForm) {
-            this._acroForm = new PdfAcroFormManager(this);
-        }
-        return this._acroForm;
-    }
-    /** Font manager for embedding and managing fonts */
-    get fonts() {
-        if (!this._fonts) {
-            this._fonts = new PdfFontManager(this);
-        }
-        return this._fonts;
-    }
     /**
      * Creates a PdfDocument from an array of PDF objects.
      * Parses objects into revisions based on EOF comments.
@@ -170,6 +150,36 @@ export class PdfDocument extends PdfObject {
             this.latestRevision.addObject(obj);
         }
     }
+    /**
+     * Packs non-stream indirect objects into compressed ObjStm containers.
+     * Objects that already have an object number are left unchanged.
+     * Appearance streams and other PdfStream objects must NOT be passed here —
+     * only non-stream indirect objects (dictionaries, arrays, etc.) are eligible.
+     *
+     * @param objects - Non-stream indirect objects to compress into ObjStm
+     * @param batchSize - Maximum objects per ObjStm container (default 100)
+     */
+    addObjectsAsStream(objects, batchSize = 100) {
+        if (objects.length === 0)
+            return;
+        for (let start = 0; start < objects.length; start += batchSize) {
+            const batch = objects.slice(start, Math.min(start + batchSize, objects.length));
+            // Pre-assign a contiguous block of object numbers for the batch
+            const xref = this.latestRevision.xref;
+            const startNum = xref.reserveObjectNumbers(batch.length);
+            for (let i = 0; i < batch.length; i++) {
+                if (!batch[i].inPdf()) {
+                    batch[i].objectNumber = startNum + i;
+                }
+            }
+            // Build the ObjStm and apply FlateDecode compression
+            const objStream = PdfObjStream.fromObjects(batch);
+            objStream.addFilter('FlateDecode');
+            // Add the container — xref.addObject() auto-registers children as type-2 entries
+            const container = new PdfIndirectObject({ content: objStream });
+            this.add(container);
+        }
+    }
     /**
      * Gets the latest (most recent) revision of the document.
      *
@@ -583,20 +593,24 @@ export class PdfDocument extends PdfObject {
                 newObject instanceof PdfIndirectObject &&
                 this.isObjectEncryptable(newObject)) {
                 await this.securityHandler.write();
-                if (!this.hasEncryptionDictionary) {
-                    const encryptionDictObject = new PdfIndirectObject({
-                        content: this.securityHandler.dict,
-                        encryptable: false,
-                    });
-                    this.latestRevision.addObject(encryptionDictObject);
-                    this.trailerDict.set('Encrypt', encryptionDictObject.reference);
-                    this.hasEncryptionDictionary = true;
-                }
+                this.ensureEncryptionDictionary();
                 await this.securityHandler.encryptObject(newObject);
             }
         }
         await this.update();
     }
+    ensureEncryptionDictionary() {
+        if (this.hasEncryptionDictionary) {
+            return;
+        }
+        const encryptionDictObject = new PdfIndirectObject({
+            content: this.securityHandler.dict,
+            encryptable: false,
+        });
+        this.latestRevision.addObject(encryptionDictObject);
+        this.trailerDict.set('Encrypt', encryptionDictObject.reference);
+        this.hasEncryptionDictionary = true;
+    }
     /**
      * Sets the Document Security Store (DSS) for the document.
      * Used for long-term validation of digital signatures.
@@ -729,7 +743,7 @@ export class PdfDocument extends PdfObject {
      *
      * @returns A cloned PdfDocument instance
      */
-    clone() {
+    cloneImpl() {
         const clonedRevisions = this.revisions.map((rev) => rev.clone());
         return new PdfDocument({
             revisions: clonedRevisions,

package/dist/pdf/pdf-revision.d.ts

@@ -124,7 +124,7 @@ export declare class PdfRevision extends PdfObject {
      *
      * @returns A cloned PdfRevision instance
      */
-    clone(): this;
+    cloneImpl(): this;
     protected tokenize(): PdfToken[];
     toBytes(): ByteArray;
 }

package/dist/pdf/pdf-revision.js

@@ -250,7 +250,7 @@ export class PdfRevision extends PdfObject {
      *
      * @returns A cloned PdfRevision instance
      */
-    clone() {
+    cloneImpl() {
         const clonedObjects = this.objects.map((obj) => obj.clone());
         return new PdfRevision({ objects: clonedObjects });
     }

package/dist/pdf/pdf-xref-lookup.d.ts

@@ -110,6 +110,14 @@ export declare class PdfXrefLookup {
      * @returns The updated xref object
      */
     update(): PdfIndirectObject<PdfXRefStream> | PdfXRefTable;
+    /**
+     * Reserves a contiguous block of object numbers without registering objects.
+     * Use this to pre-assign numbers to objects that will live inside an ObjStm.
+     *
+     * @param count - Number of object numbers to reserve
+     * @returns The first reserved object number
+     */
+    reserveObjectNumbers(count: number): number;
     /**
      * Adds an indirect object to the xref lookup.
      * Assigns an object number if not already set.

package/dist/pdf/pdf-xref-lookup.js

@@ -305,6 +305,18 @@ export class PdfXrefLookup {
         this.object = newObject;
         return this.object;
     }
+    /**
+     * Reserves a contiguous block of object numbers without registering objects.
+     * Use this to pre-assign numbers to objects that will live inside an ObjStm.
+     *
+     * @param count - Number of object numbers to reserve
+     * @returns The first reserved object number
+     */
+    reserveObjectNumbers(count) {
+        const startNum = this.size;
+        this.size += count;
+        return startNum;
+    }
     /**
      * Adds an indirect object to the xref lookup.
      * Assigns an object number if not already set.

package/dist/security/handlers/base.js

@@ -87,11 +87,14 @@ export class PdfSecurityHandler {
             else if (obj instanceof PdfString) {
                 const decryptedData = await this.decrypt('string', obj.raw, objectNumber, generationNumber);
                 obj.raw = decryptedData;
+                obj.setModified(false);
             }
             else if (obj instanceof PdfStream) {
                 const decryptedData = await this.decrypt('stream', obj.raw, objectNumber, generationNumber);
                 obj.raw = decryptedData;
                 await decryptObject(obj.header);
+                obj.setModified(false);
+                obj.header.setModified(false);
             }
             else if (obj instanceof PdfDictionary) {
                 const values = obj.values;

package/dist/utils/encodePdfText.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Encodes a text string for use in a PDF content stream text operator (`Tj`).
+ *
+ * PDF literal strings `(...)` in content streams are raw bytes interpreted by the
+ * font's encoding — NOT UTF-8. This function produces the correct PDF string token:
+ *
+ * - Type0/Identity-H fonts: hex string `<XXXX...>` with 2 bytes per character (CID = Unicode codepoint)
+ * - Single-byte fonts: PDF literal `(...)` with octal escapes `\ooo` for byte values ≥ 0x80,
+ *   using the reverse encoding map when available for characters outside the Latin-1 range.
+ *
+ * @param text - The Unicode text to encode
+ * @param isUnicode - True if the font uses Type0/Identity-H encoding (2-byte CID per character)
+ * @param reverseEncodingMap - Optional map from Unicode character to byte code,
+ *   derived by inverting the font's Differences-based encoding map
+ * @returns A PDF string token ready to use before `Tj`, e.g. `<0050> Tj` or `(text) Tj`
+ */
+export declare function encodePdfText(text: string, isUnicode: boolean, reverseEncodingMap?: Map<string, number>): string;

package/dist/utils/encodePdfText.js

@@ -0,0 +1,61 @@
+/**
+ * Encodes a text string for use in a PDF content stream text operator (`Tj`).
+ *
+ * PDF literal strings `(...)` in content streams are raw bytes interpreted by the
+ * font's encoding — NOT UTF-8. This function produces the correct PDF string token:
+ *
+ * - Type0/Identity-H fonts: hex string `<XXXX...>` with 2 bytes per character (CID = Unicode codepoint)
+ * - Single-byte fonts: PDF literal `(...)` with octal escapes `\ooo` for byte values ≥ 0x80,
+ *   using the reverse encoding map when available for characters outside the Latin-1 range.
+ *
+ * @param text - The Unicode text to encode
+ * @param isUnicode - True if the font uses Type0/Identity-H encoding (2-byte CID per character)
+ * @param reverseEncodingMap - Optional map from Unicode character to byte code,
+ *   derived by inverting the font's Differences-based encoding map
+ * @returns A PDF string token ready to use before `Tj`, e.g. `<0050> Tj` or `(text) Tj`
+ */
+export function encodePdfText(text, isUnicode, reverseEncodingMap) {
+    if (isUnicode) {
+        // Type0 / Identity-H: 2-byte big-endian CID per code point
+        let hex = '<';
+        for (const char of text) {
+            const code = char.codePointAt(0) ?? 0;
+            hex += code.toString(16).padStart(4, '0');
+        }
+        return hex + '>';
+    }
+    // Single-byte font: PDF literal string with octal escapes for non-ASCII bytes
+    let result = '(';
+    for (const char of text) {
+        const code = char.charCodeAt(0);
+        if (code === 0x28) {
+            result += '\\('; // (
+        }
+        else if (code === 0x29) {
+            result += '\\)'; // )
+        }
+        else if (code === 0x5c) {
+            result += '\\\\'; // \
+        }
+        else if (code === 0x0a) {
+            result += '\\n';
+        }
+        else if (code === 0x0d) {
+            result += '\\r';
+        }
+        else if (code < 0x80) {
+            result += char; // ASCII: safe to write directly
+        }
+        else if (reverseEncodingMap?.has(char)) {
+            // Custom font encoding (Differences): use the mapped byte code
+            const byteCode = reverseEncodingMap.get(char);
+            result += '\\' + byteCode.toString(8).padStart(3, '0');
+        }
+        else if (code <= 0xff) {
+            // Latin-1 range: encode as octal so UTF-8 serialisation doesn't mangle it
+            result += '\\' + code.toString(8).padStart(3, '0');
+        }
+        // Characters above 0xFF with no mapping are silently dropped
+    }
+    return result + ')';
+}

package/dist/utils/index.d.ts

@@ -1,4 +1,4 @@
-export * from './IterableReadableStream.js';
+export * from './iterable-readable-stream.js';
 export * from './algos.js';
 export * from './assert.js';
 export * from './bytesToHex.js';

package/dist/utils/index.js

@@ -1,4 +1,4 @@
-export * from './IterableReadableStream.js';
+export * from './iterable-readable-stream.js';
 export * from './algos.js';
 export * from './assert.js';
 export * from './bytesToHex.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pdf-lite",
-  "version": "1.3.3",
+  "version": "1.5.0",
   "main": "dist/index.js",
   "type": "module",
   "exports": {