@cj-tech-master/excelts 9.1.0 → 9.2.0

package/dist/cjs/modules/pdf/core/pdfa.js

@@ -0,0 +1,266 @@
+"use strict";
+/**
+ * PDF/A-1b compliance utilities.
+ *
+ * Provides XMP metadata stream writing and OutputIntent creation for
+ * PDF/A-1b (ISO 19005-1, Level B) conformance.
+ *
+ * **Limitations:**
+ * - Type1 base fonts (Helvetica, Times-Roman, Courier, etc.) are NOT embedded.
+ *   PDF/A-1b strictly requires all fonts to be embedded. Documents using only
+ *   CIDFonts (embedded TrueType via `embedFont()`) are fully compliant.
+ *   Documents using base Type1 fonts will pass structural validation but may
+ *   fail strict PDF/A font-embedding checks.
+ *
+ * @see ISO 19005-1:2005 — Document management — Electronic document file
+ *      format for long-term preservation — Part 1: Use of PDF 1.4 (PDF/A-1)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sRGB_ICC_PROFILE = void 0;
+exports.writePdfAMetadata = writePdfAMetadata;
+exports.writePdfAOutputIntent = writePdfAOutputIntent;
+const pdf_object_1 = require("./pdf-object");
+// =============================================================================
+// sRGB ICC Profile
+// =============================================================================
+/**
+ * Minimal sRGB ICC profile (v2.1.0).
+ *
+ * This is a valid ICC profile with the correct header structure, profile
+ * signature, and a minimal tag table. It identifies the color space as RGB
+ * with the sRGB rendering intent. The profile is intentionally minimal
+ * (~128 bytes) — enough to satisfy PDF/A-1b OutputIntent requirements.
+ *
+ * Structure:
+ * - 128-byte header (profile size, preferred CMM, version, device class,
+ *   color space, PCS, creation date, signature, platform, flags, etc.)
+ * - Tag table with 0 tags (profile is header-only for minimal compliance)
+ *
+ * @see ICC.1:2001-04 — File Format for Color Profiles (v2)
+ */
+exports.sRGB_ICC_PROFILE = buildMinimalSrgbProfile();
+function buildMinimalSrgbProfile() {
+    // ICC profile header is exactly 128 bytes
+    // We add a tag table with 3 required tags: desc, wtpt, cprt
+    // Each tag table entry is 12 bytes
+    const TAG_COUNT = 3;
+    const TAG_TABLE_SIZE = 4 + TAG_COUNT * 12; // 4 (count) + 3 * 12 (entries)
+    // Tag data — description, white point, copyright
+    const descData = buildTextDescriptionTag("sRGB IEC61966-2.1");
+    const wtptData = buildXYZTag(0.9505, 1.0, 1.089); // D50 white point
+    const cprtData = buildTextTag("No copyright");
+    const descOffset = 128 + TAG_TABLE_SIZE;
+    const wtptOffset = descOffset + descData.length;
+    const cprtOffset = wtptOffset + wtptData.length;
+    const profileSize = cprtOffset + cprtData.length;
+    const buf = new Uint8Array(profileSize);
+    const view = new DataView(buf.buffer);
+    // --- Header (128 bytes) ---
+    view.setUint32(0, profileSize); // Profile size
+    // Preferred CMM: none (0)
+    view.setUint8(8, 2); // Major version 2
+    view.setUint8(9, 0x10); // Minor version 1.0
+    // Profile/Device class: 'mntr' (monitor)
+    writeAscii(buf, 12, "mntr");
+    // Color space: 'RGB '
+    writeAscii(buf, 16, "RGB ");
+    // Profile Connection Space: 'XYZ '
+    writeAscii(buf, 20, "XYZ ");
+    // Creation date/time (2000-01-01 00:00:00)
+    view.setUint16(24, 2000); // year
+    view.setUint16(26, 1); // month
+    view.setUint16(28, 1); // day
+    // hour, minute, second = 0 (already zero)
+    // File signature: 'acsp'
+    writeAscii(buf, 36, "acsp");
+    // Primary platform: 'APPL'
+    writeAscii(buf, 40, "APPL");
+    // Rendering intent: 0 = Perceptual
+    view.setUint32(64, 0);
+    // PCS illuminant (D50 XYZ): X=0.9642, Y=1.0, Z=0.8249
+    writeS15Fixed16(view, 68, 0.9642);
+    writeS15Fixed16(view, 72, 1.0);
+    writeS15Fixed16(view, 76, 0.8249);
+    // --- Tag table ---
+    const tagTableOffset = 128;
+    view.setUint32(tagTableOffset, TAG_COUNT);
+    // Tag 1: 'desc' (profile description)
+    writeAscii(buf, tagTableOffset + 4, "desc");
+    view.setUint32(tagTableOffset + 8, descOffset);
+    view.setUint32(tagTableOffset + 12, descData.length);
+    // Tag 2: 'wtpt' (media white point)
+    writeAscii(buf, tagTableOffset + 16, "wtpt");
+    view.setUint32(tagTableOffset + 20, wtptOffset);
+    view.setUint32(tagTableOffset + 24, wtptData.length);
+    // Tag 3: 'cprt' (copyright)
+    writeAscii(buf, tagTableOffset + 28, "cprt");
+    view.setUint32(tagTableOffset + 32, cprtOffset);
+    view.setUint32(tagTableOffset + 36, cprtData.length);
+    // --- Tag data ---
+    buf.set(descData, descOffset);
+    buf.set(wtptData, wtptOffset);
+    buf.set(cprtData, cprtOffset);
+    return buf;
+}
+/** Write a 4-character ASCII string at the given offset. */
+function writeAscii(buf, offset, str) {
+    for (let i = 0; i < str.length; i++) {
+        buf[offset + i] = str.charCodeAt(i);
+    }
+}
+/** Write an s15Fixed16Number (ICC fixed-point) at the given offset. */
+function writeS15Fixed16(view, offset, value) {
+    const fixed = Math.round(value * 65536);
+    view.setInt32(offset, fixed);
+}
+/**
+ * Build an ICC 'desc' (textDescription) tag.
+ * Type signature: 'desc', followed by ASCII string.
+ */
+function buildTextDescriptionTag(text) {
+    // desc type: 4 (sig) + 4 (reserved) + 4 (ASCII count) + N (ASCII) + padding
+    const asciiLen = text.length + 1; // include null terminator
+    // Total: sig(4) + reserved(4) + count(4) + ascii(asciiLen) + unicode_count(4) + scriptcode_count(2) + scriptcode(67)
+    // Simplified: just ASCII portion for minimal profile
+    const totalLen = 4 + 4 + 4 + asciiLen + 4 + 4 + 2 + 67;
+    const buf = new Uint8Array(totalLen);
+    const view = new DataView(buf.buffer);
+    writeAscii(buf, 0, "desc");
+    // reserved: 0 (already zero)
+    view.setUint32(8, asciiLen);
+    for (let i = 0; i < text.length; i++) {
+        buf[12 + i] = text.charCodeAt(i);
+    }
+    // null terminator at 12 + text.length is already 0
+    // Unicode count = 0, scriptcode count = 0 — all zeros
+    return buf;
+}
+/** Build an ICC 'XYZ ' tag for a single XYZ triplet. */
+function buildXYZTag(x, y, z) {
+    const buf = new Uint8Array(20); // sig(4) + reserved(4) + X(4) + Y(4) + Z(4)
+    const view = new DataView(buf.buffer);
+    writeAscii(buf, 0, "XYZ ");
+    // reserved: 0
+    writeS15Fixed16(view, 8, x);
+    writeS15Fixed16(view, 12, y);
+    writeS15Fixed16(view, 16, z);
+    return buf;
+}
+/** Build an ICC 'text' tag. */
+function buildTextTag(text) {
+    const asciiLen = text.length + 1; // include null terminator
+    const buf = new Uint8Array(4 + 4 + asciiLen); // sig(4) + reserved(4) + text
+    writeAscii(buf, 0, "text");
+    for (let i = 0; i < text.length; i++) {
+        buf[8 + i] = text.charCodeAt(i);
+    }
+    return buf;
+}
+// =============================================================================
+// XMP Metadata Writer
+// =============================================================================
+/**
+ * Write a PDF/A-1b XMP metadata stream as an indirect object.
+ *
+ * The XMP packet contains:
+ * - `dc:title` — document title
+ * - `dc:creator` — document author
+ * - `xmp:CreatorTool` — creating application
+ * - `pdf:Producer` — PDF producer
+ * - `pdfaid:part` — PDF/A part (1)
+ * - `pdfaid:conformance` — PDF/A conformance level (B)
+ *
+ * @returns The object number of the XMP metadata stream.
+ */
+function writePdfAMetadata(writer, metadata) {
+    const now = new Date();
+    const isoDate = now.toISOString().replace(/\.\d{3}Z$/, "Z");
+    const title = escapeXml(metadata.title ?? "");
+    const author = escapeXml(metadata.author ?? "");
+    const subject = escapeXml(metadata.subject ?? "");
+    const creator = escapeXml(metadata.creator ?? "excelts");
+    const producer = "excelts";
+    const xmp = [
+        '<?xpacket begin="\uFEFF" id="W5M0MpCehiHzreSzNTczkc9d"?>',
+        '<x:xmpmeta xmlns:x="adobe:ns:meta/">',
+        '<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">',
+        '<rdf:Description rdf:about=""',
+        '  xmlns:dc="http://purl.org/dc/elements/1.1/"',
+        '  xmlns:xmp="http://ns.adobe.com/xap/1.0/"',
+        '  xmlns:pdf="http://ns.adobe.com/pdf/1.3/"',
+        '  xmlns:pdfaid="http://www.aiim.org/pdfa/ns/id/">',
+        "  <dc:title>",
+        '    <rdf:Alt><rdf:li xml:lang="x-default">' + title + "</rdf:li></rdf:Alt>",
+        "  </dc:title>",
+        "  <dc:creator>",
+        "    <rdf:Seq><rdf:li>" + author + "</rdf:li></rdf:Seq>",
+        "  </dc:creator>",
+        "  <dc:description>",
+        '    <rdf:Alt><rdf:li xml:lang="x-default">' + subject + "</rdf:li></rdf:Alt>",
+        "  </dc:description>",
+        "  <xmp:CreatorTool>" + creator + "</xmp:CreatorTool>",
+        "  <xmp:CreateDate>" + isoDate + "</xmp:CreateDate>",
+        "  <xmp:ModifyDate>" + isoDate + "</xmp:ModifyDate>",
+        "  <pdf:Producer>" + producer + "</pdf:Producer>",
+        "  <pdfaid:part>1</pdfaid:part>",
+        "  <pdfaid:conformance>B</pdfaid:conformance>",
+        "</rdf:Description>",
+        "</rdf:RDF>",
+        "</x:xmpmeta>",
+        '<?xpacket end="w"?>'
+    ].join("\n");
+    const encoder = new TextEncoder();
+    const xmpBytes = encoder.encode(xmp);
+    const objNum = writer.allocObject();
+    const dict = new pdf_object_1.PdfDict()
+        .set("Type", "/Metadata")
+        .set("Subtype", "/XML")
+        .set("Length", (0, pdf_object_1.pdfNumber)(xmpBytes.length));
+    // XMP metadata must NOT be compressed for PDF/A compliance
+    // (and for general discoverability by search tools)
+    writer.addStreamObject(objNum, dict, xmpBytes, { compress: false });
+    return objNum;
+}
+// =============================================================================
+// OutputIntent Writer
+// =============================================================================
+/**
+ * Write a PDF/A-1b OutputIntent with an embedded sRGB ICC profile.
+ *
+ * Creates two objects:
+ * 1. The ICC profile stream
+ * 2. The OutputIntent dictionary referencing the profile
+ *
+ * @returns The object number of the OutputIntent dictionary.
+ */
+function writePdfAOutputIntent(writer) {
+    // Write ICC profile stream
+    const iccObjNum = writer.allocObject();
+    const iccDict = new pdf_object_1.PdfDict()
+        .set("N", (0, pdf_object_1.pdfNumber)(3)) // 3 components (RGB)
+        .set("Length", (0, pdf_object_1.pdfNumber)(exports.sRGB_ICC_PROFILE.length));
+    writer.addStreamObject(iccObjNum, iccDict, exports.sRGB_ICC_PROFILE);
+    // Write OutputIntent dictionary
+    const intentObjNum = writer.allocObject();
+    const intentDict = new pdf_object_1.PdfDict()
+        .set("Type", "/OutputIntent")
+        .set("S", "/GTS_PDFA1")
+        .set("OutputConditionIdentifier", "(sRGB IEC61966-2.1)")
+        .set("RegistryName", "(http://www.color.org)")
+        .set("Info", "(sRGB IEC61966-2.1)")
+        .set("DestOutputProfile", (0, pdf_object_1.pdfRef)(iccObjNum));
+    writer.addObject(intentObjNum, intentDict);
+    return intentObjNum;
+}
+// =============================================================================
+// Helpers
+// =============================================================================
+/** Escape XML special characters for XMP content. */
+function escapeXml(str) {
+    return str
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&apos;");
+}

