pdf-lite 1.5.0 → 1.6.1

package/dist/acroform/pdf-font-encoding-cache.js

@@ -1,188 +0,0 @@
-import { PdfDictionary } from '../core/objects/pdf-dictionary.js';
-import { PdfArray } from '../core/objects/pdf-array.js';
-import { PdfName } from '../core/objects/pdf-name.js';
-import { PdfString } from '../core/objects/pdf-string.js';
-import { PdfObjectReference } from '../core/objects/pdf-object-reference.js';
-import { buildEncodingMap } from '../utils/decodeWithFontEncoding.js';
-/**
- * Resolves and caches font encoding maps from the form's default resources.
- */
-export class PdfFontEncodingCache {
-    fontEncodingMaps = new Map();
-    fontTypes = new Map();
-    /** Object references for all resolved fonts, keyed by resource name. */
-    fontRefs = new Map();
-    document;
-    defaultResources;
-    constructor(document, defaultResources) {
-        this.document = document;
-        this.defaultResources = defaultResources;
-    }
-    async getFontEncodingMap(fontName) {
-        if (this.fontEncodingMaps.has(fontName)) {
-            return this.fontEncodingMaps.get(fontName);
-        }
-        const dr = this.defaultResources;
-        if (!dr)
-            return null;
-        const fontDictEntry = dr.get('Font');
-        const fonts = fontDictEntry instanceof PdfDictionary ? fontDictEntry : null;
-        if (!fonts)
-            return null;
-        const fontEntry = fonts.get(fontName);
-        const fontRef = fontEntry instanceof PdfObjectReference ? fontEntry : null;
-        if (!fontRef)
-            return null;
-        this.fontRefs.set(fontName, fontRef);
-        const fontObj = await this.document?.readObject(fontRef);
-        if (!fontObj)
-            return null;
-        const fontDict = fontObj.content instanceof PdfDictionary ? fontObj.content : null;
-        if (!fontDict)
-            return null;
-        // Cache font subtype (Type0, TrueType, Type1, etc.)
-        const subtypeEntry = fontDict.get('Subtype');
-        const subtype = subtypeEntry instanceof PdfName ? subtypeEntry.value : undefined;
-        if (subtype) {
-            this.fontTypes.set(fontName, subtype);
-        }
-        const encoding = fontDict.get('Encoding');
-        let encodingDict = null;
-        if (encoding instanceof PdfObjectReference) {
-            const encodingObj = await this.document?.readObject(encoding);
-            encodingDict =
-                encodingObj?.content instanceof PdfDictionary
-                    ? encodingObj.content
-                    : null;
-        }
-        else if (encoding instanceof PdfDictionary) {
-            encodingDict = encoding;
-        }
-        if (!encodingDict)
-            return null;
-        const differences = encodingDict.get('Differences')?.as(PdfArray);
-        if (!differences)
-            return null;
-        const encodingMap = buildEncodingMap(differences);
-        if (!encodingMap)
-            return null;
-        this.fontEncodingMaps.set(fontName, encodingMap);
-        return encodingMap;
-    }
-    async cacheAllFontEncodings(fields) {
-        // Collect font names with an associated page ref for the first field
-        // that uses them (needed to fall back to page resources).
-        const fontPageRefs = new Map();
-        for (const field of fields) {
-            const daEntry = field.content.get('DA');
-            const da = daEntry instanceof PdfString ? daEntry.value : undefined;
-            if (da) {
-                const fontMatch = da.match(/\/(\w+)\s+[\d.]+\s+Tf/);
-                if (fontMatch) {
-                    const fontName = fontMatch[1];
-                    if (!fontPageRefs.has(fontName)) {
-                        const pageEntry = field.content.get('P');
-                        const pageRef = pageEntry instanceof PdfObjectReference
-                            ? pageEntry
-                            : null;
-                        fontPageRefs.set(fontName, pageRef);
-                    }
-                }
-            }
-        }
-        for (const [fontName, pageRef] of fontPageRefs) {
-            await this.getFontEncodingMap(fontName);
-            // If the font was not in the AcroForm DR, try the field's page resources
-            if (!this.fontRefs.has(fontName) && pageRef) {
-                await this.resolveFontFromPage(fontName, pageRef);
-            }
-        }
-    }
-    /**
-     * Walks the page-tree (page → parent → … → Pages root), looking for the
-     * font in each node's /Resources/Font dict. Stops as soon as it finds the
-     * font. PDF resource inheritance means any ancestor can supply the font.
-     */
-    async resolveFontFromPage(fontName, pageRef) {
-        if (!this.document)
-            return;
-        // Walk up the parent chain (max 16 levels to avoid infinite loops)
-        let currentRef = pageRef;
-        for (let depth = 0; depth < 16 && currentRef; depth++) {
-            const nodeObj = await this.document.readObject({
-                objectNumber: currentRef.objectNumber,
-                generationNumber: currentRef.generationNumber,
-            });
-            const nodeDict = nodeObj?.content instanceof PdfDictionary
-                ? nodeObj.content
-                : null;
-            if (!nodeDict)
-                break;
-            // Try Resources.Font in this node
-            const resourcesEntry = nodeDict.get('Resources');
-            const resources = resourcesEntry instanceof PdfDictionary ? resourcesEntry : null;
-            if (resources) {
-                const fontsEntry = resources.get('Font');
-                const fonts = fontsEntry instanceof PdfDictionary ? fontsEntry : null;
-                if (fonts) {
-                    const fontEntry = fonts.get(fontName);
-                    const fontRef = fontEntry instanceof PdfObjectReference
-                        ? fontEntry
-                        : null;
-                    if (fontRef) {
-                        // Found — cache and finish
-                        currentRef = fontRef;
-                        break;
-                    }
-                }
-            }
-            // Walk to parent
-            const parentEntry = nodeDict.get('Parent');
-            currentRef =
-                parentEntry instanceof PdfObjectReference ? parentEntry : null;
-        }
-        const fontRef = currentRef;
-        if (!fontRef)
-            return;
-        this.fontRefs.set(fontName, fontRef);
-        const fontObj = await this.document.readObject({
-            objectNumber: fontRef.objectNumber,
-            generationNumber: fontRef.generationNumber,
-        });
-        const fontDict = fontObj?.content instanceof PdfDictionary ? fontObj.content : null;
-        if (!fontDict)
-            return;
-        const subtypeEntry = fontDict.get('Subtype');
-        const subtype = subtypeEntry instanceof PdfName ? subtypeEntry.value : undefined;
-        if (subtype)
-            this.fontTypes.set(fontName, subtype);
-        // Also resolve encoding map if present
-        const encoding = fontDict.get('Encoding');
-        let encodingDict = null;
-        if (encoding instanceof PdfObjectReference) {
-            const encodingObj = await this.document.readObject({
-                objectNumber: encoding.objectNumber,
-                generationNumber: encoding.generationNumber,
-            });
-            encodingDict =
-                encodingObj?.content instanceof PdfDictionary
-                    ? encodingObj.content
-                    : null;
-        }
-        else if (encoding instanceof PdfDictionary) {
-            encodingDict = encoding;
-        }
-        if (!encodingDict)
-            return;
-        const differencesEntry = encodingDict.get('Differences');
-        if (!(differencesEntry instanceof PdfArray))
-            return;
-        const encodingMap = buildEncodingMap(differencesEntry);
-        if (encodingMap) {
-            this.fontEncodingMaps.set(fontName, encodingMap);
-        }
-    }
-    isFontUnicode(fontName) {
-        return this.fontTypes.get(fontName) === 'Type0';
-    }
-}

