pretext-pdf 1.1.1 → 1.6.0

package/dist/render-blocks.js

@@ -1,1059 +0,0 @@
-/**
- * render-blocks.ts — Element-level rendering functions
- * All the specific renderer functions for different content types.
- */
-import { rgb, degrees } from '@cantoo/pdf-lib';
-import { PretextPdfError } from './errors.js';
-import { drawJustifiedLine, addLinkAnnotation, addStickyNoteAnnotation, drawTextDecoration, toPdfY, resolveX, resolveTokens, hexToRgb, drawTabularText, LINE_HEIGHT_BODY, LINE_HEIGHT_COMPACT, } from './render-utils.js';
-import { buildFontKey } from './measure.js';
-// ─── Text block rendering (paragraph + heading) ───────────────────────────────
-export function renderTextBlock(pdfPage, pagedBlock, geo, fontMap, pdfDoc) {
-    const { measuredBlock, startLine, endLine, yFromTop } = pagedBlock;
-    const { element } = measuredBlock;
-    const lines = measuredBlock.lines.slice(startLine, endLine);
-    if (lines.length === 0)
-        return;
-    const pdfFont = fontMap.get(measuredBlock.fontKey);
-    if (!pdfFont) {
-        throw new PretextPdfError('FONT_NOT_LOADED', `Font "${measuredBlock.fontKey}" not found in fontMap. This is a bug — font validation should have caught this.`);
-    }
-    const colorHex = (element.type === 'paragraph' || element.type === 'heading')
-        ? (element.color ?? '#000000')
-        : '#000000';
-    const [r, g, b] = hexToRgb(colorHex);
-    const alignRaw = (element.type === 'paragraph' || element.type === 'heading')
-        ? (element.align ?? (measuredBlock.isRTL ? 'right' : 'left'))
-        : 'left';
-    // For resolveX, treat 'justify' as 'left' (justify is handled by drawJustifiedLine)
-    const align = alignRaw === 'justify' ? 'left' : alignRaw;
-    const fontHeight = pdfFont.heightAtSize(measuredBlock.fontSize);
-    // Narrowed reference for paragraph/heading-only fields (smallCaps, tabularNumbers, letterSpacing, annotation)
-    const textElement = (element.type === 'paragraph' || element.type === 'heading') ? element : null;
-    // Draw background color for paragraph and heading (if set)
-    if ((element.type === 'paragraph' || element.type === 'heading') && element.bgColor) {
-        const columnData = measuredBlock.columnData;
-        const chunkHeight = columnData
-            ? columnData.linesPerColumn * measuredBlock.lineHeight
-            : lines.length * measuredBlock.lineHeight;
-        const boxAbsY = yFromTop + geo.margins.top + geo.headerHeight;
-        const boxPdfY = toPdfY(boxAbsY, chunkHeight, geo.pageHeight);
-        const [bgR, bgG, bgB] = hexToRgb(element.bgColor);
-        pdfPage.drawRectangle({
-            x: geo.margins.left,
-            y: boxPdfY,
-            width: geo.contentWidth,
-            height: chunkHeight,
-            color: rgb(bgR, bgG, bgB),
-            borderWidth: 0,
-        });
-    }
-    // Multi-column layout — mirrors single-column features (smallCaps, letterSpacing, justify, decoration)
-    const columnData = measuredBlock.columnData;
-    if (columnData) {
-        const { columnGap, columnWidth, linesPerColumn } = columnData;
-        const hasSmallCaps = textElement?.smallCaps === true;
-        const mcFontSize = hasSmallCaps ? measuredBlock.fontSize * 0.8 : measuredBlock.fontSize;
-        const hasTabular = textElement?.tabularNumbers === true;
-        const letterSpacing = (textElement?.letterSpacing ?? 0) > 0 ? textElement.letterSpacing : 0;
-        for (let i = 0; i < lines.length; i++) {
-            const line = lines[i];
-            if (line.text === '')
-                continue;
-            const colIdx = Math.floor(i / linesPerColumn);
-            const lineInCol = i % linesPerColumn;
-            const lineYFromTop = yFromTop + (lineInCol * measuredBlock.lineHeight);
-            const absoluteYFromTop = lineYFromTop + geo.margins.top + geo.headerHeight;
-            const pdfY = toPdfY(absoluteYFromTop, fontHeight, geo.pageHeight);
-            const colX = geo.margins.left + colIdx * (columnWidth + columnGap);
-            let trimmedText = line.text.trimEnd();
-            if (hasSmallCaps)
-                trimmedText = trimmedText.toUpperCase();
-            // Last line of each column should not be force-justified (left-align instead)
-            const isLastLineInCol = lineInCol === linesPerColumn - 1 || i === lines.length - 1;
-            let drawX;
-            if (alignRaw === 'justify' && letterSpacing === 0 && !hasTabular) {
-                drawJustifiedLine(pdfPage, trimmedText, isLastLineInCol, colX, pdfY, columnWidth, mcFontSize, pdfFont, rgb(r, g, b));
-                drawX = colX;
-            }
-            else if (letterSpacing > 0) {
-                const alignWidth = pdfFont.widthOfTextAtSize(trimmedText, mcFontSize) + letterSpacing * (trimmedText.length - 1);
-                drawX = resolveX(align, colX, columnWidth, alignWidth);
-                let cx = drawX;
-                for (const ch of trimmedText) {
-                    pdfPage.drawText(ch, { x: cx, y: pdfY, size: mcFontSize, font: pdfFont, color: rgb(r, g, b) });
-                    cx += pdfFont.widthOfTextAtSize(ch, mcFontSize) + letterSpacing;
-                }
-            }
-            else if (hasTabular) {
-                const alignWidth = pdfFont.widthOfTextAtSize(trimmedText, mcFontSize);
-                drawX = resolveX(align, colX, columnWidth, alignWidth);
-                drawTabularText(pdfPage, trimmedText, drawX, pdfY, mcFontSize, pdfFont, rgb(r, g, b));
-            }
-            else {
-                const alignWidth = pdfFont.widthOfTextAtSize(trimmedText, mcFontSize);
-                drawX = resolveX(align, colX, columnWidth, alignWidth);
-                pdfPage.drawText(trimmedText, { x: drawX, y: pdfY, size: mcFontSize, font: pdfFont, color: rgb(r, g, b) });
-            }
-            // Text decoration (underline, strikethrough)
-            if ((element.type === 'paragraph' || element.type === 'heading') && (element.underline || element.strikethrough)) {
-                const lineWidth = pdfFont.widthOfTextAtSize(trimmedText, mcFontSize) + (letterSpacing > 0 ? letterSpacing * (trimmedText.length - 1) : 0);
-                drawTextDecoration(pdfPage, drawX, lineWidth, pdfY, mcFontSize, pdfFont, [r, g, b], { underline: element.underline ?? false, strikethrough: element.strikethrough ?? false });
-            }
-            // Hyperlink annotation
-            if ((element.type === 'paragraph' || element.type === 'heading') && element.url) {
-                const lineWidth = pdfFont.widthOfTextAtSize(trimmedText, mcFontSize) + (letterSpacing > 0 ? letterSpacing * (trimmedText.length - 1) : 0);
-                addLinkAnnotation(pdfDoc, pdfPage, drawX, pdfY, lineWidth, mcFontSize, element.url);
-            }
-        }
-        // Sticky note annotation (once per block, not per line)
-        if (textElement?.annotation) {
-            const ann = textElement.annotation;
-            const absY = yFromTop + geo.margins.top + geo.headerHeight;
-            const annotPdfY = geo.pageHeight - absY;
-            addStickyNoteAnnotation(pdfDoc, pdfPage, geo.margins.left, annotPdfY, ann.contents, ann.author, ann.color, ann.open);
-        }
-        return; // skip standard single-column path
-    }
-    // Single-column layout (standard path)
-    for (let i = 0; i < lines.length; i++) {
-        const line = lines[i];
-        if (line.text === '')
-            continue; // empty lines from \n\n — occupy space, draw nothing
-        const lineYFromTop = yFromTop + (i * measuredBlock.lineHeight);
-        const absoluteYFromTop = lineYFromTop + geo.margins.top + geo.headerHeight;
-        const pdfY = toPdfY(absoluteYFromTop, fontHeight, geo.pageHeight);
-        let trimmedText = line.text.trimEnd();
-        const isLastLine = i === lines.length - 1;
-        // smallCaps — uppercase text at 80% font size
-        const hasSmallCaps = textElement?.smallCaps === true;
-        const effectiveFontSize = hasSmallCaps ? measuredBlock.fontSize * 0.8 : measuredBlock.fontSize;
-        if (hasSmallCaps)
-            trimmedText = trimmedText.toUpperCase();
-        const hasTabular = textElement?.tabularNumbers === true;
-        // letterSpacing — draw char by char
-        const letterSpacing = (textElement?.letterSpacing ?? 0) > 0
-            ? textElement.letterSpacing
-            : 0;
-        let drawX;
-        if (alignRaw === 'justify' && letterSpacing === 0 && !hasTabular) {
-            drawJustifiedLine(pdfPage, trimmedText, isLastLine, geo.margins.left, pdfY, geo.contentWidth, effectiveFontSize, pdfFont, rgb(r, g, b));
-            drawX = geo.margins.left; // used for decoration below
-        }
-        else if (letterSpacing > 0) {
-            const alignWidth = pdfFont.widthOfTextAtSize(trimmedText, effectiveFontSize) + letterSpacing * (trimmedText.length - 1);
-            drawX = resolveX(align, geo.margins.left, geo.contentWidth, alignWidth);
-            let cx = drawX;
-            for (const ch of trimmedText) {
-                pdfPage.drawText(ch, { x: cx, y: pdfY, size: effectiveFontSize, font: pdfFont, color: rgb(r, g, b) });
-                cx += pdfFont.widthOfTextAtSize(ch, effectiveFontSize) + letterSpacing;
-            }
-        }
-        else if (hasTabular) {
-            const alignWidth = pdfFont.widthOfTextAtSize(trimmedText, effectiveFontSize);
-            drawX = resolveX(align, geo.margins.left, geo.contentWidth, alignWidth);
-            drawTabularText(pdfPage, trimmedText, drawX, pdfY, effectiveFontSize, pdfFont, rgb(r, g, b));
-        }
-        else {
-            const alignWidth = pdfFont.widthOfTextAtSize(trimmedText, effectiveFontSize);
-            drawX = resolveX(align, geo.margins.left, geo.contentWidth, alignWidth);
-            pdfPage.drawText(trimmedText, {
-                x: drawX,
-                y: pdfY,
-                size: effectiveFontSize,
-                font: pdfFont,
-                color: rgb(r, g, b),
-            });
-        }
-        if ((element.type === 'paragraph' || element.type === 'heading') && (element.underline || element.strikethrough)) {
-            const lineWidth = pdfFont.widthOfTextAtSize(trimmedText, effectiveFontSize) + (letterSpacing > 0 ? letterSpacing * (trimmedText.length - 1) : 0);
-            drawTextDecoration(pdfPage, drawX, lineWidth, pdfY, effectiveFontSize, pdfFont, [r, g, b], { underline: element.underline ?? false, strikethrough: element.strikethrough ?? false });
-        }
-        // Clickable link annotation on paragraph/heading
-        if ((element.type === 'paragraph' || element.type === 'heading') && element.url) {
-            const lineWidth = pdfFont.widthOfTextAtSize(trimmedText, effectiveFontSize) + (letterSpacing > 0 ? letterSpacing * (trimmedText.length - 1) : 0);
-            addLinkAnnotation(pdfDoc, pdfPage, drawX, pdfY, lineWidth, effectiveFontSize, element.url);
-        }
-    }
-    // Annotation on paragraph/heading — attach sticky note at top of block
-    if (textElement?.annotation) {
-        const ann = textElement.annotation;
-        const absY = yFromTop + geo.margins.top + geo.headerHeight;
-        const annotPdfY = geo.pageHeight - absY;
-        addStickyNoteAnnotation(pdfDoc, pdfPage, geo.margins.left, annotPdfY, ann.contents, ann.author, ann.color, ann.open);
-    }
-}
-// ─── List item rendering ──────────────────────────────────────────────────────
-export function renderListItem(pdfPage, pagedBlock, geo, fontMap) {
-    const { measuredBlock, startLine, endLine, yFromTop } = pagedBlock;
-    const listItemData = measuredBlock.listItemData;
-    const lines = measuredBlock.lines.slice(startLine, endLine);
-    if (lines.length === 0)
-        return;
-    const pdfFont = fontMap.get(measuredBlock.fontKey);
-    if (!pdfFont) {
-        throw new PretextPdfError('FONT_NOT_LOADED', `Font "${measuredBlock.fontKey}" not found in fontMap. This is a bug — font validation should have caught this.`);
-    }
-    const fontHeight = pdfFont.heightAtSize(measuredBlock.fontSize);
-    const [cr, cg, cb] = hexToRgb(listItemData.color);
-    // RTL support: mirror list layout if detected
-    const isRTL = measuredBlock.isRTL ?? false;
-    let textStartX;
-    let textAreaWidth;
-    if (isRTL) {
-        // RTL: marker on the right, text area on the left
-        textAreaWidth = geo.contentWidth - listItemData.indent - listItemData.markerWidth;
-        textStartX = geo.margins.left + listItemData.indent;
-    }
-    else {
-        // LTR: marker on the left, text area on the right
-        textStartX = geo.margins.left + listItemData.indent + listItemData.markerWidth;
-        textAreaWidth = geo.contentWidth - listItemData.indent - listItemData.markerWidth;
-    }
-    // Draw marker on the first line of this item (only if startLine === 0)
-    // If startLine > 0, the item continued from a previous page — no marker
-    if (startLine === 0) {
-        const markerText = listItemData.marker;
-        const markerMeasuredWidth = pdfFont.widthOfTextAtSize(markerText, measuredBlock.fontSize);
-        let markerX;
-        if (isRTL) {
-            // RTL: marker on the right, right-aligned within marker column
-            markerX = geo.margins.left + geo.contentWidth - listItemData.indent - markerMeasuredWidth;
-        }
-        else {
-            // LTR: marker on the left, right-aligned within marker column
-            markerX = geo.margins.left + listItemData.indent + listItemData.markerWidth - markerMeasuredWidth;
-        }
-        const firstLineAbsY = yFromTop + geo.margins.top + geo.headerHeight;
-        const markerPdfY = toPdfY(firstLineAbsY, fontHeight, geo.pageHeight);
-        pdfPage.drawText(markerText, {
-            x: markerX,
-            y: markerPdfY,
-            size: measuredBlock.fontSize,
-            font: pdfFont,
-            color: rgb(cr, cg, cb),
-        });
-    }
-    // Draw all text lines, indented to align with body text column
-    // RTL lists are right-aligned, LTR lists are left-aligned
-    const textAlign = isRTL ? 'right' : 'left';
-    for (let i = 0; i < lines.length; i++) {
-        const line = lines[i];
-        if (line.text === '')
-            continue;
-        const lineYFromTop = yFromTop + (i * measuredBlock.lineHeight);
-        const absoluteYFromTop = lineYFromTop + geo.margins.top + geo.headerHeight;
-        const pdfY = toPdfY(absoluteYFromTop, fontHeight, geo.pageHeight);
-        const trimmedText = line.text.trimEnd();
-        const lineWidth = pdfFont.widthOfTextAtSize(trimmedText, measuredBlock.fontSize);
-        const x = resolveX(textAlign, textStartX, textAreaWidth, lineWidth);
-        pdfPage.drawText(trimmedText, {
-            x,
-            y: pdfY,
-            size: measuredBlock.fontSize,
-            font: pdfFont,
-            color: rgb(cr, cg, cb),
-        });
-    }
-}
-// ─── Table rendering ──────────────────────────────────────────────────────────
-export function renderTable(pdfPage, pagedBlock, geo, fontMap) {
-    const { measuredBlock, yFromTop } = pagedBlock;
-    const tableData = measuredBlock.tableData;
-    const startRow = pagedBlock.startRow ?? 0;
-    const endRow = pagedBlock.endRow ?? tableData.rows.length - tableData.headerRowCount;
-    const { columnWidths, cellPaddingH, cellPaddingV, borderWidth, borderColor, headerBgColor } = tableData;
-    // Collect the rows to render for this chunk: headers (always) + body slice
-    const headerRows = tableData.rows.slice(0, tableData.headerRowCount);
-    const bodyRows = tableData.rows.slice(tableData.headerRowCount);
-    const chunkBodyRows = bodyRows.slice(startRow, endRow);
-    const chunkRows = [...headerRows, ...chunkBodyRows];
-    const chunkStartAbsY = yFromTop + geo.margins.top + geo.headerHeight;
-    const totalTableWidth = columnWidths.reduce((s, w) => s + w, 0);
-    const totalChunkHeight = chunkRows.reduce((s, r) => s + r.height, 0);
-    // ── Pass 1: Cell backgrounds ──────────────────────────────────────────────
-    let rowAbsY = chunkStartAbsY;
-    for (const row of chunkRows) {
-        let cellX = geo.margins.left;
-        for (const cell of row.cells) {
-            if (!cell.isSpanPlaceholder) {
-                const cellRenderHeight = cell.spanHeight ?? row.height;
-                const bgColorHex = cell.bgColor ?? (row.isHeader ? headerBgColor : undefined);
-                if (bgColorHex) {
-                    const [r, g, b] = hexToRgb(bgColorHex);
-                    pdfPage.drawRectangle({ x: cellX, y: toPdfY(rowAbsY, cellRenderHeight, geo.pageHeight), width: cell.mergedWidth, height: cellRenderHeight, color: rgb(r, g, b), borderWidth: 0 });
-                }
-            }
-            cellX += cell.mergedWidth;
-        }
-        rowAbsY += row.height;
-    }
-    // ── Pass 2: Grid (border-collapse model) ─────────────────────────────────
-    // Draw outer border + internal lines — single-thickness at every edge.
-    if (borderWidth > 0) {
-        const [br, bg, bb] = hexToRgb(borderColor);
-        const borderRgb = rgb(br, bg, bb);
-        const tableTopPdfY = toPdfY(chunkStartAbsY, totalChunkHeight, geo.pageHeight);
-        // Outer border rectangle (no fill)
-        pdfPage.drawRectangle({
-            x: geo.margins.left,
-            y: tableTopPdfY,
-            width: totalTableWidth,
-            height: totalChunkHeight,
-            borderColor: borderRgb,
-            borderWidth,
-        });
-        // Internal horizontal lines (row separators, between rows, not at edges)
-        // Suppressed after rows that have a spanning cell crossing into the next row
-        let lineAbsY = chunkStartAbsY;
-        for (let ri = 0; ri < chunkRows.length - 1; ri++) {
-            lineAbsY += chunkRows[ri].height;
-            if (!chunkRows[ri].hasRowspan) {
-                const linePdfY = geo.pageHeight - lineAbsY;
-                pdfPage.drawLine({
-                    start: { x: geo.margins.left, y: linePdfY },
-                    end: { x: geo.margins.left + totalTableWidth, y: linePdfY },
-                    thickness: borderWidth,
-                    color: borderRgb,
-                });
-            }
-        }
-        // Internal vertical lines (column separators, between columns, not at edges)
-        // Draw per-row segments: a boundary absent from a row's activeBoundaries means a merged cell
-        // spans it — a full-chunk line would cut through it. Per-row drawing preserves colspan correctness.
-        // Pre-compute X positions once; convert each row's activeBoundaries to a Set for O(1) lookup.
-        const colBoundaryXPositions = [];
-        let bx = geo.margins.left;
-        for (let ci = 0; ci < columnWidths.length - 1; ci++) {
-            bx += columnWidths[ci];
-            colBoundaryXPositions.push(bx);
-        }
-        const rowBoundarySets = chunkRows.map(row => new Set(row.activeBoundaries));
-        let vertRowAbsY = chunkStartAbsY;
-        for (let ri = 0; ri < chunkRows.length; ri++) {
-            const row = chunkRows[ri];
-            const rowBoundarySet = rowBoundarySets[ri];
-            const rowTopPdfY = geo.pageHeight - vertRowAbsY;
-            const rowBottomPdfY = geo.pageHeight - (vertRowAbsY + row.height);
-            for (let ci = 0; ci < colBoundaryXPositions.length; ci++) {
-                if (rowBoundarySet.has(ci)) {
-                    pdfPage.drawLine({
-                        start: { x: colBoundaryXPositions[ci], y: rowTopPdfY },
-                        end: { x: colBoundaryXPositions[ci], y: rowBottomPdfY },
-                        thickness: borderWidth,
-                        color: borderRgb,
-                    });
-                }
-            }
-            vertRowAbsY += row.height;
-        }
-    }
-    // ── Pass 3: Cell text ─────────────────────────────────────────────────────
-    rowAbsY = chunkStartAbsY;
-    for (const row of chunkRows) {
-        let cellX = geo.margins.left;
-        for (const cell of row.cells) {
-            if (!cell.isSpanPlaceholder && cell.lines.length > 0) {
-                const pdfFont = fontMap.get(cell.fontKey);
-                if (!pdfFont) {
-                    throw new PretextPdfError('FONT_NOT_LOADED', `Table cell font "${cell.fontKey}" not found in fontMap. This is a bug — font validation should have caught this.`);
-                }
-                const fontHeight = pdfFont.heightAtSize(cell.fontSize);
-                const [r, g, b] = hexToRgb(cell.color);
-                const textAreaX = cellX + cellPaddingH;
-                const textAreaWidth = cell.mergedWidth - 2 * cellPaddingH;
-                // For rowspan cells, vertically center within the full spanHeight
-                const cellRenderHeight = cell.spanHeight ?? row.height;
-                const totalTextHeight = cell.lines.length * cell.lineHeight;
-                const verticalOffset = Math.max(0, (cellRenderHeight - totalTextHeight - 2 * cellPaddingV) / 2);
-                for (let li = 0; li < cell.lines.length; li++) {
-                    const line = cell.lines[li];
-                    if (line.text === '')
-                        continue;
-                    const lineYFromPageTop = rowAbsY + cellPaddingV + verticalOffset + li * cell.lineHeight;
-                    const pdfY = toPdfY(lineYFromPageTop, fontHeight, geo.pageHeight);
-                    const trimmedText = line.text.trimEnd();
-                    const lineWidth = pdfFont.widthOfTextAtSize(trimmedText, cell.fontSize);
-                    const x = resolveX(cell.align, textAreaX, textAreaWidth, lineWidth);
-                    if (cell.tabularNumbers) {
-                        drawTabularText(pdfPage, trimmedText, x, pdfY, cell.fontSize, pdfFont, rgb(r, g, b));
-                    }
-                    else {
-                        pdfPage.drawText(trimmedText, { x, y: pdfY, size: cell.fontSize, font: pdfFont, color: rgb(r, g, b) });
-                    }
-                }
-            }
-            cellX += cell.mergedWidth;
-        }
-        rowAbsY += row.height;
-    }
-}
-// ─── Image rendering ──────────────────────────────────────────────────────────
-export function renderImage(pdfPage, pagedBlock, geo, imageMap) {
-    const { measuredBlock, yFromTop } = pagedBlock;
-    const imageData = measuredBlock.imageData;
-    const pdfImage = imageMap.get(imageData.imageKey);
-    if (!pdfImage) {
-        throw new PretextPdfError('IMAGE_LOAD_FAILED', `Image "${imageData.imageKey}" not found in imageMap. This is a bug — image loading should have caught this.`);
-    }
-    const absoluteYFromTop = yFromTop + geo.margins.top + geo.headerHeight;
-    // drawImage places the BOTTOM-LEFT corner at (x, y) — use toPdfY with renderHeight
-    const pdfY = toPdfY(absoluteYFromTop, imageData.renderHeight, geo.pageHeight);
-    const x = resolveX(imageData.align, geo.margins.left, geo.contentWidth, imageData.renderWidth);
-    pdfPage.drawImage(pdfImage, {
-        x,
-        y: pdfY,
-        width: imageData.renderWidth,
-        height: imageData.renderHeight,
-    });
-}
-// ─── Float image block rendering ─────────────────────────────────────────────
-export function renderFloatBlock(pdfPage, pagedBlock, geo, fontMap, imageMap, pdfDoc) {
-    const { measuredBlock, yFromTop } = pagedBlock;
-    const fd = measuredBlock.floatData;
-    const baseAbsY = yFromTop + geo.margins.top + geo.headerHeight;
-    // Draw image
-    const pdfImage = imageMap.get(fd.imageKey);
-    if (!pdfImage)
-        throw new PretextPdfError('IMAGE_LOAD_FAILED', `Float image key "${fd.imageKey}" not found in imageMap. This is a bug — image loading should have caught this.`);
-    const imgX = geo.margins.left + fd.imageColX;
-    const imgPdfY = toPdfY(baseAbsY, fd.imageRenderHeight, geo.pageHeight);
-    pdfPage.drawImage(pdfImage, {
-        x: imgX,
-        y: imgPdfY,
-        width: fd.imageRenderWidth,
-        height: fd.imageRenderHeight,
-    });
-    // Draw text lines (rich or plain)
-    const textBaseX = geo.margins.left + fd.textColX;
-    if (fd.richFloatLines && fd.richFloatLines.length > 0) {
-        let cumY = 0;
-        for (const richLine of fd.richFloatLines) {
-            const lineAbsY = baseAbsY + cumY;
-            for (const fragment of richLine.fragments) {
-                if (!fragment.text || fragment.text.trim() === '')
-                    continue;
-                const pdfFont = fontMap.get(fragment.fontKey);
-                if (!pdfFont)
-                    throw new PretextPdfError('FONT_NOT_LOADED', `Float rich text font "${fragment.fontKey}" not found in fontMap.`);
-                const fontHeight = pdfFont.heightAtSize(fragment.fontSize);
-                const [r, g, b] = hexToRgb(fragment.color);
-                const drawX = textBaseX + fragment.x;
-                const pdfY = toPdfY(lineAbsY, fontHeight, geo.pageHeight) + (fragment.yOffset ?? 0);
-                const drawText = fragment.text.trimEnd();
-                if (fragment.letterSpacing && fragment.letterSpacing > 0) {
-                    let cx = drawX;
-                    for (const ch of drawText) {
-                        pdfPage.drawText(ch, { x: cx, y: pdfY, size: fragment.fontSize, font: pdfFont, color: rgb(r, g, b) });
-                        cx += pdfFont.widthOfTextAtSize(ch, fragment.fontSize) + fragment.letterSpacing;
-                    }
-                }
-                else {
-                    pdfPage.drawText(drawText, { x: drawX, y: pdfY, size: fragment.fontSize, font: pdfFont, color: rgb(r, g, b) });
-                }
-                const fragWidth = pdfFont.widthOfTextAtSize(drawText, fragment.fontSize);
-                drawTextDecoration(pdfPage, drawX, fragWidth, pdfY, fragment.fontSize, pdfFont, [r, g, b], { underline: fragment.underline ?? false, strikethrough: fragment.strikethrough ?? false });
-                if (fragment.url)
-                    addLinkAnnotation(pdfDoc, pdfPage, drawX, pdfY, fragWidth, fragment.fontSize, fragment.url);
-            }
-            cumY += richLine.lineHeight;
-        }
-    }
-    else {
-        const pdfFont = fontMap.get(fd.textFontKey);
-        if (!pdfFont)
-            throw new PretextPdfError('FONT_NOT_LOADED', `Float text font key "${fd.textFontKey}" not found in fontMap. This is a bug — font loading should have caught this.`);
-        const fontHeight = pdfFont.heightAtSize(fd.textFontSize);
-        const [r, g, b] = hexToRgb(fd.textColor);
-        for (let i = 0; i < fd.textLines.length; i++) {
-            const line = fd.textLines[i];
-            if (line.text === '')
-                continue;
-            const lineAbsY = baseAbsY + (i * fd.textLineHeight);
-            const pdfY = toPdfY(lineAbsY, fontHeight, geo.pageHeight);
-            pdfPage.drawText(line.text.trimEnd(), { x: textBaseX, y: pdfY, size: fd.textFontSize, font: pdfFont, color: rgb(r, g, b) });
-        }
-    }
-}
-// ─── Float group block rendering ──────────────────────────────────────────────
-export function renderFloatGroup(pdfPage, pagedBlock, geo, fontMap, imageMap, pdfDoc) {
-    const { measuredBlock, yFromTop } = pagedBlock;
-    const fd = measuredBlock.floatGroupData;
-    const baseAbsY = yFromTop + geo.margins.top + geo.headerHeight;
-    // Draw image
-    const pdfImage = imageMap.get(fd.imageKey);
-    if (!pdfImage)
-        throw new PretextPdfError('IMAGE_LOAD_FAILED', `Float group image key "${fd.imageKey}" not found in imageMap. This is a bug — image loading should have caught this.`);
-    const imgX = geo.margins.left + fd.imageColX;
-    const imgPdfY = toPdfY(baseAbsY, fd.imageRenderHeight, geo.pageHeight);
-    pdfPage.drawImage(pdfImage, {
-        x: imgX,
-        y: imgPdfY,
-        width: fd.imageRenderWidth,
-        height: fd.imageRenderHeight,
-    });
-    // Draw text items
-    const textBaseX = geo.margins.left + fd.textColX;
-    for (const textItem of fd.textItems) {
-        const pdfFont = fontMap.get(textItem.fontKey);
-        if (!pdfFont)
-            throw new PretextPdfError('FONT_NOT_LOADED', `Float group font key "${textItem.fontKey}" not found in fontMap. This is a bug — font loading should have caught this.`);
-        const fontHeight = pdfFont.heightAtSize(textItem.fontSize);
-        // Draw plain lines (plain-text fallback for rich-paragraphs)
-        for (let i = 0; i < textItem.lines.length; i++) {
-            const line = textItem.lines[i];
-            if (line.text === '')
-                continue;
-            const lineAbsY = baseAbsY + textItem.yOffsetFromTop + (i * textItem.lineHeight);
-            const pdfY = toPdfY(lineAbsY, fontHeight, geo.pageHeight);
-            pdfPage.drawText(line.text.trimEnd(), {
-                x: textBaseX,
-                y: pdfY,
-                size: textItem.fontSize,
-                font: pdfFont,
-                color: rgb(0, 0, 0),
-            });
-        }
-    }
-}
-// ─── Horizontal rule rendering ────────────────────────────────────────────────
-export function renderHR(pdfPage, pagedBlock, geo) {
-    const { measuredBlock, yFromTop } = pagedBlock;
-    const element = measuredBlock.element;
-    const spaceAbove = element.spaceAbove ?? 12;
-    const thickness = element.thickness ?? 0.5;
-    const colorHex = element.color ?? '#cccccc';
-    // Line sits at the middle of the HR element (after spaceAbove, before spaceBelow)
-    const lineYFromTop = yFromTop + spaceAbove + geo.margins.top + geo.headerHeight;
-    const pdfY = toPdfY(lineYFromTop, thickness / 2, geo.pageHeight);
-    const [r, g, b] = hexToRgb(colorHex);
-    pdfPage.drawLine({
-        start: { x: geo.margins.left, y: pdfY },
-        end: { x: geo.margins.left + geo.contentWidth, y: pdfY },
-        thickness,
-        color: rgb(r, g, b),
-    });
-}
-// ─── Code block rendering ─────────────────────────────────────────────────────
-export function renderCodeBlock(pdfPage, pagedBlock, geo, fontMap) {
-    const { measuredBlock, startLine, endLine, yFromTop } = pagedBlock;
-    const element = measuredBlock.element;
-    const padding = measuredBlock.codePadding ?? 8;
-    const bgColorHex = element.bgColor ?? '#f6f8fa';
-    const textColorHex = element.color ?? '#24292f';
-    // Slice the lines being rendered on this page chunk
-    const lines = measuredBlock.lines.slice(startLine, endLine);
-    const lineHeight = measuredBlock.lineHeight;
-    const fontSize = measuredBlock.fontSize;
-    // Compute per-chunk padding (only apply padding at the edge of the code block)
-    const isFirstChunk = startLine === 0;
-    const isLastChunk = endLine === measuredBlock.lines.length;
-    const paddingTop = isFirstChunk ? padding : 0;
-    const paddingBottom = isLastChunk ? padding : 0;
-    const visibleHeight = lines.length * lineHeight + paddingTop + paddingBottom;
-    // ── Background box ──────────────────────────────────────────────────────────
-    const boxAbsY = yFromTop + geo.margins.top + geo.headerHeight;
-    const boxPdfY = toPdfY(boxAbsY, visibleHeight, geo.pageHeight);
-    const [bgR, bgG, bgB] = hexToRgb(bgColorHex);
-    pdfPage.drawRectangle({
-        x: geo.margins.left,
-        y: boxPdfY,
-        width: geo.contentWidth,
-        height: visibleHeight,
-        color: rgb(bgR, bgG, bgB),
-        borderWidth: 0,
-    });
-    // ── Text lines ──────────────────────────────────────────────────────────────
-    const pdfFont = fontMap.get(measuredBlock.fontKey);
-    if (!pdfFont || lines.length === 0)
-        return;
-    const fontHeight = pdfFont.heightAtSize(fontSize);
-    const [r, g, b] = hexToRgb(textColorHex);
-    const textX = geo.margins.left + padding;
-    // Syntax highlighting: tokenize if language is set and highlight.js is available
-    const highlightTokens = measuredBlock.codeHighlightTokens;
-    if (highlightTokens && highlightTokens.length > 0) {
-        // Render with per-token colors
-        for (let i = 0; i < lines.length; i++) {
-            const lineYFromPageTop = boxAbsY + paddingTop + i * lineHeight;
-            const pdfY = toPdfY(lineYFromPageTop, fontHeight, geo.pageHeight);
-            const lineTokens = highlightTokens[startLine + i];
-            if (!lineTokens)
-                continue;
-            let curX = textX;
-            for (const token of lineTokens) {
-                if (!token.text)
-                    continue;
-                const [tr, tg, tb] = hexToRgb(token.color);
-                pdfPage.drawText(token.text, {
-                    x: curX,
-                    y: pdfY,
-                    size: fontSize,
-                    font: pdfFont,
-                    color: rgb(tr, tg, tb),
-                });
-                curX += pdfFont.widthOfTextAtSize(token.text, fontSize);
-            }
-        }
-    }
-    else {
-        // Plain text rendering (no highlighting)
-        for (let i = 0; i < lines.length; i++) {
-            const line = lines[i];
-            const lineYFromPageTop = boxAbsY + paddingTop + i * lineHeight;
-            const pdfY = toPdfY(lineYFromPageTop, fontHeight, geo.pageHeight);
-            pdfPage.drawText(line.text.trimEnd(), {
-                x: textX,
-                y: pdfY,
-                size: fontSize,
-                font: pdfFont,
-                color: rgb(r, g, b),
-            });
-        }
-    }
-}
-// ─── Blockquote rendering ─────────────────────────────────────────────────────
-export function renderBlockquote(pdfPage, pagedBlock, geo, fontMap) {
-    const { measuredBlock, startLine, endLine, yFromTop } = pagedBlock;
-    const element = measuredBlock.element;
-    const paddingV = measuredBlock.blockquotePaddingV ?? 10;
-    const paddingH = measuredBlock.blockquotePaddingH ?? 16;
-    const borderWidth = measuredBlock.blockquoteBorderWidth ?? 3;
-    const bgColorHex = element.bgColor ?? '#f8f9fa';
-    const borderColorHex = element.borderColor ?? '#0070f3';
-    const textColorHex = element.color ?? '#333333';
-    const alignRaw = element.align ?? (measuredBlock.isRTL ? 'right' : 'left');
-    const align = alignRaw === 'justify' ? 'left' : alignRaw;
-    const lines = measuredBlock.lines.slice(startLine, endLine);
-    const lineHeight = measuredBlock.lineHeight;
-    const fontSize = measuredBlock.fontSize;
-    // Compute per-chunk padding (only at the edge of the block, like code)
-    const isFirstChunk = startLine === 0;
-    const isLastChunk = endLine === measuredBlock.lines.length;
-    const paddingTop = isFirstChunk ? paddingV : 0;
-    const paddingBottom = isLastChunk ? paddingV : 0;
-    const visibleHeight = lines.length * lineHeight + paddingTop + paddingBottom;
-    const boxAbsY = yFromTop + geo.margins.top + geo.headerHeight;
-    const boxPdfY = toPdfY(boxAbsY, visibleHeight, geo.pageHeight);
-    // ── Background box ──────────────────────────────────────────────────────────
-    const [bgR, bgG, bgB] = hexToRgb(bgColorHex);
-    pdfPage.drawRectangle({
-        x: geo.margins.left,
-        y: boxPdfY,
-        width: geo.contentWidth,
-        height: visibleHeight,
-        color: rgb(bgR, bgG, bgB),
-        borderWidth: 0,
-    });
-    // ── Left border stripe ──────────────────────────────────────────────────────
-    const [bdR, bdG, bdB] = hexToRgb(borderColorHex);
-    pdfPage.drawRectangle({
-        x: geo.margins.left,
-        y: boxPdfY,
-        width: borderWidth,
-        height: visibleHeight,
-        color: rgb(bdR, bdG, bdB),
-        borderWidth: 0,
-    });
-    // ── Text lines ──────────────────────────────────────────────────────────────
-    const pdfFont = fontMap.get(measuredBlock.fontKey);
-    if (!pdfFont || lines.length === 0)
-        return;
-    const fontHeight = pdfFont.heightAtSize(fontSize);
-    const [r, g, b] = hexToRgb(textColorHex);
-    const textStartX = geo.margins.left + borderWidth + paddingH;
-    const textAreaWidth = geo.contentWidth - borderWidth - 2 * paddingH;
-    for (let i = 0; i < lines.length; i++) {
-        const line = lines[i];
-        if (line.text === '')
-            continue;
-        const lineYFromPageTop = boxAbsY + paddingTop + i * lineHeight;
-        const pdfY = toPdfY(lineYFromPageTop, fontHeight, geo.pageHeight);
-        const trimmedText = line.text.trimEnd();
-        const isLastLine = i === lines.length - 1;
-        let drawX;
-        if (alignRaw === 'justify') {
-            drawJustifiedLine(pdfPage, trimmedText, isLastLine, textStartX, pdfY, textAreaWidth, fontSize, pdfFont, rgb(r, g, b));
-            drawX = textStartX;
-        }
-        else {
-            const lineWidth = pdfFont.widthOfTextAtSize(trimmedText, fontSize);
-            drawX = resolveX(align, textStartX, textAreaWidth, lineWidth);
-            pdfPage.drawText(trimmedText, {
-                x: drawX,
-                y: pdfY,
-                size: fontSize,
-                font: pdfFont,
-                color: rgb(r, g, b),
-            });
-        }
-        if (element.underline || element.strikethrough) {
-            const lineWidth = pdfFont.widthOfTextAtSize(trimmedText, fontSize);
-            drawTextDecoration(pdfPage, drawX, lineWidth, pdfY, fontSize, pdfFont, [r, g, b], { underline: element.underline ?? false, strikethrough: element.strikethrough ?? false });
-        }
-    }
-}
-// ─── Callout rendering ────────────────────────────────────────────
-export function renderCallout(pdfPage, pagedBlock, geo, fontMap) {
-    const { measuredBlock, startLine, endLine, yFromTop } = pagedBlock;
-    const el = measuredBlock.element;
-    const cd = measuredBlock.calloutData;
-    if (!cd)
-        return;
-    const { paddingH, paddingV, borderColor, backgroundColor, titleColor, color, titleText } = cd;
-    const isFirstChunk = startLine === 0;
-    const isLastChunk = endLine === measuredBlock.lines.length;
-    const lines = measuredBlock.lines.slice(startLine, endLine);
-    const fs = measuredBlock.fontSize;
-    const lh = measuredBlock.lineHeight;
-    const font = fontMap.get(measuredBlock.fontKey) ?? [...fontMap.values()][0];
-    if (!font)
-        return;
-    const titleH = isFirstChunk && titleText ? cd.titleHeight : 0;
-    const topPad = isFirstChunk ? paddingV : 0;
-    const bottomPad = isLastChunk ? paddingV : 0;
-    const chunkHeight = topPad + titleH + lines.length * lh + bottomPad;
-    const boxAbsY = yFromTop + geo.margins.top + geo.headerHeight;
-    const boxPdfY = toPdfY(boxAbsY, chunkHeight, geo.pageHeight);
-    // Background
-    const [bgR, bgG, bgB] = hexToRgb(backgroundColor);
-    pdfPage.drawRectangle({
-        x: geo.margins.left,
-        y: boxPdfY,
-        width: geo.contentWidth,
-        height: chunkHeight,
-        color: rgb(bgR, bgG, bgB),
-        borderWidth: 0,
-    });
-    // Left border stripe (3pt wide)
-    const [bdR, bdG, bdB] = hexToRgb(borderColor);
-    pdfPage.drawRectangle({
-        x: geo.margins.left,
-        y: boxPdfY,
-        width: 3,
-        height: chunkHeight,
-        color: rgb(bdR, bdG, bdB),
-        borderWidth: 0,
-    });
-    const fontHeight = font.heightAtSize(fs);
-    let currentAbsY = boxAbsY + topPad;
-    // Draw title if first chunk
-    if (isFirstChunk && titleText) {
-        // Try to get bold font variant by modifying the fontKey
-        const boldFontKey = measuredBlock.fontKey.replace(/-400-/, '-700-');
-        const titleFont = fontMap.get(boldFontKey) ?? font;
-        const [tR, tG, tB] = hexToRgb(titleColor);
-        const titlePdfY = toPdfY(currentAbsY + (fs * LINE_HEIGHT_COMPACT - fs) / 2, fontHeight, geo.pageHeight);
-        pdfPage.drawText(titleText, {
-            x: geo.margins.left + paddingH,
-            y: titlePdfY,
-            size: fs,
-            font: titleFont,
-            color: rgb(tR, tG, tB),
-        });
-        currentAbsY += titleH;
-    }
-    // Draw content lines
-    const [tR, tG, tB] = hexToRgb(color);
-    for (let i = 0; i < lines.length; i++) {
-        const line = lines[i];
-        if (line.text === '') {
-            currentAbsY += lh;
-            continue;
-        }
-        const linePdfY = toPdfY(currentAbsY + (lh - fs) / 2, fontHeight, geo.pageHeight);
-        pdfPage.drawText(line.text.trimEnd(), {
-            x: geo.margins.left + paddingH,
-            y: linePdfY,
-            size: fs,
-            font,
-            color: rgb(tR, tG, tB),
-        });
-        currentAbsY += lh;
-    }
-}
-// ─── Rich paragraph rendering ─────────────────────────────────────────────────
-export function renderRichParagraph(pdfPage, pagedBlock, geo, fontMap, pdfDoc, footnoteNumbering) {
-    const { measuredBlock, startLine, endLine, yFromTop } = pagedBlock;
-    const { element, richLines, lineHeight, fontSize } = measuredBlock;
-    const tabularNumbers = element.type === 'rich-paragraph' && element.tabularNumbers === true;
-    if (!richLines || richLines.length === 0)
-        return;
-    // Only render the lines on this page chunk
-    const visibleLines = richLines.slice(startLine, endLine);
-    // Draw background color if set
-    const columnData = measuredBlock.columnData;
-    if (element.type === 'rich-paragraph' && element.bgColor) {
-        // Use sum of per-line heights (may vary with per-span fontSize)
-        const chunkHeight = columnData
-            ? visibleLines.slice(0, columnData.linesPerColumn).reduce((sum, rl) => sum + rl.lineHeight, 0)
-            : visibleLines.reduce((sum, rl) => sum + rl.lineHeight, 0);
-        const boxAbsY = yFromTop + geo.margins.top + geo.headerHeight;
-        const boxPdfY = toPdfY(boxAbsY, chunkHeight, geo.pageHeight);
-        const [bgR, bgG, bgB] = hexToRgb(element.bgColor);
-        pdfPage.drawRectangle({
-            x: geo.margins.left,
-            y: boxPdfY,
-            width: geo.contentWidth,
-            height: chunkHeight,
-            color: rgb(bgR, bgG, bgB),
-            borderWidth: 0,
-        });
-    }
-    // Multi-column layout
-    if (columnData) {
-        const { columnCount, columnGap, columnWidth, linesPerColumn } = columnData;
-        // Track cumulative Y per column (per-line heights may vary)
-        const colCumY = new Array(columnCount).fill(0);
-        for (let i = 0; i < visibleLines.length; i++) {
-            const richLine = visibleLines[i];
-            const colIdx = Math.floor(i / linesPerColumn);
-            const colOffsetX = colIdx * (columnWidth + columnGap);
-            const lineYFromTop = yFromTop + colCumY[colIdx] + geo.margins.top + geo.headerHeight;
-            for (const fragment of richLine.fragments) {
-                if (!fragment.text || fragment.text.trim() === '')
-                    continue;
-                const pdfFont = fontMap.get(fragment.fontKey);
-                if (!pdfFont) {
-                    throw new PretextPdfError('FONT_NOT_LOADED', `Rich text fragment font "${fragment.fontKey}" not found in fontMap. This is a bug — font validation should have caught this.`);
-                }
-                const fontHeight = pdfFont.heightAtSize(fragment.fontSize);
-                const basePdfY = toPdfY(lineYFromTop, fontHeight, geo.pageHeight);
-                const [r, g, b] = hexToRgb(fragment.color);
-                const drawX = geo.margins.left + colOffsetX + fragment.x;
-                // Footnote ref spans render as superscript number, replacing the original text
-                if (fragment.footnoteRef) {
-                    const num = footnoteNumbering?.get(fragment.footnoteRef) ?? '?';
-                    const superText = String(num);
-                    const superSize = fragment.fontSize * 0.65;
-                    const superYOffset = fragment.fontSize * 0.4;
-                    const superPdfY = basePdfY + superYOffset;
-                    pdfPage.drawText(superText, {
-                        x: drawX,
-                        y: superPdfY,
-                        size: superSize,
-                        font: pdfFont,
-                        color: rgb(r, g, b),
-                    });
-                    continue;
-                }
-                const fragmentPdfY = basePdfY + (fragment.yOffset ?? 0);
-                const drawText = fragment.text.trimEnd();
-                let fragWidth;
-                if (fragment.letterSpacing && fragment.letterSpacing > 0) {
-                    let cx = drawX;
-                    for (const ch of drawText) {
-                        pdfPage.drawText(ch, { x: cx, y: fragmentPdfY, size: fragment.fontSize, font: pdfFont, color: rgb(r, g, b) });
-                        cx += pdfFont.widthOfTextAtSize(ch, fragment.fontSize) + fragment.letterSpacing;
-                    }
-                    fragWidth = pdfFont.widthOfTextAtSize(drawText, fragment.fontSize) + fragment.letterSpacing * (drawText.length - 1);
-                }
-                else if (tabularNumbers) {
-                    drawTabularText(pdfPage, drawText, drawX, fragmentPdfY, fragment.fontSize, pdfFont, rgb(r, g, b));
-                    fragWidth = pdfFont.widthOfTextAtSize(drawText, fragment.fontSize);
-                }
-                else {
-                    pdfPage.drawText(drawText, { x: drawX, y: fragmentPdfY, size: fragment.fontSize, font: pdfFont, color: rgb(r, g, b) });
-                    fragWidth = pdfFont.widthOfTextAtSize(drawText, fragment.fontSize);
-                }
-                drawTextDecoration(pdfPage, drawX, fragWidth, fragmentPdfY, fragment.fontSize, pdfFont, [r, g, b], { underline: fragment.underline ?? false, strikethrough: fragment.strikethrough ?? false });
-                if (fragment.url) {
-                    addLinkAnnotation(pdfDoc, pdfPage, drawX, fragmentPdfY, fragWidth, fragment.fontSize, fragment.url);
-                }
-            }
-            colCumY[colIdx] += richLine.lineHeight;
-        }
-        return; // skip standard single-column path
-    }
-    // Single-column layout (standard path)
-    // Track cumulative Y (per-line heights may vary due to per-span fontSize)
-    let cumY = 0;
-    for (let i = 0; i < visibleLines.length; i++) {
-        const richLine = visibleLines[i];
-        const lineYFromTop = yFromTop + cumY + geo.margins.top + geo.headerHeight;
-        for (const fragment of richLine.fragments) {
-            if (!fragment.text || fragment.text.trim() === '')
-                continue;
-            const pdfFont = fontMap.get(fragment.fontKey);
-            if (!pdfFont) {
-                throw new PretextPdfError('FONT_NOT_LOADED', `Rich text fragment font "${fragment.fontKey}" not found in fontMap. This is a bug — font validation should have caught this.`);
-            }
-            const fontHeight = pdfFont.heightAtSize(fragment.fontSize);
-            const basePdfY = toPdfY(lineYFromTop, fontHeight, geo.pageHeight);
-            const [r, g, b] = hexToRgb(fragment.color);
-            const drawX = geo.margins.left + fragment.x;
-            // Footnote ref spans render as superscript number, replacing the original text
-            if (fragment.footnoteRef) {
-                const num = footnoteNumbering?.get(fragment.footnoteRef) ?? '?';
-                const superText = String(num);
-                const superSize = fragment.fontSize * 0.65;
-                const superYOffset = fragment.fontSize * 0.4;
-                const superPdfY = basePdfY + superYOffset;
-                pdfPage.drawText(superText, {
-                    x: drawX,
-                    y: superPdfY,
-                    size: superSize,
-                    font: pdfFont,
-                    color: rgb(r, g, b),
-                });
-                continue;
-            }
-            const fragmentPdfY = basePdfY + (fragment.yOffset ?? 0);
-            const drawText = fragment.text.trimEnd();
-            let fragWidth;
-            if (fragment.letterSpacing && fragment.letterSpacing > 0) {
-                let cx = drawX;
-                for (const ch of drawText) {
-                    pdfPage.drawText(ch, { x: cx, y: fragmentPdfY, size: fragment.fontSize, font: pdfFont, color: rgb(r, g, b) });
-                    cx += pdfFont.widthOfTextAtSize(ch, fragment.fontSize) + fragment.letterSpacing;
-                }
-                fragWidth = pdfFont.widthOfTextAtSize(drawText, fragment.fontSize) + fragment.letterSpacing * (drawText.length - 1);
-            }
-            else if (tabularNumbers) {
-                drawTabularText(pdfPage, drawText, drawX, fragmentPdfY, fragment.fontSize, pdfFont, rgb(r, g, b));
-                fragWidth = pdfFont.widthOfTextAtSize(drawText, fragment.fontSize);
-            }
-            else {
-                pdfPage.drawText(drawText, { x: drawX, y: fragmentPdfY, size: fragment.fontSize, font: pdfFont, color: rgb(r, g, b) });
-                fragWidth = pdfFont.widthOfTextAtSize(drawText, fragment.fontSize);
-            }
-            drawTextDecoration(pdfPage, drawX, fragWidth, fragmentPdfY, fragment.fontSize, pdfFont, [r, g, b], { underline: fragment.underline ?? false, strikethrough: fragment.strikethrough ?? false });
-            if (fragment.url) {
-                addLinkAnnotation(pdfDoc, pdfPage, drawX, fragmentPdfY, fragWidth, fragment.fontSize, fragment.url);
-            }
-        }
-        cumY += richLine.lineHeight;
-    }
-}
-// ─── Footnote zone rendering ──────────────────────────────────────────────────
-export function renderFootnoteZone(pdfPage, footnoteItems, zoneHeight, fontMap, doc, geo) {
-    const { pageHeight, margins, footerHeight, contentWidth } = geo;
-    const SEPARATOR_PADDING = 6; // pt above and below the separator line
-    // Zone top in PDF coords (Y=0 at bottom of page)
-    const zoneTopPdfY = margins.bottom + footerHeight + zoneHeight;
-    const separatorY = zoneTopPdfY - SEPARATOR_PADDING;
-    // Draw separator line: 1/3 content width, max 120pt
-    const lineLength = Math.min(contentWidth * 0.33, 120);
-    pdfPage.drawLine({
-        start: { x: margins.left, y: separatorY },
-        end: { x: margins.left + lineLength, y: separatorY },
-        thickness: 0.5,
-        color: rgb(0.5, 0.5, 0.5),
-    });
-    const defaultFontSize = doc.defaultFontSize ?? 12;
-    let currentPdfY = separatorY - SEPARATOR_PADDING;
-    for (const { def, number } of footnoteItems) {
-        const fontSize = def.fontSize ?? Math.max(8, defaultFontSize - 2);
-        const lineHeight = fontSize * LINE_HEIGHT_BODY;
-        const fontFamily = def.fontFamily ?? doc.defaultFont ?? 'Inter';
-        const fontKey = buildFontKey(fontFamily, 400, 'normal');
-        const pdfFont = fontMap.get(fontKey);
-        if (!pdfFont)
-            continue;
-        currentPdfY -= lineHeight;
-        const prefix = `${number}. `;
-        const fullText = prefix + def.text;
-        pdfPage.drawText(fullText, {
-            x: margins.left,
-            y: currentPdfY,
-            size: fontSize,
-            font: pdfFont,
-            color: rgb(0.2, 0.2, 0.2),
-        });
-        currentPdfY -= (def.spaceAfter ?? 4);
-    }
-}
-// ─── Header / Footer rendering ────────────────────────────────────────────────
-export function renderHeaderFooter(pdfPage, spec, pageNumber, totalPages, geo, fontMap, position, extra) {
-    const text = resolveTokens(spec.text, pageNumber, totalPages, extra);
-    const fontSize = spec.fontSize ?? 10;
-    const align = spec.align ?? 'center';
-    const fontKey = `${spec.fontFamily ?? 'Inter'}-${spec.fontWeight ?? 400}-normal`;
-    const pdfFont = fontMap.get(fontKey);
-    if (!pdfFont) {
-        throw new PretextPdfError('FONT_NOT_LOADED', `${position} font "${fontKey}" not found in fontMap. This is a bug — font validation should have caught this.`);
-    }
-    const fontHeight = pdfFont.heightAtSize(fontSize);
-    let yFromTop;
-    if (position === 'header') {
-        yFromTop = (geo.margins.top - fontHeight) / 2;
-    }
-    else {
-        yFromTop = geo.pageHeight - geo.margins.bottom + (geo.margins.bottom - fontHeight) / 2;
-    }
-    const pdfY = toPdfY(yFromTop, fontHeight, geo.pageHeight);
-    const textWidth = pdfFont.widthOfTextAtSize(text, fontSize);
-    const x = resolveX(align, geo.margins.left, geo.contentWidth, textWidth);
-    const [textR, textG, textB] = hexToRgb(spec.color ?? '#666666');
-    pdfPage.drawText(text, {
-        x,
-        y: pdfY,
-        size: fontSize,
-        font: pdfFont,
-        color: rgb(textR, textG, textB),
-    });
-    // Separator line
-    if (position === 'header') {
-        const lineY = toPdfY(geo.margins.top - 4, 1, geo.pageHeight);
-        pdfPage.drawLine({
-            start: { x: geo.margins.left, y: lineY },
-            end: { x: geo.margins.left + geo.contentWidth, y: lineY },
-            thickness: 0.5,
-            color: rgb(0.8, 0.8, 0.8),
-        });
-    }
-    else {
-        const lineY = toPdfY(geo.pageHeight - geo.margins.bottom + 4, 1, geo.pageHeight);
-        pdfPage.drawLine({
-            start: { x: geo.margins.left, y: lineY },
-            end: { x: geo.margins.left + geo.contentWidth, y: lineY },
-            thickness: 0.5,
-            color: rgb(0.8, 0.8, 0.8),
-        });
-    }
-}
-// ─── Watermark rendering ──────────────────────────────────────────────────
-export function renderWatermark(pdfPage, doc, fontMap, imageMap, geo) {
-    const wm = doc.watermark;
-    if (!wm)
-        return;
-    const opacity = wm.opacity ?? 0.3;
-    const rotation = wm.rotation ?? -45;
-    const { pageWidth, pageHeight } = geo;
-    if (wm.text) {
-        const fontKey = `${wm.fontFamily ?? doc.defaultFont ?? 'Inter'}-${wm.fontWeight ?? 400}-normal`;
-        const pdfFont = fontMap.get(fontKey);
-        if (!pdfFont) {
-            throw new PretextPdfError('FONT_NOT_LOADED', `Watermark font "${fontKey}" not found in fontMap. This is a bug.`);
-        }
-        // Auto-compute font size to span ~60% of page diagonal
-        const fontSize = wm.fontSize ?? (() => {
-            const diagonal = Math.sqrt(pageWidth ** 2 + pageHeight ** 2);
-            const widthAt100 = pdfFont.widthOfTextAtSize(wm.text, 100);
-            return Math.min(120, (diagonal * 0.6 / widthAt100) * 100);
-        })();
-        const [r, g, b] = hexToRgb(wm.color ?? '#CCCCCC');
-        pdfPage.drawText(wm.text, {
-            x: pageWidth / 2,
-            y: pageHeight / 2,
-            size: fontSize,
-            font: pdfFont,
-            color: rgb(r, g, b),
-            rotate: degrees(rotation),
-            opacity,
-        });
-    }
-    if (wm.image) {
-        const pdfImage = imageMap.get('watermark');
-        if (!pdfImage)
-            return;
-        const margin = 40;
-        pdfPage.drawImage(pdfImage, {
-            x: margin,
-            y: margin,
-            width: pageWidth - margin * 2,
-            height: pageHeight - margin * 2,
-            opacity,
-        });
-    }
-}
-//# sourceMappingURL=render-blocks.js.map