pdf-lite 1.4.0 → 1.6.0

package/dist/fonts/pdf-font.js

@@ -4,34 +4,25 @@ 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 { PdfStream } from '../core/objects/pdf-stream.js';
+import { PdfObjectReference } from '../core/objects/pdf-object-reference.js';
 import { PdfString } from '../core/objects/pdf-string.js';
+import { buildEncodingMap } from '../utils/decodeWithFontEncoding.js';
 import { parseFont } from './parsers/font-parser.js';
 import { OtfParser } from './parsers/otf-parser.js';
 /**
  * Represents an embedded font in a PDF document.
- * Extends PdfDictionary to provide both font metadata and PDF dictionary structure.
+ * Extends PdfIndirectObject with a PdfDictionary content for the font dict.
  */
-export class PdfFont extends PdfDictionary {
+export class PdfFont extends PdfIndirectObject {
     /**
      * 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;
-    /**
-     * Reference to the container indirect object that wraps this font dict.
-     * Set by FontManager.write() when the font is committed to the PDF.
-     */
-    container;
-    /**
-     * Auxiliary objects that must be committed along with the font dict.
-     * Includes FontDescriptor, FontFile2, CIDFont, ToUnicode, etc.
-     */
-    auxiliaryObjects = [];
-    /**
-     * @internal
-     * Reference to the font manager that created this font.
-     */
-    manager;
+    static _resourceCounter = 0;
+    static nextResourceName() {
+        return `F${++PdfFont._resourceCounter}`;
+    }
     /**
      * @internal
      * Font descriptor with metrics and properties.
@@ -42,21 +33,37 @@ export class PdfFont extends PdfDictionary {
      * Original font file bytes.
      */
     _fontData;
-    constructor(options) {
-        super();
-        if (options.dict) {
-            this.copyFrom(options.dict);
+    constructor(optionsOrFontName) {
+        super(new PdfIndirectObject({ content: new PdfDictionary() }));
+        if (optionsOrFontName instanceof PdfIndirectObject) {
+            // Handle PdfIndirectObject input (existing font object)
+            const fontObj = optionsOrFontName;
+            if (!(fontObj.content instanceof PdfDictionary)) {
+                throw new Error('PdfIndirectObject content must be a PdfDictionary');
+            }
+            this.content = fontObj.content;
+            this.resourceName = fontObj.reference.key;
+            return;
         }
+        // Handle string parameter (simple fontName)
+        if (typeof optionsOrFontName === 'string') {
+            this.fontName = optionsOrFontName;
+            this.resourceName = optionsOrFontName;
+            return;
+        }
+        // Handle options object
+        const options = optionsOrFontName;
         this.fontName = options.fontName;
-        this.resourceName = options.resourceName ?? '';
+        this.resourceName = options.resourceName || PdfFont.nextResourceName();
         this.encoding = options.encoding;
-        this.manager = options.manager;
-        this.container = options.container;
         this._descriptor = options.descriptor;
         this._fontData = options.fontData;
     }
+    get dict() {
+        return this.content;
+    }
     get fontName() {
-        const baseFont = this.get('BaseFont');
+        const baseFont = this.content.get('BaseFont');
         if (!baseFont) {
             return undefined;
         }
@@ -64,23 +71,52 @@ export class PdfFont extends PdfDictionary {
     }
     set fontName(name) {
         if (!name) {
-            this.delete('BaseFont');
+            this.content.delete('BaseFont');
             return;
         }
-        this.set('BaseFont', new PdfName(name));
+        this.content.set('BaseFont', new PdfName(name));
     }
     get encoding() {
-        const encoding = this.get('Encoding');
+        const encoding = this.content.get('Encoding');
         return encoding ? encoding.value : undefined;
     }
     set encoding(enc) {
         if (enc) {
-            this.set('Encoding', new PdfName(enc));
+            this.content.set('Encoding', new PdfName(enc));
         }
         else {
-            this.delete('Encoding');
+            this.content.delete('Encoding');
         }
     }
+    /**
+     * 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() {
+        const enc = this.content.get('Encoding');
+        const encObj = enc instanceof PdfObjectReference ? enc.resolve()?.content : enc;
+        const encDict = encObj instanceof PdfDictionary ? encObj : undefined;
+        const diffs = encDict?.get('Differences')?.as(PdfArray);
+        if (!diffs)
+            return null;
+        return buildEncodingMap(diffs);
+    }
+    /**
+     * Gets the reverse encoding map (Unicode character → byte code).
+     * Useful for encoding text back into the font's custom encoding.
+     */
+    get reverseEncodingMap() {
+        const map = this.encodingMap;
+        if (!map)
+            return undefined;
+        return new Map(Array.from(map, ([code, char]) => [char, code]));
+    }
+    /**
+     * Whether this font uses Unicode (Type0/composite) encoding.
+     */
+    get isUnicode() {
+        return this.fontType === 'Type0';
+    }
     /**
      * Gets the font descriptor with metrics and properties.
      * Available for embedded fonts, undefined for standard fonts or loaded fonts without descriptor.
@@ -99,7 +135,7 @@ export class PdfFont extends PdfDictionary {
      * Gets the font type (Subtype in PDF).
      */
     get fontType() {
-        const subtype = this.get('Subtype');
+        const subtype = this.content.get('Subtype');
         return subtype?.value;
     }
     /**
@@ -107,17 +143,17 @@ export class PdfFont extends PdfDictionary {
      */
     set fontType(type) {
         if (type) {
-            this.set('Subtype', new PdfName(type));
+            this.content.set('Subtype', new PdfName(type));
         }
         else {
-            this.delete('Subtype');
+            this.content.delete('Subtype');
         }
     }
     /**
      * Gets the first character code in the Widths array.
      */
     get firstChar() {
-        const firstChar = this.get('FirstChar');
+        const firstChar = this.content.get('FirstChar');
         return firstChar?.value;
     }
     /**
@@ -125,17 +161,17 @@ export class PdfFont extends PdfDictionary {
      */
     set firstChar(value) {
         if (value !== undefined) {
-            this.set('FirstChar', new PdfNumber(value));
+            this.content.set('FirstChar', new PdfNumber(value));
         }
         else {
-            this.delete('FirstChar');
+            this.content.delete('FirstChar');
         }
     }
     /**
      * Gets the last character code in the Widths array.
      */
     get lastChar() {
-        const lastChar = this.get('LastChar');
+        const lastChar = this.content.get('LastChar');
         return lastChar?.value;
     }
     /**
@@ -143,17 +179,17 @@ export class PdfFont extends PdfDictionary {
      */
     set lastChar(value) {
         if (value !== undefined) {
-            this.set('LastChar', new PdfNumber(value));
+            this.content.set('LastChar', new PdfNumber(value));
         }
         else {
-            this.delete('LastChar');
+            this.content.delete('LastChar');
         }
     }
     /**
      * Gets the character widths array.
      */
     get widths() {
-        const widths = this.get('Widths');
+        const widths = this.content.get('Widths');
         if (!widths)
             return undefined;
         return widths.items.map((item) => item.value);
@@ -163,11 +199,65 @@ export class PdfFont extends PdfDictionary {
      */
     set widths(values) {
         if (values) {
-            this.set('Widths', new PdfArray(values.map((w) => new PdfNumber(w))));
+            this.content.set('Widths', new PdfArray(values.map((w) => new PdfNumber(w))));
         }
         else {
-            this.delete('Widths');
+            this.content.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.
@@ -179,27 +269,13 @@ export class PdfFont extends PdfDictionary {
     toString() {
         return this.resourceName;
     }
-    /**
-     * Returns all objects that need to be committed to the PDF.
-     * Includes auxiliary objects (descriptors, streams) and the container.
-     */
-    getObjectsToCommit() {
-        const objects = [...this.auxiliaryObjects];
-        if (this.container) {
-            objects.push(this.container);
-        }
-        return objects;
-    }
     /**
      * @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() {
-        if (!this.container) {
-            throw new Error('Font has not been written to PDF yet');
-        }
-        return this.container.reference;
+        return this.reference;
     }
     /**
      * Creates a PdfFont from font file bytes.
@@ -235,16 +311,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));
+        font.content.set('Type', new PdfName('Font'));
+        font.content.set('Subtype', new PdfName('Type1'));
+        font.content.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.
@@ -293,28 +493,26 @@ export class PdfFont extends PdfDictionary {
         const fontDescriptorObject = new PdfIndirectObject({
             content: fontDescriptorDict,
         });
-        // Store auxiliary objects
-        font.auxiliaryObjects.push(fontFileObject, fontDescriptorObject);
         // Build TrueType font dictionary
-        font.set('Type', new PdfName('Font'));
-        font.set('Subtype', new PdfName('TrueType'));
-        font.set('BaseFont', new PdfName(descriptor.fontName));
-        font.set('FontDescriptor', fontDescriptorObject.reference);
-        font.set('Encoding', new PdfName('WinAnsiEncoding'));
+        font.content.set('Type', new PdfName('Font'));
+        font.content.set('Subtype', new PdfName('TrueType'));
+        font.content.set('BaseFont', new PdfName(descriptor.fontName));
+        font.content.set('FontDescriptor', fontDescriptorObject.reference);
+        font.content.set('Encoding', new PdfName('WinAnsiEncoding'));
         // Add width information for proper glyph rendering
         const firstChar = descriptor.firstChar ?? 32;
         const lastChar = descriptor.lastChar ?? 255;
-        font.set('FirstChar', new PdfNumber(firstChar));
-        font.set('LastChar', new PdfNumber(lastChar));
+        font.content.set('FirstChar', new PdfNumber(firstChar));
+        font.content.set('LastChar', new PdfNumber(lastChar));
         if (descriptor.widths) {
-            font.set('Widths', new PdfArray(descriptor.widths.map((w) => new PdfNumber(w))));
+            font.content.set('Widths', new PdfArray(descriptor.widths.map((w) => new PdfNumber(w))));
         }
         else {
             // Default: 1000 (standard em-square)
             const defaultWidths = Array(lastChar - firstChar + 1)
                 .fill(0)
                 .map(() => new PdfNumber(1000));
-            font.set('Widths', new PdfArray(defaultWidths));
+            font.content.set('Widths', new PdfArray(defaultWidths));
         }
         return font;
     }
@@ -367,8 +565,6 @@ export class PdfFont extends PdfDictionary {
         const fontDescriptorObject = new PdfIndirectObject({
             content: fontDescriptorDict,
         });
-        // Store descriptor and font file
-        font.auxiliaryObjects.push(fontFileObject, fontDescriptorObject);
         // Create CIDFont dictionary (descendant font)
         const cidFontDict = new PdfDictionary();
         cidFontDict.set('Type', new PdfName('Font'));
@@ -391,13 +587,12 @@ export class PdfFont extends PdfDictionary {
         const cidFontObject = new PdfIndirectObject({
             content: cidFontDict,
         });
-        font.auxiliaryObjects.push(cidFontObject);
         // Build Type0 font dictionary
-        font.set('Type', new PdfName('Font'));
-        font.set('Subtype', new PdfName('Type0'));
-        font.set('BaseFont', new PdfName(`${descriptor.fontName}-Identity-H`));
-        font.set('Encoding', new PdfName('Identity-H'));
-        font.set('DescendantFonts', new PdfArray([cidFontObject.reference]));
+        font.content.set('Type', new PdfName('Font'));
+        font.content.set('Subtype', new PdfName('Type0'));
+        font.content.set('BaseFont', new PdfName(`${descriptor.fontName}-Identity-H`));
+        font.content.set('Encoding', new PdfName('Identity-H'));
+        font.content.set('DescendantFonts', new PdfArray([cidFontObject.reference]));
         // Create ToUnicode CMap if mappings provided
         if (unicodeMappings && unicodeMappings.size > 0) {
             const cmapContent = PdfFont.generateToUnicodeCMap(unicodeMappings);
@@ -409,11 +604,34 @@ export class PdfFont extends PdfDictionary {
             const cmapObject = new PdfIndirectObject({
                 content: cmapStream,
             });
-            font.set('ToUnicode', cmapObject.reference);
-            font.auxiliaryObjects.push(cmapObject);
+            font.content.set('ToUnicode', cmapObject.reference);
         }
         return font;
     }
+    static fromFile(fontData, options) {
+        // Parse the font to extract metadata
+        const parser = parseFont(fontData);
+        const info = parser.getFontInfo();
+        // Auto-generate font name from metadata if not provided
+        const fontName = options?.fontName ?? info.postScriptName ?? info.fullName;
+        // Get the appropriate descriptor based on unicode option
+        const descriptor = parser.getFontDescriptor(fontName);
+        // Embed using the appropriate method and return PdfFont
+        if (options?.unicode) {
+            // For Unicode fonts, we need a UnicodeFontDescriptor
+            // Create one by extending the base descriptor
+            const unicodeDescriptor = {
+                ...descriptor,
+                defaultWidth: 1000,
+                cidToGidMap: 'Identity',
+            };
+            return PdfFont.fromType0Data(fontData, fontName, unicodeDescriptor, options.unicodeMappings);
+        }
+        else {
+            // Use standard TrueType embedding
+            return PdfFont.fromTrueTypeData(fontData, fontName, descriptor);
+        }
+    }
     /**
      * Generates a ToUnicode CMap for mapping CIDs to Unicode code points.
      */

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,5 +1,6 @@
-export * from './errors.js';
 export * from './pdf-document.js';
+export * from './pdf-page.js';
+export * from './pdf-pages.js';
 export * from './pdf-reader.js';
 export * from './pdf-revision.js';
 export * from './pdf-xref-lookup.js';

package/dist/pdf/index.js

@@ -1,5 +1,6 @@
-export * from './errors.js';
 export * from './pdf-document.js';
+export * from './pdf-page.js';
+export * from './pdf-pages.js';
 export * from './pdf-reader.js';
 export * from './pdf-revision.js';
 export * from './pdf-xref-lookup.js';