pdf-lite 1.4.0 → 1.6.0

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/core/tokens/token.d.ts

@@ -1,5 +1,5 @@
 import { ByteArray } from '../../types.js';
-export declare abstract class PdfToken {
+export declare class PdfToken {
     protected rawBytes: ByteArray;
     constructor(bytes?: ByteArray);
     toBytes(): ByteArray;
@@ -7,4 +7,5 @@ export declare abstract class PdfToken {
     get type(): string;
     get byteLength(): number;
     equals(other: PdfToken): boolean;
+    clone(): PdfToken;
 }

package/dist/core/tokens/token.js

@@ -29,4 +29,7 @@ export class PdfToken {
         }
         return true;
     }
+    clone() {
+        return new PdfToken(this.toBytes());
+    }
 }

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,3 @@
 export * from './types.js';
-export * from './font-manager.js';
 export * from './pdf-font.js';
 export * from './parsers/index.js';

package/dist/fonts/index.js

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

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

@@ -4,14 +4,9 @@ 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 { FontDescriptor, UnicodeFontDescriptor, FontParser } from './types.js';
 import type { ByteArray } from '../types.js';
-/**
- * Represents an embedded font in a PDF document.
- * Extends PdfDictionary to provide both font metadata and PDF dictionary structure.
- */
-export declare class PdfFont extends PdfDictionary<{
+type PdfFontDictionary = PdfDictionary<{
     Type: PdfName<'Font'>;
     Subtype: PdfName<'Type1' | 'TrueType' | 'Type0'>;
     BaseFont: PdfName;
@@ -22,27 +17,20 @@ export declare class PdfFont extends PdfDictionary<{
     Widths?: PdfArray<PdfNumber>;
     DescendantFonts?: PdfArray<PdfObjectReference>;
     ToUnicode?: PdfObjectReference;
-}> {
+}>;
+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 PdfIndirectObject with a PdfDictionary content for the font dict.
+ */
+export declare class PdfFont extends PdfIndirectObject<PdfFontDictionary> {
     /**
      * The PDF resource name used in content streams (e.g., 'F1', 'F2').
      * This is the identifier used in PDF operators like `/F1 12 Tf`.
      */
     resourceName: string;
-    /**
-     * Reference to the container indirect object that wraps this font dict.
-     * Set by FontManager.write() when the font is committed to the PDF.
-     */
-    container?: PdfIndirectObject;
-    /**
-     * Auxiliary objects that must be committed along with the font dict.
-     * Includes FontDescriptor, FontFile2, CIDFont, ToUnicode, etc.
-     */
-    protected auxiliaryObjects: PdfIndirectObject[];
-    /**
-     * @internal
-     * Reference to the font manager that created this font.
-     */
-    private manager?;
+    private static _resourceCounter;
+    private static nextResourceName;
     /**
      * @internal
      * Font descriptor with metrics and properties.
@@ -53,20 +41,34 @@ export declare class PdfFont extends PdfDictionary<{
      * Original font file bytes.
      */
     private _fontData?;
+    constructor(font: PdfIndirectObject);
+    constructor(fontName: string);
     constructor(options: {
-        dict?: PdfDictionary;
         fontName?: string;
         resourceName?: string;
         encoding?: string;
-        manager?: PdfFontManager;
-        container?: PdfIndirectObject;
         descriptor?: FontDescriptor | UnicodeFontDescriptor;
         fontData?: ByteArray;
     });
+    get dict(): PdfFontDictionary;
     get fontName(): string | undefined;
     set fontName(name: string | undefined);
     get encoding(): string | undefined;
     set encoding(enc: string | undefined);
+    /**
+     * Gets the encoding map from the font's Encoding dictionary's Differences array.
+     * Maps byte codes to Unicode characters for custom-encoded fonts.
+     */
+    get encodingMap(): Map<number, string> | null;
+    /**
+     * Gets the reverse encoding map (Unicode character → byte code).
+     * Useful for encoding text back into the font's custom encoding.
+     */
+    get reverseEncodingMap(): Map<string, number> | undefined;
+    /**
+     * Whether this font uses Unicode (Type0/composite) encoding.
+     */
+    get isUnicode(): boolean;
     /**
      * Gets the font descriptor with metrics and properties.
      * Available for embedded fonts, undefined for standard fonts or loaded fonts without descriptor.
@@ -109,6 +111,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:
@@ -117,15 +152,10 @@ export declare class PdfFont extends PdfDictionary<{
      * ```
      */
     toString(): string;
-    /**
-     * Returns all objects that need to be committed to the PDF.
-     * Includes auxiliary objects (descriptors, streams) and the container.
-     */
-    getObjectsToCommit(): PdfIndirectObject[];
     /**
      * @internal
      * Legacy property for backward compatibility with code that accesses fontRef.
-     * Returns the container object if available.
+     * Returns this font's reference since PdfFont IS the indirect object.
      */
     get fontRef(): PdfObjectReference;
     /**
@@ -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.
@@ -174,6 +230,11 @@ export declare class PdfFont extends PdfDictionary<{
      * @returns A PdfFont instance ready to be written to the PDF
      */
     static fromType0Data(fontData: ByteArray, fontName: string, descriptor: UnicodeFontDescriptor, unicodeMappings?: Map<number, number>): PdfFont;
+    static fromFile(fontData: ByteArray, options?: {
+        fontName?: string;
+        unicode?: boolean;
+        unicodeMappings?: Map<number, number>;
+    }): PdfFont;
     /**
      * Generates a ToUnicode CMap for mapping CIDs to Unicode code points.
      */
@@ -183,3 +244,4 @@ export declare class PdfFont extends PdfDictionary<{
      */
     private static buildCIDWidthArray;
 }
+export {};