pdf-lite 1.4.0 → 1.5.0

package/dist/core/streams/object-stream.js

@@ -1,4 +1,4 @@
-import { IterableReadableStream } from '../../utils/IterableReadableStream.js';
+import { IterableReadableStream } from '../../utils/iterable-readable-stream.js';
 import { pdfDecoderAsync } from '../generators.js';
 export class PdfObjectStream extends IterableReadableStream {
     constructor(input) {

package/dist/errors.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Error thrown when the parser needs more input to continue parsing.
+ */
+export declare class NoMoreTokensError extends Error {
+}
+/**
+ * Error thrown when the end of file has been reached and no more input is available.
+ */
+export declare class EofReachedError extends Error {
+}
+/**
+ * Error thrown when an unexpected token is encountered during parsing.
+ */
+export declare class UnexpectedTokenError extends Error {
+    constructor(expected: string, actual: string | null);
+}
+/**
+ * Error thrown when attempting to access a compressed object
+ * that requires decompression from an object stream.
+ */
+export declare class FoundCompressedObjectError extends Error {
+}

package/dist/errors.js

@@ -0,0 +1,24 @@
+/**
+ * Error thrown when the parser needs more input to continue parsing.
+ */
+export class NoMoreTokensError extends Error {
+}
+/**
+ * Error thrown when the end of file has been reached and no more input is available.
+ */
+export class EofReachedError extends Error {
+}
+/**
+ * Error thrown when an unexpected token is encountered during parsing.
+ */
+export class UnexpectedTokenError extends Error {
+    constructor(expected, actual) {
+        super(`Unexpected token: expected ${expected}, but got ${actual === null ? 'EOF' : actual}`);
+    }
+}
+/**
+ * Error thrown when attempting to access a compressed object
+ * that requires decompression from an object stream.
+ */
+export class FoundCompressedObjectError extends Error {
+}

package/dist/fonts/index.d.ts

@@ -1,4 +1,4 @@
 export * from './types.js';
-export * from './font-manager.js';
+export * from './manager.js';
 export * from './pdf-font.js';
 export * from './parsers/index.js';

package/dist/fonts/index.js

@@ -1,4 +1,4 @@
 export * from './types.js';
-export * from './font-manager.js';
+export * from './manager.js';
 export * from './pdf-font.js';
 export * from './parsers/index.js';

package/dist/fonts/pdf-font.d.ts

@@ -4,9 +4,10 @@ import { PdfName } from '../core/objects/pdf-name.js';
 import { PdfNumber } from '../core/objects/pdf-number.js';
 import { PdfArray } from '../core/objects/pdf-array.js';
 import { PdfObjectReference } from '../core/objects/pdf-object-reference.js';
-import type { PdfFontManager } from './font-manager.js';
+import type { PdfFontManager } from './manager.js';
 import type { FontDescriptor, UnicodeFontDescriptor, FontParser } from './types.js';
 import type { ByteArray } from '../types.js';
+type PdfStandardFontName = 'Helvetica' | 'Helvetica-Bold' | 'Helvetica-Oblique' | 'Helvetica-BoldOblique' | 'Times-Roman' | 'Times-Bold' | 'Times-Italic' | 'Times-BoldItalic' | 'Courier' | 'Courier-Bold' | 'Courier-Oblique' | 'Courier-BoldOblique' | 'Symbol' | 'ZapfDingbats';
 /**
  * Represents an embedded font in a PDF document.
  * Extends PdfDictionary to provide both font metadata and PDF dictionary structure.
@@ -38,11 +39,6 @@ export declare class PdfFont extends PdfDictionary<{
      * Includes FontDescriptor, FontFile2, CIDFont, ToUnicode, etc.
      */
     protected auxiliaryObjects: PdfIndirectObject[];
-    /**
-     * @internal
-     * Reference to the font manager that created this font.
-     */
-    private manager?;
     /**
      * @internal
      * Font descriptor with metrics and properties.
@@ -53,6 +49,7 @@ export declare class PdfFont extends PdfDictionary<{
      * Original font file bytes.
      */
     private _fontData?;
+    constructor(fontName: string);
     constructor(options: {
         dict?: PdfDictionary;
         fontName?: string;
@@ -109,6 +106,39 @@ export declare class PdfFont extends PdfDictionary<{
      * Sets the character widths array.
      */
     set widths(values: number[] | undefined);
+    /**
+     * 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: number): number | 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: number, fontSize: number): number | 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: number): boolean;
+    /**
+     * 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: string, fontSize: number): (number | null)[];
     /**
      * Returns the resource name for string coercion.
      * This enables using PdfFont objects in template literals like:
@@ -150,9 +180,35 @@ export declare 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: 'Helvetica' | 'Helvetica-Bold' | 'Helvetica-Oblique' | 'Helvetica-BoldOblique' | 'Times-Roman' | 'Times-Bold' | 'Times-Italic' | 'Times-BoldItalic' | 'Courier' | 'Courier-Bold' | 'Courier-Oblique' | 'Courier-BoldOblique' | 'Symbol' | 'ZapfDingbats'): PdfFont;
+    static fromStandardFont(fontName: PdfStandardFontName, widths?: number[]): PdfFont;
+    private static readonly _HELVETICA_WIDTHS;
+    private static readonly _HELVETICA_BOLD_WIDTHS;
+    private static readonly _TIMES_ROMAN_WIDTHS;
+    private static readonly _TIMES_BOLD_WIDTHS;
+    private static readonly _TIMES_ITALIC_WIDTHS;
+    private static readonly _TIMES_BOLD_ITALIC_WIDTHS;
+    static readonly HELVETICA: PdfFont;
+    static readonly HELVETICA_BOLD: PdfFont;
+    static readonly HELVETICA_OBLIQUE: PdfFont;
+    static readonly HELVETICA_BOLD_OBLIQUE: PdfFont;
+    static readonly TIMES_ROMAN: PdfFont;
+    static readonly TIMES_BOLD: PdfFont;
+    static readonly TIMES_ITALIC: PdfFont;
+    static readonly TIMES_BOLD_ITALIC: PdfFont;
+    static readonly COURIER: PdfFont;
+    static readonly COURIER_BOLD: PdfFont;
+    static readonly COURIER_OBLIQUE: PdfFont;
+    static readonly COURIER_BOLD_OBLIQUE: PdfFont;
+    static readonly SYMBOL: PdfFont;
+    static readonly ZAPF_DINGBATS: PdfFont;
+    private static readonly BY_BASE_FONT;
+    /**
+     * Returns the static PdfFont instance for a standard font name, or null if not found.
+     */
+    static getStandardFont(fontName: string): PdfFont | null;
     /**
      * Creates a TrueType font from font file data.
      * Uses WinAnsiEncoding for standard 8-bit character support.
@@ -183,3 +239,4 @@ export declare class PdfFont extends PdfDictionary<{
      */
     private static buildCIDWidthArray;
 }
+export {};

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';

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';

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

@@ -13,7 +13,7 @@ import { PdfDocumentSecurityStoreObject } from '../signing/document-security-sto
 import { ByteArray } from '../types.js';
 import { PdfDocumentVerificationResult, PdfSigner } from '../signing/signer.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.
@@ -246,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.

package/dist/pdf/pdf-document.js

@@ -14,11 +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 { 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.
@@ -593,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.

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.4.0",
+  "version": "1.5.0",
   "main": "dist/index.js",
   "type": "module",
   "exports": {