pretext-pdf 0.1.1

package/dist/fonts.js

@@ -0,0 +1,310 @@
+import fontkit from '@pdf-lib/fontkit';
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { PretextPdfError } from './errors.js';
+import { buildFontKey } from './measure.js';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+/**
+ * Font loading strategy:
+ * - TTF files for pdf-lib embedding (fontkit handles TTF natively, woff2 has glyph corruption bugs)
+ * - woff2 for @napi-rs/canvas measurement (canvas handles woff2 perfectly via Skia)
+ *
+ * TTF priority: bundled fonts/ dir first, then @fontsource woff2 as fallback
+ */
+/** Path to bundled Inter 400 normal font — TTF preferred for pdf-lib */
+const BUNDLED_INTER_PATHS = [
+    path.join(__dirname, '..', 'fonts', 'Inter-Regular.ttf'),
+    path.join(__dirname, '..', 'node_modules', '@fontsource', 'inter', 'files', 'inter-latin-400-normal.woff2'),
+    path.join(__dirname, '..', 'node_modules', '@fontsource', 'inter', 'files', 'inter-all-400-normal.woff2'),
+];
+/** Path to bundled Inter 700 (bold) font — TTF preferred for pdf-lib */
+const BUNDLED_INTER_BOLD_PATHS = [
+    path.join(__dirname, '..', 'fonts', 'Inter-Bold.ttf'),
+    path.join(__dirname, '..', 'node_modules', '@fontsource', 'inter', 'files', 'inter-latin-700-normal.woff2'),
+    path.join(__dirname, '..', 'node_modules', '@fontsource', 'inter', 'files', 'inter-all-700-normal.woff2'),
+];
+/**
+ * Stage 2: Load and embed all fonts.
+ * - Scans document for all font references
+ * - Loads font bytes (file system or Uint8Array)
+ * - Embeds each into pdfDoc via fontkit
+ * - Returns FontMap for use in measure + render stages
+ *
+ * NOTE: pdfDoc is already created by the caller. Fonts are embedded into it here.
+ * The same pdfDoc is used in Stage 5 (render).
+ */
+export async function loadFonts(doc, pdfDoc) {
+    pdfDoc.registerFontkit(fontkit);
+    const fontMap = new Map();
+    const defaultFamily = doc.defaultFont ?? 'Inter';
+    // Collect all font variants referenced in the document
+    const needed = collectNeededFonts(doc);
+    // Always ensure Inter 400 is available as the default fallback
+    if (!needed.has(buildFontKey('Inter', 400, 'normal'))) {
+        needed.set(buildFontKey('Inter', 400, 'normal'), {
+            family: 'Inter', weight: 400, style: 'normal', src: 'bundled'
+        });
+    }
+    if (!needed.has(buildFontKey('Inter', 700, 'normal'))) {
+        needed.set(buildFontKey('Inter', 700, 'normal'), {
+            family: 'Inter', weight: 700, style: 'normal', src: 'bundled'
+        });
+    }
+    // Load all font bytes in parallel
+    const loadPromises = Array.from(needed.entries()).map(async ([key, spec]) => {
+        const bytes = await loadFontBytes(spec);
+        return { key, bytes, spec };
+    });
+    const loaded = await Promise.all(loadPromises);
+    // Embed each font into pdfDoc (must be sequential — pdf-lib limitation)
+    for (const { key, bytes, spec } of loaded) {
+        try {
+            // Phase 6D: Use fontkit's built-in subsetting for TTF fonts.
+            // TTF magic bytes: 0x00010000 (TrueType) or 0x74727565 ('true').
+            // woff2 starts with 0x774F4632 — fontkit has a known subsetting bug for woff2.
+            const isTTF = bytes.length >= 4 && ((bytes[0] === 0x00 && bytes[1] === 0x01 && bytes[2] === 0x00 && bytes[3] === 0x00) ||
+                (bytes[0] === 0x74 && bytes[1] === 0x72 && bytes[2] === 0x75 && bytes[3] === 0x65));
+            const pdfFont = await pdfDoc.embedFont(bytes, { subset: isTTF });
+            fontMap.set(key, pdfFont);
+        }
+        catch (err) {
+            throw new PretextPdfError('FONT_EMBED_FAILED', `Failed to embed font "${spec.family ?? key}": ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    // Set default font
+    const defaultKey = buildFontKey(defaultFamily, 400, 'normal');
+    if (!fontMap.has(defaultKey)) {
+        // Default font wasn't explicitly added — try Inter as fallback
+        const interKey = buildFontKey('Inter', 400, 'normal');
+        const interFont = fontMap.get(interKey);
+        if (interFont) {
+            fontMap.set(defaultKey, interFont);
+        }
+    }
+    return fontMap;
+}
+/**
+ * Scan document to collect every unique font variant needed.
+ * Returns a Map from fontKey → FontSpec-like descriptor.
+ */
+function collectNeededFonts(doc) {
+    const needed = new Map();
+    const defaultFamily = doc.defaultFont ?? 'Inter';
+    // Build lookup from user-provided fonts
+    const userFonts = new Map();
+    for (const f of doc.fonts ?? []) {
+        const key = buildFontKey(f.family, f.weight ?? 400, f.style ?? 'normal');
+        userFonts.set(key, f);
+    }
+    const addFont = (family, weight, style) => {
+        const key = buildFontKey(family, weight, style);
+        if (needed.has(key))
+            return;
+        const userFont = userFonts.get(key);
+        if (userFont) {
+            needed.set(key, { ...userFont, src: userFont.src });
+        }
+        else if (family === 'Inter') {
+            needed.set(key, { family, weight, style, src: 'bundled' });
+        }
+        else {
+            // Font variant referenced but not in doc.fonts.
+            // validate() should have caught this — if we reach here it's a bug in the validation layer.
+            throw new PretextPdfError('FONT_EMBED_FAILED', `Font variant "${key}" is required by the document but was not found in doc.fonts and is not a bundled variant. This is a bug — font validation should have caught this.`);
+        }
+    };
+    // Default font always needed
+    addFont(defaultFamily, 400, 'normal');
+    // Scan content — collect every font variant referenced by every element type
+    for (const el of doc.content) {
+        if (el.type === 'paragraph') {
+            const family = el.fontFamily ?? defaultFamily;
+            const weight = el.fontWeight ?? 400;
+            addFont(family, weight, 'normal');
+        }
+        else if (el.type === 'heading') {
+            const family = el.fontFamily ?? defaultFamily;
+            const weight = el.fontWeight ?? 700;
+            addFont(family, weight, 'normal');
+        }
+        else if (el.type === 'code') {
+            addFont(el.fontFamily, 400, 'normal');
+        }
+        else if (el.type === 'rich-paragraph') {
+            for (const span of el.spans) {
+                addFont(span.fontFamily ?? defaultFamily, span.fontWeight ?? 400, span.fontStyle ?? 'normal');
+            }
+        }
+        else if (el.type === 'list') {
+            for (const item of el.items) {
+                if ((item.fontWeight ?? 400) === 700)
+                    addFont(defaultFamily, 700, 'normal');
+                for (const nested of item.items ?? []) {
+                    if ((nested.fontWeight ?? 400) === 700)
+                        addFont(defaultFamily, 700, 'normal');
+                }
+            }
+        }
+        else if (el.type === 'table') {
+            // Table cells can use bold (headers) or custom weights
+            addFont(defaultFamily, 400, 'normal');
+            for (const row of el.rows) {
+                for (const cell of row.cells) {
+                    const cellFamily = cell.fontFamily ?? defaultFamily;
+                    const cellWeight = cell.fontWeight ?? (row.isHeader ? 700 : 400);
+                    addFont(cellFamily, cellWeight, 'normal');
+                }
+                if (row.isHeader)
+                    addFont(defaultFamily, 700, 'normal');
+            }
+        }
+        else if (el.type === 'blockquote') {
+            const family = el.fontFamily ?? defaultFamily;
+            const weight = el.fontWeight ?? 400;
+            const style = el.fontStyle ?? 'normal';
+            addFont(family, weight, style);
+        }
+        // spacer, image, hr, page-break use default font (already added)
+    }
+    // Header/footer fonts
+    if (doc.header) {
+        const family = doc.header.fontFamily ?? defaultFamily;
+        addFont(family, doc.header.fontWeight ?? 400, 'normal');
+    }
+    if (doc.footer) {
+        const family = doc.footer.fontFamily ?? defaultFamily;
+        addFont(family, doc.footer.fontWeight ?? 400, 'normal');
+    }
+    // Watermark font (text watermark only)
+    if (doc.watermark?.text) {
+        const family = doc.watermark.fontFamily ?? defaultFamily;
+        addFont(family, doc.watermark.fontWeight ?? 400, 'normal');
+    }
+    return needed;
+}
+/** Load font bytes from file path, Uint8Array, or bundled Inter */
+async function loadFontBytes(spec) {
+    if (spec.src instanceof Uint8Array) {
+        return spec.src;
+    }
+    if (spec.src === 'bundled') {
+        const paths = (spec.weight ?? 400) >= 600 ? BUNDLED_INTER_BOLD_PATHS : BUNDLED_INTER_PATHS;
+        for (const p of paths) {
+            if (fs.existsSync(p)) {
+                try {
+                    const buffer = fs.readFileSync(p);
+                    return new Uint8Array(buffer);
+                }
+                catch {
+                    // Try next
+                }
+            }
+        }
+        throw new PretextPdfError('FONT_LOAD_FAILED', `Bundled Inter font not found. Make sure @fontsource/inter is installed: npm install @fontsource/inter`);
+    }
+    // String path — relative paths will likely fail on different working directories
+    if (!path.isAbsolute(spec.src)) {
+        throw new PretextPdfError('FONT_LOAD_FAILED', `Font path "${spec.src}" is relative. Use an absolute path (e.g. path.join(__dirname, 'fonts/Roboto.ttf')) to avoid resolution issues.`);
+    }
+    if (!fs.existsSync(spec.src)) {
+        throw new PretextPdfError('FONT_LOAD_FAILED', `Font file not found: "${spec.src}". Check the path in doc.fonts[].src.`);
+    }
+    try {
+        const buffer = fs.readFileSync(spec.src);
+        return new Uint8Array(buffer);
+    }
+    catch (err) {
+        throw new PretextPdfError('FONT_LOAD_FAILED', `Failed to read font file "${spec.src}": ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+/**
+ * Walk all content elements + header/footer and collect text strings grouped by font key.
+ * Used by Phase 6D font subsetting to determine which glyphs each font needs.
+ *
+ * Returns: Map<fontKey, concatenated text string>
+ */
+export function collectTextByFont(doc) {
+    const defaultFont = doc.defaultFont ?? 'Inter';
+    const textSets = new Map();
+    function addText(fontKey, text) {
+        if (!textSets.has(fontKey))
+            textSets.set(fontKey, new Set());
+        textSets.get(fontKey).add(text);
+    }
+    for (const el of doc.content) {
+        switch (el.type) {
+            case 'paragraph': {
+                const key = buildFontKey(el.fontFamily ?? defaultFont, el.fontWeight ?? 400, 'normal');
+                addText(key, el.text);
+                break;
+            }
+            case 'heading': {
+                const key = buildFontKey(el.fontFamily ?? defaultFont, el.fontWeight ?? 700, 'normal');
+                addText(key, el.text);
+                break;
+            }
+            case 'blockquote': {
+                const key = buildFontKey(el.fontFamily ?? defaultFont, el.fontWeight ?? 400, el.fontStyle ?? 'normal');
+                addText(key, el.text);
+                break;
+            }
+            case 'code': {
+                const key = buildFontKey(el.fontFamily, 400, 'normal');
+                addText(key, el.text);
+                break;
+            }
+            case 'rich-paragraph': {
+                for (const span of el.spans) {
+                    const key = buildFontKey(span.fontFamily ?? defaultFont, span.fontWeight ?? 400, span.fontStyle ?? 'normal');
+                    addText(key, span.text);
+                }
+                break;
+            }
+            case 'table': {
+                for (const row of el.rows) {
+                    for (const cell of row.cells) {
+                        const key = buildFontKey(cell.fontFamily ?? defaultFont, cell.fontWeight ?? (row.isHeader ? 700 : 400), 'normal');
+                        addText(key, cell.text);
+                    }
+                }
+                break;
+            }
+            case 'list': {
+                const collectItems = (items) => {
+                    for (const item of items) {
+                        const key = buildFontKey(defaultFont, item.fontWeight ?? 400, 'normal');
+                        addText(key, item.text);
+                        if (item.items)
+                            collectItems(item.items);
+                    }
+                };
+                collectItems(el.items);
+                break;
+            }
+            // spacer, hr, page-break, image: no text to collect
+        }
+    }
+    // Header/footer: include static text + digits for {{pageNumber}}/{{totalPages}} expansion
+    const DIGITS = '0123456789';
+    if (doc.header) {
+        const key = buildFontKey(doc.header.fontFamily ?? defaultFont, doc.header.fontWeight ?? 400, 'normal');
+        addText(key, doc.header.text + DIGITS);
+    }
+    if (doc.footer) {
+        const key = buildFontKey(doc.footer.fontFamily ?? defaultFont, doc.footer.fontWeight ?? 400, 'normal');
+        addText(key, doc.footer.text + DIGITS);
+    }
+    // Watermark text (if present)
+    if (doc.watermark?.text) {
+        const key = buildFontKey(doc.watermark.fontFamily ?? defaultFont, doc.watermark.fontWeight ?? 400, 'normal');
+        addText(key, doc.watermark.text);
+    }
+    // Concatenate all text for each font key into one string
+    const result = new Map();
+    for (const [key, texts] of textSets) {
+        result.set(key, Array.from(texts).join(''));
+    }
+    return result;
+}
+//# sourceMappingURL=fonts.js.map

package/dist/fonts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fonts.js","sourceRoot":"","sources":["../src/fonts.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+import type { PdfDocument } from './types.js';
+export type { PdfDocument, DocumentMetadata, ContentElement, ParagraphElement, HeadingElement, SpacerElement, TableElement, ColumnDef, TableRow, TableCell, ImageElement, SvgElement, ListElement, ListItem, HorizontalRuleElement, PageBreakElement, CodeBlockElement, RichParagraphElement, BlockquoteElement, InlineSpan, RichLine, RichFragment, FontSpec, HeaderFooterSpec, WatermarkSpec, EncryptionSpec, BookmarkConfig, HyphenationConfig, Margins, } from './types.js';
+export { PretextPdfError } from './errors.js';
+export type { ErrorCode } from './errors.js';
+export type { NamedPageSize } from './page-sizes.js';
+export { createPdf } from './builder.js';
+export type { PdfBuilderOptions } from './builder.js';
+/**
+ * Render a PdfDocument to PDF bytes.
+ *
+ * Works in Node.js (requires @napi-rs/canvas peer dep) and in the browser.
+ *
+ * @example
+ * ```ts
+ * import { render } from 'pretext-pdf'
+ *
+ * const pdf = await render({
+ *   content: [
+ *     { type: 'heading', level: 1, text: 'Hello World' },
+ *     { type: 'paragraph', text: 'This is a paragraph.' },
+ *     { type: 'hr' },
+ *     { type: 'list', style: 'unordered', items: [{ text: 'Item one' }, { text: 'Item two' }] },
+ *   ]
+ * })
+ * fs.writeFileSync('output.pdf', pdf)
+ * ```
+ */
+export declare function render(doc: PdfDocument): Promise<Uint8Array>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAmD,MAAM,YAAY,CAAA;AAY9F,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,UAAU,EACV,WAAW,EACX,QAAQ,EACR,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,QAAQ,EACR,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,OAAO,GACR,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7C,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAErD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,MAAM,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAqIlE"}

package/dist/index.js

@@ -0,0 +1,154 @@
+import { PDFDocument } from 'pdf-lib';
+import { PretextPdfError } from './errors.js';
+import { resolvePageDimensions } from './page-sizes.js';
+import { validate } from './validate.js';
+import { loadFonts } from './fonts.js';
+import { loadImages } from './assets.js';
+import { measureAllBlocks, measureHeaderFooterHeight } from './measure.js';
+import { paginate } from './paginate.js';
+import { renderDocument } from './render.js';
+export { PretextPdfError } from './errors.js';
+export { createPdf } from './builder.js';
+/**
+ * Render a PdfDocument to PDF bytes.
+ *
+ * Works in Node.js (requires @napi-rs/canvas peer dep) and in the browser.
+ *
+ * @example
+ * ```ts
+ * import { render } from 'pretext-pdf'
+ *
+ * const pdf = await render({
+ *   content: [
+ *     { type: 'heading', level: 1, text: 'Hello World' },
+ *     { type: 'paragraph', text: 'This is a paragraph.' },
+ *     { type: 'hr' },
+ *     { type: 'list', style: 'unordered', items: [{ text: 'Item one' }, { text: 'Item two' }] },
+ *   ]
+ * })
+ * fs.writeFileSync('output.pdf', pdf)
+ * ```
+ */
+export async function render(doc) {
+    // ── Install Node.js canvas polyfill FIRST, before any Pretext import ─────────
+    // This MUST happen before measure.ts lazily imports @chenglou/pretext.
+    if (typeof OffscreenCanvas === 'undefined' && typeof window === 'undefined') {
+        const { installNodePolyfill } = await import('./node-polyfill.js');
+        await installNodePolyfill();
+    }
+    // ── Stage 1: Validate ─────────────────────────────────────────────────────────
+    validate(doc);
+    // ── Resolve page geometry ──────────────────────────────────────────────────────
+    const [pageWidth, pageHeight] = resolvePageDimensions(doc.pageSize);
+    const margins = {
+        top: 72,
+        bottom: 72,
+        left: 72,
+        right: 72,
+        ...doc.margins,
+    };
+    const contentWidth = pageWidth - margins.left - margins.right;
+    if (contentWidth <= 0) {
+        throw new PretextPdfError('PAGE_TOO_SMALL', `Content width is ${contentWidth}pt after applying margins. Reduce margins or increase page size.`);
+    }
+    // ── Stage 2: Load Fonts + Images ──────────────────────────────────────────────
+    // pdfDoc is created ONCE here and passed to all stages.
+    const pdfDoc = await PDFDocument.create();
+    // Set PDF metadata before loading anything else
+    if (doc.metadata) {
+        const m = doc.metadata;
+        if (m.title)
+            pdfDoc.setTitle(m.title);
+        if (m.author)
+            pdfDoc.setAuthor(m.author);
+        if (m.subject)
+            pdfDoc.setSubject(m.subject);
+        if (m.keywords)
+            pdfDoc.setKeywords(m.keywords);
+        pdfDoc.setCreator(m.creator ?? 'pretext-pdf');
+    }
+    const fontMap = await loadFonts(doc, pdfDoc);
+    const imageMap = await loadImages(doc, pdfDoc, contentWidth);
+    // ── Measure header/footer heights (needed to compute available content area) ───
+    const defaultFont = doc.defaultFont ?? 'Inter';
+    const headerHeight = doc.header
+        ? await measureHeaderFooterHeight(doc.header.text, doc.header.fontSize ?? 10, doc.header.fontFamily ?? defaultFont, contentWidth, (doc.header.fontSize ?? 10) * 1.4) + 8 // 8pt padding between header and content
+        : 0;
+    const footerHeight = doc.footer
+        ? await measureHeaderFooterHeight(doc.footer.text, doc.footer.fontSize ?? 10, doc.footer.fontFamily ?? defaultFont, contentWidth, (doc.footer.fontSize ?? 10) * 1.4) + 8
+        : 0;
+    const contentHeight = pageHeight - margins.top - margins.bottom - headerHeight - footerHeight;
+    if (contentHeight <= 0) {
+        throw new PretextPdfError('PAGE_TOO_SMALL', `Content height is ${contentHeight}pt after applying margins + header/footer. Try reducing margins, header/footer font size, or increasing page size.`);
+    }
+    // ── Stage 3: Measure ──────────────────────────────────────────────────────────
+    // measureAllBlocks handles:
+    // - image key resolution (content index → img-N key)
+    // - list flattening (1 ListElement → N MeasuredBlocks)
+    // - all other elements (direct 1:1 mapping)
+    let measuredBlocks = await measureAllBlocks(doc, contentWidth, imageMap, contentHeight);
+    // ── Two-Pass TOC (if document contains a toc element) ───────────────────────────
+    const { buildTocEntryBlocks } = await import('./measure.js');
+    const tocIndex = doc.content.findIndex(el => el.type === 'toc');
+    if (tocIndex !== -1) {
+        const tocElement = doc.content[tocIndex]; // TocElement type
+        // Pass 1: paginate without real TOC content to collect heading page numbers
+        const draftPaginatedDoc = paginate(measuredBlocks, contentHeight);
+        // Build real TOC entry blocks using draft page numbers
+        const tocEntryBlocks = await buildTocEntryBlocks(draftPaginatedDoc.headings, tocElement, contentWidth, doc);
+        // Splice TOC entries into measuredBlocks at the placeholder index
+        // The placeholder (zero-height) block at tocIndex is replaced by the entry blocks
+        measuredBlocks = [
+            ...measuredBlocks.slice(0, tocIndex),
+            ...tocEntryBlocks,
+            ...measuredBlocks.slice(tocIndex + 1),
+        ];
+    }
+    // ────────────────────────────────────────────────────────────────────────────────
+    // ── Stage 4: Paginate (pure function) ─────────────────────────────────────────
+    const paginatedDoc = paginate(measuredBlocks, contentHeight, {
+        minOrphanLines: 2,
+        minWidowLines: 2,
+    });
+    // ── Stage 5: Render ───────────────────────────────────────────────────────────
+    const geo = {
+        pageWidth,
+        pageHeight,
+        margins,
+        contentWidth,
+        contentHeight,
+        headerHeight,
+        footerHeight,
+    };
+    const rawBytes = await renderDocument(paginatedDoc, doc, fontMap, imageMap, pdfDoc, geo);
+    return doc.encryption ? await applyEncryption(rawBytes, doc.encryption) : rawBytes;
+}
+/**
+ * Stage 6: Apply encryption (post-process).
+ * Lazy-loads @cantoo/pdf-lib only when encryption is needed.
+ * Uses dynamic import with 'as string' cast to bypass TypeScript module resolution.
+ */
+async function applyEncryption(pdfBytes, enc) {
+    // Lazy-load @cantoo/pdf-lib — only imported when encryption is actually needed
+    let cantoo;
+    try {
+        cantoo = await import('@cantoo/pdf-lib');
+    }
+    catch {
+        throw new PretextPdfError('ENCRYPTION_NOT_AVAILABLE', 'doc.encryption requires @cantoo/pdf-lib. Install it: pnpm add @cantoo/pdf-lib');
+    }
+    const encDoc = await cantoo.PDFDocument.load(pdfBytes);
+    encDoc.encrypt({
+        userPassword: enc.userPassword ?? '',
+        ownerPassword: enc.ownerPassword ?? globalThis.crypto.randomUUID(),
+        permissions: {
+            printing: enc.permissions?.printing ?? true,
+            copying: enc.permissions?.copying ?? true,
+            modifying: enc.permissions?.modifying ?? false,
+            annotating: enc.permissions?.annotating ?? true,
+        },
+    });
+    // useObjectStreams: false is required for Adobe Reader compatibility with encrypted PDFs
+    return encDoc.save({ useObjectStreams: false });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/measure.d.ts

@@ -0,0 +1,53 @@
+import type { PdfDocument, ContentElement, MeasuredBlock, ImageMap, ColumnDef } from './types.js';
+type HypherInstance = {
+    hyphenate(word: string): string[];
+};
+type HyphenatorOpts = {
+    instance: HypherInstance;
+    minWordLength: number;
+    leftMin: number;
+    rightMin: number;
+};
+/**
+ * Stage 3: Measure a single content element.
+ *
+ * Returns MeasuredBlock for most types.
+ * Returns MeasuredBlock[] for 'list' (each item becomes an independent block).
+ *
+ * NOTE: Image elements cannot be measured here — use measureAllBlocks() instead,
+ * which resolves the content-index-based imageMap key before calling measureImageWithKey().
+ */
+export declare function measureBlock(element: ContentElement, contentWidth: number, doc: PdfDocument, hyphenatorOpts?: HyphenatorOpts): Promise<MeasuredBlock | MeasuredBlock[]>;
+/**
+ * Resolve column width definitions to concrete pt values.
+ * Fixed widths are used as-is. Star widths ('2*', '*') share the remaining space.
+ * 'auto' columns use naturalWidths[i] (measured content width) — caller must pre-compute these.
+ *
+ * naturalWidths is required if any column uses 'auto'. It maps column index → natural text width in pt
+ * (the minimum width needed to display cell text on one line, including cellPaddingH on both sides).
+ */
+export declare function resolveColumnWidths(columns: ColumnDef[], contentWidth: number, cellPaddingH: number, borderWidth: number, naturalWidths?: number[]): number[];
+/**
+ * Measure a short header/footer string — returns total height in pt.
+ */
+export declare function measureHeaderFooterHeight(text: string, fontSize: number, fontFamily: string, contentWidth: number, lineHeight: number): Promise<number>;
+/** Build a font map key from family + weight + style */
+export declare function buildFontKey(family: string, weight: 400 | 700, style: 'normal' | 'italic'): string;
+/**
+ * Build measured TOC entry blocks from collected headings.
+ * Called during two-pass mode after first pagination to generate the actual TOC content.
+ */
+export declare function buildTocEntryBlocks(headings: Array<{
+    text: string;
+    level: 1 | 2 | 3 | 4;
+    pageIndex: number;
+}>, tocElement: import('./types.js').TocElement, contentWidth: number, doc: PdfDocument): Promise<import('./types.js').MeasuredBlock[]>;
+/**
+ * Measure all content elements in a document.
+ * Handles list flattening (lists return MeasuredBlock[]).
+ * Handles image key resolution (images need their content-index-based key).
+ * Initializes hyphenator if doc.hyphenation is configured.
+ */
+export declare function measureAllBlocks(doc: PdfDocument, contentWidth: number, imageMap: ImageMap, pageContentHeight: number): Promise<MeasuredBlock[]>;
+export {};
+//# sourceMappingURL=measure.d.ts.map

package/dist/measure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure.d.ts","sourceRoot":"","sources":["../src/measure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EAAE,cAAc,EAAE,aAAa,EAE7B,QAAQ,EAAE,SAAS,EACjC,MAAM,YAAY,CAAA;AAwBnB,KAAK,cAAc,GAAG;IAAE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;CAAE,CAAA;AAC3D,KAAK,cAAc,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAA;AA8F5G;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,cAAc,EACvB,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,WAAW,EAChB,cAAc,CAAC,EAAE,cAAc,GAC9B,OAAO,CAAC,aAAa,GAAG,aAAa,EAAE,CAAC,CAiV1C;AAkWD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,SAAS,EAAE,EACpB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,MAAM,EAAE,GACvB,MAAM,EAAE,CA4EV;AA+MD;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAejB;AAED,wDAAwD;AACxD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,GAAG,EAAE,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAElG;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,EAC1E,UAAU,EAAE,OAAO,YAAY,EAAE,UAAU,EAC3C,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,OAAO,YAAY,EAAE,aAAa,EAAE,CAAC,CAmD/C;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,WAAW,EAChB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,QAAQ,EAClB,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,aAAa,EAAE,CAAC,CA8C1B"}