package/dist/annotations/pdf-annotation-writer.d.ts

@@ -1,20 +0,0 @@
-import { PdfDocument } from '../pdf/pdf-document.js';
-import { PdfDictionary } from '../core/objects/pdf-dictionary.js';
-import { PdfArray } from '../core/objects/pdf-array.js';
-import { PdfObjectReference } from '../core/objects/pdf-object-reference.js';
-/**
- * Manages page Annots arrays during AcroForm write operations.
- */
-export declare class PdfAnnotationWriter {
-    static getPageAnnotsArray(document: PdfDocument, pageDict: PdfDictionary): Promise<{
-        annotsArray: PdfArray<PdfObjectReference>;
-        isIndirect: boolean;
-        objectNumber?: number;
-        generationNumber?: number;
-    }>;
-    static addFieldsToAnnots(annotsArray: PdfArray<PdfObjectReference>, fieldRefs: PdfObjectReference[]): void;
-    static updatePageAnnotations(document: PdfDocument, fieldsByPage: Map<string, {
-        pageRef: PdfObjectReference;
-        fieldRefs: PdfObjectReference[];
-    }>): Promise<void>;
-}

package/dist/annotations/pdf-annotation-writer.js

@@ -1,76 +0,0 @@
-import { PdfDictionary } from '../core/objects/pdf-dictionary.js';
-import { PdfArray } from '../core/objects/pdf-array.js';
-import { PdfObjectReference } from '../core/objects/pdf-object-reference.js';
-import { PdfIndirectObject } from '../core/objects/pdf-indirect-object.js';
-/**
- * Manages page Annots arrays during AcroForm write operations.
- */
-export class PdfAnnotationWriter {
-    static async getPageAnnotsArray(document, pageDict) {
-        const annotsRef = pageDict.get('Annots');
-        if (annotsRef instanceof PdfObjectReference) {
-            const annotsObj = await document.readObject({
-                objectNumber: annotsRef.objectNumber,
-                generationNumber: annotsRef.generationNumber,
-            });
-            return {
-                annotsArray: annotsObj.content
-                    .as((PdfArray))
-                    .clone(),
-                isIndirect: true,
-                objectNumber: annotsRef.objectNumber,
-                generationNumber: annotsRef.generationNumber,
-            };
-        }
-        else if (annotsRef instanceof PdfArray) {
-            return {
-                annotsArray: annotsRef.as((PdfArray)).clone(),
-                isIndirect: false,
-            };
-        }
-        else {
-            const newArray = new PdfArray();
-            pageDict.set('Annots', newArray);
-            return {
-                annotsArray: newArray,
-                isIndirect: false,
-            };
-        }
-    }
-    static addFieldsToAnnots(annotsArray, fieldRefs) {
-        for (const fieldRef of fieldRefs) {
-            const exists = annotsArray.items.some((ref) => ref.equals(fieldRef));
-            if (!exists) {
-                annotsArray.push(fieldRef);
-            }
-        }
-    }
-    static async updatePageAnnotations(document, fieldsByPage) {
-        for (const { pageRef, fieldRefs } of fieldsByPage.values()) {
-            const pageObj = await document.readObject({
-                objectNumber: pageRef.objectNumber,
-                generationNumber: pageRef.generationNumber,
-            });
-            if (!pageObj)
-                continue;
-            const pageDict = pageObj.content.as(PdfDictionary).clone();
-            const annotsInfo = await PdfAnnotationWriter.getPageAnnotsArray(document, pageDict);
-            PdfAnnotationWriter.addFieldsToAnnots(annotsInfo.annotsArray, fieldRefs);
-            if (annotsInfo.isIndirect &&
-                annotsInfo.objectNumber !== undefined) {
-                const annotsIndirect = new PdfIndirectObject({
-                    objectNumber: annotsInfo.objectNumber,
-                    generationNumber: annotsInfo.generationNumber,
-                    content: annotsInfo.annotsArray,
-                });
-                document.add(annotsIndirect);
-            }
-            const pageIndirect = new PdfIndirectObject({
-                objectNumber: pageRef.objectNumber,
-                generationNumber: pageRef.generationNumber,
-                content: pageDict,
-            });
-            document.add(pageIndirect);
-        }
-    }
-}