package/dist/cjs/modules/pdf/index.js

@@ -42,7 +42,7 @@
  * @module pdf
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isPdfError = exports.PdfStructureError = exports.PdfFontError = exports.PdfRenderError = exports.PdfError = exports.PageSizes = exports.readPdf = exports.excelToPdf = exports.pdf = void 0;
+exports.isPdfError = exports.PdfStructureError = exports.PdfFontError = exports.PdfRenderError = exports.PdfError = exports.PageSizes = exports.asn1Parse = exports.buildSignatureDictPlaceholder = exports.signPdf = exports.verifyPdfSignature = exports.PdfEditorPage = exports.PdfEditor = exports.parseSvgPath = exports.PdfPageBuilder = exports.PdfDocumentBuilder = exports.readPdf = exports.excelToPdf = exports.pdf = void 0;
 // =============================================================================
 // Public API — Writing
 // =============================================================================
@@ -58,6 +58,24 @@ Object.defineProperty(exports, "excelToPdf", { enumerable: true, get: function (
 /** Read a PDF file and extract text, images, and metadata. */
 var pdf_reader_1 = require("./reader/pdf-reader");
 Object.defineProperty(exports, "readPdf", { enumerable: true, get: function () { return pdf_reader_1.readPdf; } });
+// =============================================================================
+// Public API — Building (free-form content)
+// =============================================================================
+/** Build PDFs with free text positioning, vector drawing, and images. */
+var document_builder_1 = require("./builder/document-builder");
+Object.defineProperty(exports, "PdfDocumentBuilder", { enumerable: true, get: function () { return document_builder_1.PdfDocumentBuilder; } });
+Object.defineProperty(exports, "PdfPageBuilder", { enumerable: true, get: function () { return document_builder_1.PdfPageBuilder; } });
+Object.defineProperty(exports, "parseSvgPath", { enumerable: true, get: function () { return document_builder_1.parseSvgPath; } });
+/** Edit existing PDFs: overlay content, fill forms, copy/merge pages. */
+var pdf_editor_1 = require("./builder/pdf-editor");
+Object.defineProperty(exports, "PdfEditor", { enumerable: true, get: function () { return pdf_editor_1.PdfEditor; } });
+Object.defineProperty(exports, "PdfEditorPage", { enumerable: true, get: function () { return pdf_editor_1.PdfEditorPage; } });
+/** Digital signatures — verify and sign PDF documents. */
+var digital_signature_1 = require("./core/digital-signature");
+Object.defineProperty(exports, "verifyPdfSignature", { enumerable: true, get: function () { return digital_signature_1.verifyPdfSignature; } });
+Object.defineProperty(exports, "signPdf", { enumerable: true, get: function () { return digital_signature_1.signPdf; } });
+Object.defineProperty(exports, "buildSignatureDictPlaceholder", { enumerable: true, get: function () { return digital_signature_1.buildSignatureDictPlaceholder; } });
+Object.defineProperty(exports, "asn1Parse", { enumerable: true, get: function () { return digital_signature_1.asn1Parse; } });
 var types_1 = require("./types");
 Object.defineProperty(exports, "PageSizes", { enumerable: true, get: function () { return types_1.PageSizes; } });
 // =============================================================================

package/dist/cjs/modules/pdf/reader/bookmark-extractor.js

@@ -0,0 +1,327 @@
+"use strict";
+/**
+ * PDF bookmark (outline) extractor.
+ *
+ * Extracts the document outline tree from a PDF's `/Outlines` dictionary.
+ * Each outline item has a title, a target page index, and optional children
+ * forming a hierarchical bookmark tree.
+ *
+ * Supports:
+ * - Direct destinations (`/Dest` as array or named destination)
+ * - Action-based destinations (`/A << /S /GoTo /D ... >>`)
+ * - Nested bookmarks (children via `/First`/`/Last` chains)
+ * - Circular reference protection
+ *
+ * @see PDF Reference 1.7, §12.3 - Document-Level Navigation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractBookmarks = extractBookmarks;
+const pdf_parser_1 = require("./pdf-parser");
+const reader_utils_1 = require("./reader-utils");
+// =============================================================================
+// Constants
+// =============================================================================
+/** Maximum depth for recursive outline traversal to prevent stack overflow. */
+const MAX_OUTLINE_DEPTH = 100;
+/** Maximum number of siblings at any level to prevent infinite /Next chains. */
+const MAX_SIBLINGS = 10000;
+// =============================================================================
+// Public API
+// =============================================================================
+/**
+ * Extract bookmarks (outlines) from a PDF document.
+ *
+ * Reads the `/Outlines` dictionary from the catalog and recursively
+ * traverses the outline tree following `/First` → `/Next` chains.
+ *
+ * @param doc - The PDF document
+ * @returns Array of top-level bookmarks with nested children
+ */
+function extractBookmarks(doc) {
+    try {
+        const catalog = doc.getCatalog();
+        const outlinesObj = catalog.get("Outlines");
+        if (!outlinesObj) {
+            return [];
+        }
+        const outlinesDict = doc.derefDict(outlinesObj);
+        if (!outlinesDict) {
+            return [];
+        }
+        // Build a page reference → index map for resolving destinations
+        const pageMap = buildPageMap(doc);
+        // The outline root's /First points to the first top-level item
+        const visited = new Set();
+        return collectSiblings(outlinesDict, doc, pageMap, visited, 0);
+    }
+    catch {
+        return [];
+    }
+}
+// =============================================================================
+// Page Map
+// =============================================================================
+/**
+ * Build a map from page object reference identity to 0-based page index.
+ *
+ * We map by object number since page dicts resolved from different refs
+ * will share the same objNum.
+ */
+function buildPageMap(doc) {
+    const pages = doc.getPagesWithObjInfo();
+    const map = new Map();
+    for (let i = 0; i < pages.length; i++) {
+        const { objNum } = pages[i];
+        if (objNum !== 0) {
+            map.set(objNum, i);
+        }
+    }
+    return map;
+}
+// =============================================================================
+// Outline Tree Traversal
+// =============================================================================
+/**
+ * Collect the sibling chain starting from the `/First` child of a parent node.
+ */
+function collectSiblings(parentDict, doc, pageMap, visited, depth) {
+    if (depth > MAX_OUTLINE_DEPTH) {
+        return [];
+    }
+    const firstObj = parentDict.get("First");
+    if (!firstObj) {
+        return [];
+    }
+    const bookmarks = [];
+    let currentObj = firstObj;
+    let count = 0;
+    while (currentObj != null && count < MAX_SIBLINGS) {
+        count++;
+        // Guard against circular references using object numbers
+        if ((0, pdf_parser_1.isPdfRef)(currentObj)) {
+            if (visited.has(currentObj.objNum)) {
+                break;
+            }
+            visited.add(currentObj.objNum);
+        }
+        const itemDict = doc.derefDict(currentObj);
+        if (!itemDict) {
+            break;
+        }
+        const bookmark = parseOutlineItem(itemDict, doc, pageMap, visited, depth);
+        if (bookmark) {
+            bookmarks.push(bookmark);
+        }
+        // Follow /Next to the next sibling
+        currentObj = itemDict.get("Next");
+    }
+    return bookmarks;
+}
+/**
+ * Parse a single outline item dictionary into a PdfBookmark.
+ */
+function parseOutlineItem(dict, doc, pageMap, visited, depth) {
+    // Extract title — required per spec
+    const title = getOutlineTitle(dict, doc);
+    if (!title) {
+        return null;
+    }
+    // Resolve destination to a page index
+    const pageIndex = resolveDestination(dict, doc, pageMap);
+    // Collect children (nested bookmarks)
+    const children = collectSiblings(dict, doc, pageMap, visited, depth + 1);
+    return { title, pageIndex, children };
+}
+// =============================================================================
+// Title Extraction
+// =============================================================================
+/**
+ * Extract the title string from an outline item dictionary.
+ * The /Title entry is a text string (may be Uint8Array or string).
+ */
+function getOutlineTitle(dict, doc) {
+    return (0, reader_utils_1.getDictStringValue)(dict, "Title", doc);
+}
+// =============================================================================
+// Destination Resolution
+// =============================================================================
+/**
+ * Resolve an outline item's destination to a 0-based page index.
+ *
+ * Checks /Dest first, then falls back to /A (action) with /S /GoTo.
+ * Returns -1 if the destination cannot be resolved.
+ */
+function resolveDestination(dict, doc, pageMap) {
+    // 1. Try /Dest (direct destination)
+    const destObj = dict.get("Dest");
+    if (destObj != null) {
+        const pageIndex = resolveDestValue(destObj, doc, pageMap);
+        if (pageIndex >= 0) {
+            return pageIndex;
+        }
+    }
+    // 2. Try /A (action dictionary) with /S /GoTo
+    const actionObj = dict.get("A");
+    if (actionObj != null) {
+        const actionDict = doc.derefDict(actionObj);
+        if (actionDict) {
+            const actionType = (0, pdf_parser_1.dictGetName)(actionDict, "S");
+            if (actionType === "GoTo") {
+                const actionDest = actionDict.get("D");
+                if (actionDest != null) {
+                    return resolveDestValue(actionDest, doc, pageMap);
+                }
+            }
+        }
+    }
+    return -1;
+}
+/**
+ * Resolve a destination value (from /Dest or /A.D) to a page index.
+ *
+ * Destination formats (PDF Reference 1.7, §12.3.2):
+ * - Array: `[pageRef /XYZ left top zoom]`, `[pageRef /Fit]`, etc.
+ * - Named string: looked up in the document's /Dests or /Names.Dests
+ */
+function resolveDestValue(destObj, doc, pageMap) {
+    const resolved = doc.deref(destObj);
+    if (resolved == null) {
+        return -1;
+    }
+    // Array destination: first element is the page reference
+    if ((0, pdf_parser_1.isPdfArray)(resolved) && resolved.length >= 1) {
+        return resolvePageRef(resolved[0], doc, pageMap);
+    }
+    // Named destination (string) — look up in /Dests or /Names tree
+    if (typeof resolved === "string") {
+        return resolveNamedDest(resolved, doc, pageMap);
+    }
+    // Byte string named destination
+    if (resolved instanceof Uint8Array) {
+        const name = (0, pdf_parser_1.decodePdfStringBytes)(resolved);
+        return resolveNamedDest(name, doc, pageMap);
+    }
+    return -1;
+}
+/**
+ * Resolve a page reference (from the first element of a dest array) to a page index.
+ */
+function resolvePageRef(pageObj, doc, pageMap) {
+    // If it's a direct reference, use the object number
+    if ((0, pdf_parser_1.isPdfRef)(pageObj)) {
+        const idx = pageMap.get(pageObj.objNum);
+        return idx !== undefined ? idx : -1;
+    }
+    // If it's a page number (integer), use it directly as 0-based index
+    if (typeof pageObj === "number" && Number.isInteger(pageObj)) {
+        return pageObj;
+    }
+    return -1;
+}
+/**
+ * Look up a named destination in the catalog's /Dests dictionary
+ * or /Names.Dests name tree.
+ */
+function resolveNamedDest(name, doc, pageMap) {
+    const catalog = doc.getCatalog();
+    // 1. Try /Dests dictionary (older PDFs)
+    const destsObj = catalog.get("Dests");
+    if (destsObj != null) {
+        const destsDict = doc.derefDict(destsObj);
+        if (destsDict) {
+            const entry = destsDict.get(name);
+            if (entry != null) {
+                return resolveDestEntry(entry, doc, pageMap);
+            }
+        }
+    }
+    // 2. Try /Names.Dests name tree (PDF 1.2+)
+    const namesObj = catalog.get("Names");
+    if (namesObj != null) {
+        const namesDict = doc.derefDict(namesObj);
+        if (namesDict) {
+            const destsTreeObj = namesDict.get("Dests");
+            if (destsTreeObj != null) {
+                const value = lookupNameTree(destsTreeObj, name, doc);
+                if (value != null) {
+                    return resolveDestEntry(value, doc, pageMap);
+                }
+            }
+        }
+    }
+    return -1;
+}
+/**
+ * Resolve a destination entry value. It may be a dict with /D key,
+ * or a direct array destination.
+ */
+function resolveDestEntry(entry, doc, pageMap) {
+    const resolved = doc.deref(entry);
+    if (resolved == null) {
+        return -1;
+    }
+    // Direct array destination
+    if ((0, pdf_parser_1.isPdfArray)(resolved) && resolved.length >= 1) {
+        return resolvePageRef(resolved[0], doc, pageMap);
+    }
+    // Dictionary with /D entry (destination dictionary)
+    if (resolved instanceof Map) {
+        const d = resolved.get("D");
+        if (d != null) {
+            return resolveDestValue(d, doc, pageMap);
+        }
+    }
+    return -1;
+}
+/**
+ * Look up a key in a PDF name tree.
+ *
+ * Name trees use either /Names (leaf) or /Kids (intermediate) arrays.
+ * /Names is an array of alternating [key, value, key, value, ...] pairs.
+ *
+ * @see PDF Reference 1.7, §7.9.6 - Name Trees
+ */
+function lookupNameTree(treeObj, name, doc, depth = 0) {
+    if (depth > MAX_OUTLINE_DEPTH) {
+        return null;
+    }
+    const treeDict = doc.derefDict(treeObj);
+    if (!treeDict) {
+        return null;
+    }
+    // Check leaf /Names array
+    const namesArr = treeDict.get("Names");
+    if (namesArr != null) {
+        const resolved = doc.deref(namesArr);
+        if ((0, pdf_parser_1.isPdfArray)(resolved)) {
+            // Alternating [key, value, key, value, ...]
+            for (let i = 0; i + 1 < resolved.length; i += 2) {
+                const key = doc.deref(resolved[i]);
+                let keyStr = null;
+                if (typeof key === "string") {
+                    keyStr = key;
+                }
+                else if (key instanceof Uint8Array) {
+                    keyStr = (0, pdf_parser_1.decodePdfStringBytes)(key);
+                }
+                if (keyStr === name) {
+                    return resolved[i + 1];
+                }
+            }
+        }
+    }
+    // Check intermediate /Kids array
+    const kidsArr = treeDict.get("Kids");
+    if (kidsArr != null) {
+        const resolved = doc.deref(kidsArr);
+        if ((0, pdf_parser_1.isPdfArray)(resolved)) {
+            for (const kid of resolved) {
+                const result = lookupNameTree(kid, name, doc, depth + 1);
+                if (result != null) {
+                    return result;
+                }
+            }
+        }
+    }
+    return null;
+}

package/dist/cjs/modules/pdf/reader/pdf-decrypt.js

@@ -14,7 +14,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.initDecryption = initDecryption;
 exports.isEncrypted = isEncrypted;
-const crypto_1 = require("../core/crypto");
+const crypto_1 = require("../../../utils/crypto.js");
+const binary_1 = require("../../../utils/binary.js");
 const pdf_parser_1 = require("./pdf-parser");
 const errors_1 = require("../errors");
 // =============================================================================
@@ -168,13 +169,13 @@ function tryUserPasswordV5(passwordBytes, uValue, ueValue) {
     const uValidationSalt = uValue.subarray(32, 40);
     const uKeySalt = uValue.subarray(40, 48);
     // Validate: SHA-256(password + validation salt) == first 32 bytes of U
-    const validateInput = (0, crypto_1.concatArrays)(passwordBytes, uValidationSalt);
+    const validateInput = (0, binary_1.concatUint8Arrays)([passwordBytes, uValidationSalt]);
     const computedHash = (0, crypto_1.sha256)(validateInput);
     if (!arraysEqual(computedHash, uHash)) {
         return null;
     }
     // Derive key: SHA-256(password + key salt) => use as AES-256 key to decrypt UE
-    const keyInput = (0, crypto_1.concatArrays)(passwordBytes, uKeySalt);
+    const keyInput = (0, binary_1.concatUint8Arrays)([passwordBytes, uKeySalt]);
     const keyHash = (0, crypto_1.sha256)(keyInput);
     // Decrypt UE with this key using AES-256-CBC with zero IV
     const zeroIv = new Uint8Array(16);
@@ -192,13 +193,13 @@ function tryOwnerPasswordV5(passwordBytes, oValue, oeValue, uValue) {
     const oKeySalt = oValue.subarray(40, 48);
     const u48 = uValue.subarray(0, 48);
     // Validate: SHA-256(password + validation salt + U(0..47)) == first 32 bytes of O
-    const validateInput = (0, crypto_1.concatArrays)(passwordBytes, oValidationSalt, u48);
+    const validateInput = (0, binary_1.concatUint8Arrays)([passwordBytes, oValidationSalt, u48]);
     const computedHash = (0, crypto_1.sha256)(validateInput);
     if (!arraysEqual(computedHash, oHash)) {
         return null;
     }
     // Derive key: SHA-256(password + key salt + U(0..47))
-    const keyInput = (0, crypto_1.concatArrays)(passwordBytes, oKeySalt, u48);
+    const keyInput = (0, binary_1.concatUint8Arrays)([passwordBytes, oKeySalt, u48]);
     const keyHash = (0, crypto_1.sha256)(keyInput);
     // Decrypt OE with this key using AES-256-CBC with zero IV
     const zeroIv = new Uint8Array(16);