pdf-lite 1.3.3 → 1.5.0

package/dist/core/objects/pdf-null.d.ts

@@ -3,5 +3,5 @@ import { PdfNullToken } from '../tokens/null-token.js';
 export declare class PdfNull extends PdfObject {
     static readonly NULL: PdfNull;
     protected tokenize(): PdfNullToken[];
-    clone(): this;
+    cloneImpl(): this;
 }

package/dist/core/objects/pdf-null.js

@@ -5,7 +5,8 @@ export class PdfNull extends PdfObject {
     tokenize() {
         return [new PdfNullToken()];
     }
-    clone() {
-        return new PdfNull();
+    cloneImpl() {
+        const cloned = new PdfNull();
+        return cloned;
     }
 }

package/dist/core/objects/pdf-number.d.ts

@@ -17,7 +17,7 @@ export declare class PdfNumber extends PdfObject {
     onChange(callback: (value: number) => void): void;
     toToken(): PdfNumberToken;
     protected tokenize(): PdfNumberToken[];
-    clone(): this;
+    cloneImpl(): this;
     isModified(): boolean;
 }
 export declare class PdfByteOffsetNumber extends PdfNumber {

package/dist/core/objects/pdf-number.js

@@ -64,12 +64,13 @@ export class PdfNumber extends PdfObject {
     tokenize() {
         return [this.toToken()];
     }
-    clone() {
-        return new PdfNumber({
+    cloneImpl() {
+        const cloned = new PdfNumber({
             value: this.value,
             padTo: this.padTo,
             decimalPlaces: this.decimalPlaces,
         });
+        return cloned;
     }
     isModified() {
         return super.isModified() || this.#value.isModified;

package/dist/core/objects/pdf-object-reference.d.ts

@@ -5,5 +5,5 @@ export declare class PdfObjectReference extends PdfObject {
     generationNumber: number;
     constructor(objectNumber: number, generationNumber: number);
     protected tokenize(): PdfToken[];
-    clone(): this;
+    cloneImpl(): this;
 }

package/dist/core/objects/pdf-object-reference.js

@@ -13,7 +13,8 @@ export class PdfObjectReference extends PdfObject {
             new PdfObjectReferenceToken(this.objectNumber, this.generationNumber),
         ];
     }
-    clone() {
-        return new PdfObjectReference(this.objectNumber, this.generationNumber);
+    cloneImpl() {
+        const cloned = new PdfObjectReference(this.objectNumber, this.generationNumber);
+        return cloned;
     }
 }

package/dist/core/objects/pdf-object.d.ts

@@ -29,8 +29,10 @@ export declare abstract class PdfObject {
     toString(): string;
     /** Attempts to cast the object to a specific PdfObject subclass */
     as<T extends PdfObject>(ctor: new (...args: any[]) => T): T;
+    /** Creates a deep clone of the object. Override this method in subclasses to ensure all properties are cloned correctly */
+    protected abstract cloneImpl(): this;
     /** Creates a deep clone of the object */
-    abstract clone(): this;
+    clone(): this;
     /** Compares this object to another for equality based on their token representations */
     equals(other?: PdfObject): boolean;
 }

package/dist/core/objects/pdf-object.js

@@ -63,6 +63,12 @@ export class PdfObject {
         }
         throw new Error(`Cannot cast object of type ${this.objectType} to ${ctor.name}`);
     }
+    /** Creates a deep clone of the object */
+    clone() {
+        const cloned = this.cloneImpl();
+        cloned.setModified(this.modified);
+        return cloned;
+    }
     /** Compares this object to another for equality based on their token representations */
     equals(other) {
         if (!other) {

package/dist/core/objects/pdf-start-xref.d.ts

@@ -5,6 +5,6 @@ export declare class PdfStartXRef extends PdfObject {
     offset: PdfNumber;
     constructor(offset?: number | PdfNumber | Ref<number>);
     protected tokenize(): import("../index.js").PdfToken[];
-    clone(): this;
+    cloneImpl(): this;
     isModified(): boolean;
 }

package/dist/core/objects/pdf-start-xref.js

@@ -23,8 +23,9 @@ export class PdfStartXRef extends PdfObject {
             ...this.offset.toTokens(),
         ];
     }
-    clone() {
-        return new PdfStartXRef(this.offset.clone());
+    cloneImpl() {
+        const cloned = new PdfStartXRef(this.offset.clone());
+        return cloned;
     }
     isModified() {
         return super.isModified() || this.offset.isModified();

package/dist/core/objects/pdf-stream.d.ts

@@ -20,6 +20,7 @@ export declare class PdfStream<T extends PdfDictionary = PdfDictionary> extends
     set raw(data: ByteArray);
     get originalAsString(): string;
     get rawAsString(): string;
+    set rawAsString(str: string);
     getFilters(): PdfStreamFilterType[];
     addFilter(filterName: PdfStreamFilterType): this;
     setPredictor(predictorParams: {
@@ -53,7 +54,7 @@ export declare class PdfStream<T extends PdfDictionary = PdfDictionary> extends
         readonly Crypt: PdfFilter;
     };
     static applyFilters(data: ByteArray, filters: PdfStreamFilterType[]): ByteArray;
-    clone(): this;
+    cloneImpl(): this;
     static fromString(data: string): PdfStream;
 }
 export declare class PdfObjStream extends PdfStream {
@@ -68,7 +69,7 @@ export declare class PdfObjStream extends PdfStream {
         objectNumber: number;
     }): PdfIndirectObject | undefined;
     getObjects(): PdfIndirectObject[];
-    clone(): this;
+    cloneImpl(): this;
 }
 export declare class PdfXRefStreamCompressedEntry {
     objectNumber: PdfNumber;
@@ -97,5 +98,5 @@ export declare class PdfXRefStream extends PdfStream {
     getEntryStream(): Generator<PdfXRefStreamEntry>;
     getEntries(): PdfXRefStreamEntry[];
     private readInt;
-    clone(): this;
+    cloneImpl(): this;
 }

package/dist/core/objects/pdf-stream.js

@@ -17,6 +17,7 @@ import { bytesToPdfObjects } from '../generators.js';
 import { PdfIndirectObject } from './pdf-indirect-object.js';
 import { PdfXRefTableEntry } from './pdf-xref-table.js';
 import { stringToBytes } from '../../utils/stringToBytes.js';
+import { bytesToString } from '../../utils/bytesToString.js';
 export class PdfStream extends PdfObject {
     header;
     original;
@@ -52,10 +53,13 @@ export class PdfStream extends PdfObject {
         this.header.set('Length', new PdfNumber(data.length));
     }
     get originalAsString() {
-        return new TextDecoder().decode(this.original);
+        return bytesToString(this.original);
     }
     get rawAsString() {
-        return new TextDecoder().decode(this.raw);
+        return bytesToString(this.raw);
+    }
+    set rawAsString(str) {
+        this.raw = stringToBytes(str);
     }
     getFilters() {
         const filters = this.header.get('Filter');
@@ -217,7 +221,7 @@ export class PdfStream extends PdfObject {
         }
         return result;
     }
-    clone() {
+    cloneImpl() {
         return new PdfStream({
             header: this.header.clone(),
             original: new Uint8Array(this.original),
@@ -238,23 +242,48 @@ export class PdfObjStream extends PdfStream {
         }
     }
     static fromObjects(objects) {
-        let header = '';
-        let objectData = '';
+        const objByteChunks = [];
+        const headerParts = [];
         let offset = 0;
+        let objectCount = 0;
         for (const obj of objects) {
-            header += `${obj.objectNumber} ${offset} `;
-            const objString = obj.content.toString();
-            objectData += objString + '\n';
-            offset += objString.length + 1;
-        }
+            // Use toBytes() to preserve binary content (e.g. UTF-16BE strings)
+            // instead of toString() which is Latin-1 and would be re-encoded as UTF-8
+            headerParts.push(`${obj.objectNumber} ${offset}`);
+            const bytes = obj.content.toBytes();
+            objByteChunks.push(bytes, new Uint8Array([0x0a])); // object + newline
+            offset += bytes.length + 1;
+            objectCount++;
+        }
+        const headerStr = headerParts.join(' ');
+        // First = byte offset of first compressed object from stream start
+        const first = objectCount > 0 ? headerStr.length + 1 : 0;
         const headerDict = new PdfDictionary();
         headerDict.set('Type', new PdfName('ObjStm'));
-        headerDict.set('N', new PdfNumber(header.length));
-        headerDict.set('First', new PdfNumber(offset));
-        objectData = `${header.trim()}\n${objectData.trim()}`;
+        headerDict.set('N', new PdfNumber(objectCount));
+        headerDict.set('First', new PdfNumber(first));
+        if (objectCount === 0) {
+            return new PdfObjStream({
+                header: headerDict,
+                original: new Uint8Array(),
+            });
+        }
+        // Build stream bytes: headerStr + '\n' + obj1bytes + obj2bytes + ...
+        // Drop trailing newline after the last object
+        objByteChunks.pop();
+        const headerBytes = stringToBytes(headerStr + '\n');
+        const totalLength = objByteChunks.reduce((sum, chunk) => sum + chunk.length, headerBytes.length);
+        const streamBytes = new Uint8Array(totalLength);
+        let pos = 0;
+        streamBytes.set(headerBytes, pos);
+        pos += headerBytes.length;
+        for (const chunk of objByteChunks) {
+            streamBytes.set(chunk, pos);
+            pos += chunk.length;
+        }
         return new PdfObjStream({
             header: headerDict,
-            original: objectData,
+            original: streamBytes,
         });
     }
     *getObjectStream() {
@@ -302,7 +331,7 @@ export class PdfObjStream extends PdfStream {
     getObjects() {
         return Array.from(this.getObjectStream());
     }
-    clone() {
+    cloneImpl() {
         return new PdfObjStream({
             header: this.header.clone(),
             original: new Uint8Array(this.original),
@@ -528,7 +557,7 @@ export class PdfXRefStream extends PdfStream {
         }
         return value;
     }
-    clone() {
+    cloneImpl() {
         return new PdfXRefStream({
             header: this.header.clone(),
             original: new Uint8Array(this.original),

package/dist/core/objects/pdf-string.d.ts

@@ -19,7 +19,8 @@ export declare class PdfString extends PdfObject {
      * UTF-16BE strings start with the byte order mark 0xFE 0xFF.
      */
     get isUTF16BE(): boolean;
+    set value(str: string);
     get value(): string;
     protected tokenize(): PdfStringToken[];
-    clone(): this;
+    cloneImpl(): this;
 }

package/dist/core/objects/pdf-string.js

@@ -52,6 +52,20 @@ export class PdfString extends PdfObject {
     get isUTF16BE() {
         return (this.raw.length >= 2 && this.raw[0] === 0xfe && this.raw[1] === 0xff);
     }
+    set value(str) {
+        if (this.isImmutable()) {
+            throw new Error('Cannot modify an immutable PdfString');
+        }
+        this.setModified();
+        if (needsUnicodeEncoding(str)) {
+            this._raw = encodeAsUTF16BE(str);
+        }
+        else {
+            this._raw = encodeToPDFDocEncoding(str);
+        }
+        // Clear original bytes when modified
+        this._originalBytes = undefined;
+    }
     get value() {
         // Check for UTF-16BE BOM (0xFE 0xFF)
         if (this.isUTF16BE) {
@@ -63,9 +77,10 @@ export class PdfString extends PdfObject {
     tokenize() {
         return [new PdfStringToken(this.raw, this._originalBytes)];
     }
-    clone() {
-        return new PdfString(new Uint8Array(this.raw), this._originalBytes
+    cloneImpl() {
+        const cloned = new PdfString(new Uint8Array(this.raw), this._originalBytes
             ? new Uint8Array(this._originalBytes)
             : undefined);
+        return cloned;
     }
 }

package/dist/core/objects/pdf-trailer.d.ts

@@ -21,6 +21,6 @@ export declare class PdfTrailer extends PdfObject {
     offset: Ref<number>;
     constructor(entries: PdfTrailerEntries | PdfDictionary<PdfTrailerEntries>);
     protected tokenize(): PdfToken[];
-    clone(): this;
+    cloneImpl(): this;
     isModified(): boolean;
 }

package/dist/core/objects/pdf-trailer.js

@@ -22,8 +22,9 @@ export class PdfTrailer extends PdfObject {
             ...this.dict.toTokens(),
         ];
     }
-    clone() {
-        return new PdfTrailer(this.dict.clone());
+    cloneImpl() {
+        const cloned = new PdfTrailer(this.dict.clone());
+        return cloned;
     }
     isModified() {
         return (super.isModified() ||

package/dist/core/objects/pdf-xref-table.d.ts

@@ -16,7 +16,7 @@ export declare class PdfXRefTableEntry extends PdfObject {
         inUse: boolean;
     });
     protected tokenize(): PdfXRefTableEntryToken[];
-    clone(): this;
+    cloneImpl(): this;
     isModified(): boolean;
 }
 export declare class PdfXRefTableSectionHeader extends PdfObject {
@@ -27,7 +27,7 @@ export declare class PdfXRefTableSectionHeader extends PdfObject {
         entryCount: number | PdfNumber;
     });
     protected tokenize(): PdfXRefTableSectionStartToken[];
-    clone(): this;
+    cloneImpl(): this;
 }
 export declare class PdfXRefTable extends PdfObject {
     sections: PdfXRefTableSectionHeader[];
@@ -44,5 +44,5 @@ export declare class PdfXRefTable extends PdfObject {
     get lastSection(): PdfXRefTableSectionHeader | null;
     protected tokenize(): import("../index.js").PdfToken[];
     private sortEntriesIntoSections;
-    clone(): this;
+    cloneImpl(): this;
 }

package/dist/core/objects/pdf-xref-table.js

@@ -36,7 +36,7 @@ export class PdfXRefTableEntry extends PdfObject {
             new PdfXRefTableEntryToken(this.byteOffset.toToken(), this.generationNumber.toToken(), this.objectNumber.toToken(), this.inUse),
         ];
     }
-    clone() {
+    cloneImpl() {
         return new PdfXRefTableEntry({
             byteOffset: this.byteOffset.clone(),
             objectNumber: this.objectNumber.clone(),
@@ -64,7 +64,7 @@ export class PdfXRefTableSectionHeader extends PdfObject {
             new PdfXRefTableSectionStartToken(this.startObjectNumber.value, this.entryCount.value),
         ];
     }
-    clone() {
+    cloneImpl() {
         return new PdfXRefTableSectionHeader({
             startObjectNumber: this.startObjectNumber.clone(),
             entryCount: this.entryCount.clone(),
@@ -173,7 +173,7 @@ export class PdfXRefTable extends PdfObject {
         }
         return sections;
     }
-    clone() {
+    cloneImpl() {
         return new PdfXRefTable({
             sections: this.sections.map((s) => s.clone()),
             entries: this.entries.map((e) => e.clone()),

package/dist/core/parser/incremental-parser.d.ts

@@ -1,17 +1,4 @@
 import { Parser } from './parser.js';
-/**
- * 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 {
-}
-export declare class UnexpectedTokenError extends Error {
-    constructor(expected: string, actual: string | null);
-}
 /**
  * Abstract base class for incremental parsers that can process input as it becomes available.
  * Supports buffering, lookahead, and backtracking for complex parsing scenarios.

package/dist/core/parser/incremental-parser.js

@@ -1,22 +1,5 @@
 import { Parser } from './parser.js';
-/**
- * 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}`);
-    }
-}
+import { NoMoreTokensError, EofReachedError } from '../../errors.js';
 /**
  * Abstract base class for incremental parsers that can process input as it becomes available.
  * Supports buffering, lookahead, and backtracking for complex parsing scenarios.

package/dist/core/streams/object-stream.d.ts

@@ -1,6 +1,6 @@
 import { PdfObject } from '../objects/pdf-object.js';
 import { ByteArray } from '../../types.js';
-import { IterableReadableStream } from '../../utils/IterableReadableStream.js';
+import { IterableReadableStream } from '../../utils/iterable-readable-stream.js';
 export declare class PdfObjectStream extends IterableReadableStream<PdfObject> {
     constructor(input: AsyncIterable<ByteArray> | Iterable<ByteArray>);
 }

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 {};