package/dist/fonts/manager.d.ts

@@ -1,127 +0,0 @@
-import { PdfDocument } from '../pdf/pdf-document.js';
-import { ByteArray } from '../types.js';
-import { FontDescriptor, UnicodeFontDescriptor } from './types.js';
-import { PdfFont } from './pdf-font.js';
-/**
- * Manages font embedding in PDF documents.
- * Provides methods to embed TrueType and other font formats.
- */
-export declare class PdfFontManager {
-    private document;
-    private fontResourceCounter;
-    constructor(document: PdfDocument);
-    findFontByName(fontName: string): Promise<PdfFont | undefined>;
-    /**
-     * Embeds a TrueType font into the PDF document.
-     *
-     * @param fontData - The font file bytes
-     * @param fontName - The name to use for this font in the PDF
-     * @param descriptor - Font metrics and properties
-     * @returns A PdfFont object representing the embedded font
-     */
-    embedTrueTypeFont(fontData: ByteArray, fontName: string, descriptor: FontDescriptor): Promise<PdfFont>;
-    /**
-     * Embeds a standard PDF font (Type1).
-     * These fonts don't require font data as they're built into PDF viewers.
-     *
-     * @param fontName - One of the 14 standard PDF fonts
-     * @returns A PdfFont object representing the embedded font
-     */
-    embedStandardFont(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'): Promise<PdfFont>;
-    /**
-     * Embeds a font from file data with automatic parsing and configuration.
-     * This is the recommended high-level API for embedding fonts.
-     *
-     * @param fontData - The font file bytes (TTF, OTF, or WOFF format)
-     * @param options - Optional configuration
-     * @param options.fontName - Custom font name (defaults to PostScript name from font)
-     * @param options.unicode - Use Unicode/Type0 encoding for non-ASCII characters
-     * @param options.unicodeMappings - Custom CID to Unicode mappings for Type0 fonts
-     * @returns A PdfFont object representing the embedded font
-     *
-     * @example
-     * ```typescript
-     * // Simple embedding with auto-generated name
-     * const font = await document.fonts.embedFromFile(fontData)
-     * field.font = font
-     *
-     * // With custom name and Unicode support
-     * const font = await document.fonts.embedFromFile(fontData, {
-     *     fontName: 'MyCustomFont',
-     *     unicode: true
-     * })
-     * ```
-     */
-    embedFromFile(fontData: ByteArray, options?: {
-        fontName?: string;
-        unicode?: boolean;
-        unicodeMappings?: Map<number, number>;
-    }): Promise<PdfFont>;
-    /**
-     * Gets the font reference by font name or resource name.
-     */
-    getFont(fontName: string): Promise<PdfFont | undefined>;
-    /**
-     * Writes a font to the PDF document.
-     * Assigns resource name, creates container object, commits all objects,
-     * and registers it in page resources.
-     *
-     * @param font - The PdfFont instance to write
-     * @param cacheKey - Unused, kept for API compatibility
-     * @returns The font with its resourceName and container set
-     * @internal
-     */
-    write(font: PdfFont): Promise<PdfFont>;
-    /**
-     * Gets all embedded fonts.
-     * Searches the PDF structure to find all fonts.
-     */
-    getAllFonts(): Promise<Map<string, PdfFont>>;
-    /**
-     * Embeds a TrueType font with Unicode/Type0 support.
-     * Use this for fonts that need to display non-ASCII characters.
-     *
-     * @param fontData - The font file bytes
-     * @param fontName - The name to use for this font in the PDF
-     * @param descriptor - Unicode font descriptor with CID metrics
-     * @param unicodeMappings - Map of CID to Unicode code point for ToUnicode CMap
-     * @returns A PdfFont object representing the embedded font
-     */
-    embedTrueTypeFontUnicode(fontData: ByteArray, fontName: string, descriptor: UnicodeFontDescriptor, unicodeMappings?: Map<number, number>): Promise<PdfFont>;
-    /**
-     * Loads existing fonts from the PDF document.
-     * Traverses the page tree and extracts font information from page resources.
-     *
-     * @returns Map of font names to their PdfFont objects
-     */
-    loadExistingFonts(): Promise<Map<string, PdfFont>>;
-    /**
-     * Traverses the page tree to find and load existing fonts.
-     */
-    private traversePageTreeForFonts;
-    /**
-     * Extracts font information from a page's resources.
-     */
-    private extractFontsFromPage;
-    /**
-     * Searches the PDF structure for a font by name.
-     * @internal
-     */
-    private searchFontInPdf;
-    /**
-     * Collects all fonts from the PDF structure.
-     * @internal
-     */
-    private collectAllFontsFromPdf;
-    /**
-     * Adds a font to the AcroForm default resources (DR) dictionary.
-     * This ensures fonts are available to form fields.
-     */
-    private addFontToAcroFormResources;
-    /**
-     * Adds a font to the global /Pages node Resources dictionary.
-     * All child pages will inherit these fonts automatically.
-     * This is more efficient than adding to each individual page.
-     */
-    private addFontToPageResources;
-}