pretext-pdf 0.4.6 → 0.5.1

package/dist/measure-blocks.js

@@ -0,0 +1,1019 @@
+/**
+ * measure-blocks.ts — Per-element-type measurement functions
+ * All the specific measurer functions for different content types.
+ */
+import { PretextPdfError } from './errors.js';
+import { measureRichText } from './rich-text.js';
+import { buildFontKey } from './measure.js';
+import { measureText, getPretext, detectAndReorderRTL } from './measure-text.js';
+/** Heading level size multipliers and defaults */
+const HEADING_DEFAULTS = {
+    1: { sizeMultiplier: 2.0, fontWeight: 700, spaceAfter: 16, spaceBefore: 28 },
+    2: { sizeMultiplier: 1.5, fontWeight: 700, spaceAfter: 12, spaceBefore: 24 },
+    3: { sizeMultiplier: 1.25, fontWeight: 700, spaceAfter: 8, spaceBefore: 20 },
+    4: { sizeMultiplier: 1.1, fontWeight: 700, spaceAfter: 6, spaceBefore: 16 },
+};
+/**
+ * Resolve preset callout style colors
+ */
+function resolveCalloutColors(style) {
+    switch (style) {
+        case 'info': return { bg: '#EFF6FF', border: '#3B82F6' };
+        case 'warning': return { bg: '#FFFBEB', border: '#F59E0B' };
+        case 'tip': return { bg: '#F0FDF4', border: '#22C55E' };
+        case 'note': return { bg: '#F9FAFB', border: '#9CA3AF' };
+        default: return { bg: '#F8F9FA', border: '#0070F3' };
+    }
+}
+export async function measureBlock(element, contentWidth, doc, hyphenatorOpts) {
+    const baseFontSize = doc.defaultFontSize ?? 12;
+    const baseFont = doc.defaultFont ?? 'Inter';
+    switch (element.type) {
+        case 'spacer': {
+            return {
+                element,
+                height: element.height,
+                lines: [],
+                fontSize: 0,
+                lineHeight: 0,
+                fontKey: '',
+                spaceAfter: 0,
+                spaceBefore: 0,
+            };
+        }
+        case 'page-break': {
+            return {
+                element,
+                height: 0,
+                lines: [],
+                fontSize: 0,
+                lineHeight: 0,
+                fontKey: '',
+                spaceAfter: 0,
+                spaceBefore: 0,
+            };
+        }
+        case 'comment': {
+            return {
+                element,
+                height: 20,
+                lines: [],
+                fontSize: 0,
+                lineHeight: 0,
+                fontKey: '',
+                spaceAfter: element.spaceAfter ?? 0,
+                spaceBefore: 0,
+            };
+        }
+        case 'form-field': {
+            const el = element;
+            const fs = el.fontSize ?? baseFontSize;
+            const labelHeight = el.label ? fs * 1.5 + 4 : 0;
+            let fieldHeight = el.height;
+            if (!fieldHeight) {
+                if (el.fieldType === 'text' && el.multiline)
+                    fieldHeight = 60;
+                else if (el.fieldType === 'radio')
+                    fieldHeight = 20 * Math.max(1, el.options?.length ?? 1);
+                else
+                    fieldHeight = 24;
+            }
+            return {
+                element,
+                height: labelHeight + fieldHeight + (el.spaceAfter ?? 8),
+                lines: [],
+                fontSize: fs,
+                lineHeight: fieldHeight,
+                fontKey: buildFontKey(baseFont, 400, 'normal'),
+                spaceAfter: el.spaceAfter ?? 8,
+                spaceBefore: el.spaceBefore ?? 0,
+                formFieldData: { labelHeight, fieldHeight },
+            };
+        }
+        case 'paragraph': {
+            // NEW (Phase 7F): Detect and reorder RTL text
+            const { visual: visualText, isRTL, logical: logicalText } = await detectAndReorderRTL(element.text, element.dir);
+            const fontSize = element.fontSize ?? doc.defaultParagraphStyle?.fontSize ?? baseFontSize;
+            // smallCaps renders at 80% of fontSize — measure at the same size to avoid
+            // overestimating block height and wasting vertical space
+            const effectiveFontSize = element.smallCaps === true ? fontSize * 0.8 : fontSize;
+            const lineHeight = element.lineHeight ?? doc.defaultParagraphStyle?.lineHeight ?? doc.defaultLineHeight ?? (effectiveFontSize * 1.5);
+            const fontFamily = element.fontFamily ?? doc.defaultParagraphStyle?.fontFamily ?? baseFont;
+            const fontWeight = element.fontWeight ?? doc.defaultParagraphStyle?.fontWeight ?? 400;
+            const fontKey = buildFontKey(fontFamily, fontWeight, 'normal');
+            const columns = element.columns ?? 1;
+            const columnGap = element.columnGap ?? 24;
+            let measureWidth = contentWidth;
+            let columnData;
+            // Multi-column layout
+            let computedColumnWidth = contentWidth;
+            if (columns > 1) {
+                if (columns > 20) {
+                    throw new PretextPdfError('VALIDATION_ERROR', `columns must be 1–20, got ${columns}`);
+                }
+                computedColumnWidth = (contentWidth - (columns - 1) * columnGap) / columns;
+                if (computedColumnWidth < 50) {
+                    throw new PretextPdfError('COLUMN_WIDTH_TOO_NARROW', `Column width would be ${computedColumnWidth.toFixed(1)}pt, which is below the minimum 50pt. Reduce columns, increase columnGap, or increase page width.`);
+                }
+                measureWidth = computedColumnWidth;
+            }
+            const opts = hyphenatorOpts && element.hyphenate !== false ? hyphenatorOpts : undefined;
+            // Compensate for letterSpacing: render adds `spacing` pts after each character,
+            // but pretext doesn't know about it. Reduce measureWidth so line-breaks happen
+            // before the rendered text would overflow. Formula: scale by avgCharWidth /
+            // (avgCharWidth + spacing), where avgCharWidth ≈ 0.5 * effectiveFontSize.
+            const letterSpacingValue = element.letterSpacing ?? doc.defaultParagraphStyle?.letterSpacing ?? 0;
+            if (letterSpacingValue > 0) {
+                const avgCharWidth = effectiveFontSize * 0.5;
+                measureWidth = Math.max(10, measureWidth * avgCharWidth / (avgCharWidth + letterSpacingValue));
+            }
+            // CRITICAL (Phase 7F): Measure the VISUAL-ORDER text (what will actually be rendered).
+            // smallCaps uppercases at render time — measure the same uppercase text so
+            // line-break widths match what is actually drawn.
+            const measureText_ = element.smallCaps === true ? visualText.toUpperCase() : visualText;
+            const lines = await measureText(measureText_, effectiveFontSize, fontFamily, fontWeight, measureWidth, lineHeight, opts);
+            if (columns > 1) {
+                const linesPerColumn = Math.max(1, Math.ceil(lines.length / columns));
+                columnData = { columnCount: columns, columnGap, columnWidth: computedColumnWidth, linesPerColumn };
+            }
+            // Construct result with or without columnData depending on columns value
+            const paraSpaceAfter = element.spaceAfter ?? doc.defaultParagraphStyle?.spaceAfter ?? 0;
+            const paraSpaceBefore = element.spaceBefore ?? doc.defaultParagraphStyle?.spaceBefore ?? 0;
+            if (columnData) {
+                return {
+                    element,
+                    height: columnData.linesPerColumn * lineHeight,
+                    lines,
+                    fontSize,
+                    lineHeight,
+                    fontKey,
+                    spaceAfter: paraSpaceAfter,
+                    spaceBefore: paraSpaceBefore,
+                    columnData,
+                    isRTL, // NEW (Phase 7F)
+                    ...(isRTL && { logicalText }), // NEW: Only store logical text when RTL
+                };
+            }
+            else {
+                return {
+                    element,
+                    height: lines.length * lineHeight,
+                    lines,
+                    fontSize,
+                    lineHeight,
+                    fontKey,
+                    spaceAfter: paraSpaceAfter,
+                    spaceBefore: paraSpaceBefore,
+                    isRTL, // NEW (Phase 7F)
+                    ...(isRTL && { logicalText }), // NEW: Only store logical text when RTL
+                };
+            }
+        }
+        case 'heading': {
+            // NEW (Phase 7F): Detect and reorder RTL text
+            const { visual: visualText, isRTL, logical: logicalText } = await detectAndReorderRTL(element.text, element.dir);
+            const defaults = HEADING_DEFAULTS[element.level];
+            const baseHeadingFontSize = doc.defaultParagraphStyle?.fontSize ?? baseFontSize;
+            const fontSize = element.fontSize ?? (baseHeadingFontSize * defaults.sizeMultiplier);
+            // smallCaps renders at 80% — measure at effective size
+            const effectiveFontSize = element.smallCaps === true ? fontSize * 0.8 : fontSize;
+            const lineHeight = element.lineHeight ?? doc.defaultParagraphStyle?.lineHeight ?? doc.defaultLineHeight ?? (effectiveFontSize * 1.4);
+            const fontFamily = element.fontFamily ?? doc.defaultParagraphStyle?.fontFamily ?? baseFont;
+            const fontWeight = element.fontWeight ?? doc.defaultParagraphStyle?.fontWeight ?? defaults.fontWeight;
+            const fontKey = buildFontKey(fontFamily, fontWeight, 'normal');
+            const opts = hyphenatorOpts && element.hyphenate !== false ? hyphenatorOpts : undefined;
+            // Compensate for letterSpacing (same logic as paragraph above)
+            const headingLetterSpacing = element.letterSpacing ?? doc.defaultParagraphStyle?.letterSpacing ?? 0;
+            const headingMeasureWidth = headingLetterSpacing > 0
+                ? Math.max(10, contentWidth * (effectiveFontSize * 0.5) / (effectiveFontSize * 0.5 + headingLetterSpacing))
+                : contentWidth;
+            // CRITICAL (Phase 7F): Measure the VISUAL-ORDER text (what will actually be rendered).
+            // smallCaps uppercases at render time — measure uppercase for consistent line widths.
+            const headingMeasureText = element.smallCaps === true ? visualText.toUpperCase() : visualText;
+            const lines = await measureText(headingMeasureText, effectiveFontSize, fontFamily, fontWeight, headingMeasureWidth, lineHeight, opts);
+            return {
+                element,
+                height: lines.length * lineHeight,
+                lines,
+                fontSize,
+                lineHeight,
+                fontKey,
+                spaceAfter: element.spaceAfter ?? doc.defaultParagraphStyle?.spaceAfter ?? defaults.spaceAfter,
+                spaceBefore: element.spaceBefore ?? doc.defaultParagraphStyle?.spaceBefore ?? defaults.spaceBefore,
+                isRTL, // NEW (Phase 7F)
+                ...(isRTL && { logicalText }), // NEW: Only store logical text when RTL
+            };
+        }
+        case 'hr': {
+            const spaceAbove = element.spaceAbove ?? element.spaceBefore ?? 12;
+            const thickness = element.thickness ?? 0.5;
+            const spaceBelow = element.spaceBelow ?? element.spaceAfter ?? 12;
+            return {
+                element,
+                height: spaceAbove + thickness + spaceBelow,
+                lines: [],
+                fontSize: 0,
+                lineHeight: 0,
+                fontKey: '',
+                spaceAfter: 0,
+                spaceBefore: 0,
+            };
+        }
+        case 'image': {
+            // Image elements must be measured via measureAllBlocks() — not measureBlock() directly.
+            // measureAllBlocks() resolves the content-index-based imageMap key (img-N) before calling
+            // measureImageWithKey(). measureBlock() doesn't have access to the content index.
+            throw new PretextPdfError('VALIDATION_ERROR', 'Image elements cannot be measured via measureBlock() directly — use measureAllBlocks() which resolves the imageMap key correctly.');
+        }
+        case 'svg': {
+            // SVG elements must be measured via measureAllBlocks() — not measureBlock() directly.
+            // measureAllBlocks() resolves the content-index-based imageMap key (svg-N) before calling
+            // measureImageWithKey(). measureBlock() doesn't have access to the content index.
+            throw new PretextPdfError('VALIDATION_ERROR', 'SVG elements cannot be measured via measureBlock() directly — use measureAllBlocks() which resolves the imageMap key correctly.');
+        }
+        case 'list': {
+            return measureList(element, contentWidth, doc, baseFontSize, hyphenatorOpts);
+        }
+        case 'table': {
+            return measureTable(element, contentWidth, doc, baseFontSize, hyphenatorOpts);
+        }
+        case 'rich-paragraph': {
+            // NEW (Phase 7F): Detect paragraph-level RTL direction (for alignment default)
+            // Individual spans can override via span.dir, but paragraph.dir sets the default
+            const fullText = element.spans.map(s => s.text).join('');
+            const { isRTL } = await detectAndReorderRTL(fullText, element.dir);
+            const fontSize = element.fontSize ?? baseFontSize;
+            const lineHeight = element.lineHeight ?? doc.defaultLineHeight ?? (fontSize * 1.5);
+            // 'justify' uses left alignment for measurement (justify is rendering-only)
+            const alignRaw = element.align ?? 'left';
+            const align = alignRaw === 'justify' ? 'left' : alignRaw;
+            const columns = element.columns ?? 1;
+            const columnGap = element.columnGap ?? 24;
+            let measureWidth = contentWidth;
+            let columnData;
+            // Multi-column layout
+            if (columns > 1) {
+                const columnWidth = (contentWidth - (columns - 1) * columnGap) / columns;
+                if (columnWidth < 50) {
+                    throw new PretextPdfError('COLUMN_WIDTH_TOO_NARROW', `Column width would be ${columnWidth.toFixed(1)}pt, which is below the minimum 50pt. Reduce columns, increase columnGap, or increase page width.`);
+                }
+                measureWidth = columnWidth;
+            }
+            const richLines = await measureRichText(element.spans, fontSize, lineHeight, measureWidth, align, doc);
+            if (columns > 1) {
+                const columnWidth = (contentWidth - (columns - 1) * columnGap) / columns;
+                const linesPerColumn = Math.ceil(richLines.length / columns);
+                columnData = { columnCount: columns, columnGap, columnWidth, linesPerColumn };
+            }
+            // For paginator/renderer compatibility, also produce a flat lines[] array
+            // (used for orphan/widow logic and line-count-based pagination).
+            // Each RichLine becomes one PretextLine with its totalWidth.
+            const lines = richLines.map(rl => ({
+                text: rl.fragments.map(f => f.text).join(''),
+                width: rl.totalWidth,
+            }));
+            // Construct result with or without columnData depending on columns value
+            // Phase 5B.4: Block height = sum of per-line heights (variable when spans have different fontSize)
+            const blockHeight = richLines.reduce((sum, rl) => sum + rl.lineHeight, 0);
+            if (columnData) {
+                return {
+                    element,
+                    height: blockHeight, // richLines already have per-line heights
+                    lines,
+                    fontSize,
+                    lineHeight,
+                    fontKey: buildFontKey(doc.defaultFont ?? 'Inter', 400, 'normal'),
+                    spaceAfter: element.spaceAfter ?? 0,
+                    spaceBefore: element.spaceBefore ?? 0,
+                    richLines,
+                    columnData,
+                    isRTL, // NEW (Phase 7F)
+                };
+            }
+            else {
+                return {
+                    element,
+                    height: blockHeight, // richLines already have per-line heights
+                    lines,
+                    fontSize,
+                    lineHeight,
+                    fontKey: buildFontKey(doc.defaultFont ?? 'Inter', 400, 'normal'),
+                    spaceAfter: element.spaceAfter ?? 0,
+                    spaceBefore: element.spaceBefore ?? 0,
+                    richLines,
+                    isRTL, // NEW (Phase 7F)
+                };
+            }
+        }
+        case 'code': {
+            const fontSize = element.fontSize ?? Math.max(baseFontSize - 2, 8);
+            const lineHeight = element.lineHeight ?? (fontSize * 1.4);
+            const padding = element.padding ?? 8;
+            // Text area is narrower by padding on both sides
+            const textWidth = contentWidth - 2 * padding;
+            // Code blocks: never hyphenate — breaks would corrupt source code meaning
+            // Code blocks: always measure in logical (LTR) order — reordering breaks syntax
+            const lines = await measureText(element.text, fontSize, element.fontFamily, 400, Math.max(textWidth, 1), lineHeight);
+            // height = lines * lineHeight + padding top + padding bottom
+            const height = (lines.length || 1) * lineHeight + 2 * padding;
+            return {
+                element,
+                height,
+                lines,
+                fontSize,
+                lineHeight,
+                fontKey: buildFontKey(element.fontFamily, 400, 'normal'),
+                spaceAfter: element.spaceAfter ?? 12,
+                spaceBefore: element.spaceBefore ?? 12,
+                codePadding: padding,
+                isRTL: false, // NEW (Phase 7F): Code blocks always LTR
+            };
+        }
+        case 'blockquote': {
+            // NEW (Phase 7F): Detect and reorder RTL text
+            const { visual: visualText, isRTL, logical: logicalText } = await detectAndReorderRTL(element.text, element.dir);
+            const fontSize = element.fontSize ?? baseFontSize;
+            const lineHeight = element.lineHeight ?? doc.defaultLineHeight ?? (fontSize * 1.5);
+            const fontFamily = element.fontFamily ?? baseFont;
+            const fontWeight = element.fontWeight ?? 400;
+            const fontStyle = element.fontStyle ?? 'normal';
+            const fontKey = buildFontKey(fontFamily, fontWeight, fontStyle);
+            const borderWidth = element.borderWidth ?? 3;
+            const paddingH = element.paddingH ?? element.padding ?? 16;
+            const paddingV = element.paddingV ?? element.padding ?? 10;
+            // Text area excludes left border + horizontal padding on both sides
+            const textWidth = contentWidth - borderWidth - 2 * paddingH;
+            // CRITICAL (Phase 7F): Measure the VISUAL-ORDER text (what will actually be rendered)
+            const lines = await measureText(visualText, fontSize, fontFamily, fontWeight, Math.max(textWidth, 1), lineHeight, hyphenatorOpts);
+            // height = lines * lineHeight + padding top + padding bottom
+            const height = (lines.length || 1) * lineHeight + 2 * paddingV;
+            return {
+                element,
+                height,
+                lines,
+                fontSize,
+                lineHeight,
+                fontKey,
+                spaceAfter: element.spaceAfter ?? 12,
+                spaceBefore: element.spaceBefore ?? 0,
+                blockquotePaddingV: paddingV,
+                blockquotePaddingH: paddingH,
+                blockquoteBorderWidth: borderWidth,
+                isRTL, // NEW (Phase 7F)
+                ...(isRTL && { logicalText }), // NEW: Only store logical text when RTL
+            };
+        }
+        case 'callout': {
+            const el = element;
+            const fs = el.fontSize ?? baseFontSize;
+            const lh = el.lineHeight ?? (fs * 1.5);
+            const ph = el.paddingH ?? el.padding ?? 16;
+            const pv = el.paddingV ?? el.padding ?? 10;
+            const family = el.fontFamily ?? baseFont;
+            const colors = resolveCalloutColors(el.style);
+            const borderColor = el.borderColor ?? colors.border;
+            const backgroundColor = el.backgroundColor ?? colors.bg;
+            const color = el.color ?? '#1F2937';
+            const titleColor = el.titleColor ?? borderColor;
+            // Measure title height (one line assumed, bold)
+            let titleHeight = 0;
+            if (el.title) {
+                titleHeight = fs * 1.4 + 4; // 1.4 line height + 4pt separator
+            }
+            // Measure content text
+            const innerWidth = contentWidth - ph * 2;
+            const lines = await measureText(el.content, fs, family, el.fontWeight ?? 400, Math.max(innerWidth, 1), lh, hyphenatorOpts);
+            const contentTextHeight = lines.length * lh;
+            const totalHeight = pv + titleHeight + contentTextHeight + pv + (el.spaceAfter ?? 12);
+            return {
+                element,
+                height: totalHeight,
+                lines,
+                fontSize: fs,
+                lineHeight: lh,
+                fontKey: buildFontKey(family, el.fontWeight ?? 400, 'normal'),
+                spaceAfter: el.spaceAfter ?? 12,
+                spaceBefore: el.spaceBefore ?? 0,
+                blockquotePaddingV: pv,
+                blockquotePaddingH: ph,
+                blockquoteBorderWidth: 3,
+                calloutData: { titleHeight, paddingH: ph, paddingV: pv, borderColor, backgroundColor, titleColor, color, ...(el.title !== undefined ? { titleText: el.title } : {}) },
+            };
+        }
+        case 'toc': {
+            // Placeholder: zero height. Will be replaced by actual TOC entries in two-pass mode.
+            return {
+                element,
+                height: 0,
+                lines: [],
+                fontSize: 0,
+                lineHeight: 0,
+                fontKey: '',
+                spaceAfter: element.spaceAfter ?? 0,
+                spaceBefore: element.spaceBefore ?? 0,
+            };
+        }
+        case 'toc-entry': {
+            // Internal type - should never be measured directly by user input
+            throw new PretextPdfError('VALIDATION_ERROR', 'toc-entry is an internal type and cannot be used in document content');
+        }
+        case 'footnote-def': {
+            const fn = element;
+            const baseFontSize = doc.defaultFontSize ?? 12;
+            const fontSize = fn.fontSize ?? Math.max(8, baseFontSize - 2);
+            const lineHeight = fontSize * 1.5;
+            const fontFamily = fn.fontFamily ?? doc.defaultFont ?? 'Inter';
+            const fontKey = buildFontKey(fontFamily, 400, 'normal');
+            // Measure the def text with a 20pt left indent (for the number prefix space)
+            const textLines = await measureText(fn.text, fontSize, fontFamily, 400, contentWidth - 20, // leave space for "N. " prefix
+            lineHeight, undefined);
+            const height = textLines.length * lineHeight;
+            return {
+                element,
+                height,
+                lines: textLines,
+                fontSize,
+                lineHeight,
+                fontKey,
+                spaceAfter: fn.spaceAfter ?? 4,
+                spaceBefore: 0,
+            };
+        }
+        case 'float-group': {
+            // Float groups are handled at the measure.ts orchestrator level, not here
+            throw new PretextPdfError('VALIDATION_ERROR', 'float-group cannot be measured by measureBlock — it should be handled by measureAllBlocks in measure.ts');
+        }
+        default: {
+            const unknownType = element.type;
+            throw new PretextPdfError('VALIDATION_ERROR', `Unknown element type: "${String(unknownType)}"`);
+        }
+    }
+}
+// ─── HR is trivial (handled inline above) ────────────────────────────────────
+// ─── Image measurement ────────────────────────────────────────────────────────
+/** Measure an image element with its known imageMap key */
+export async function measureImageWithKey(element, imageKey, imageMap, contentWidth, pageContentHeight) {
+    const pdfImage = imageMap.get(imageKey);
+    if (!pdfImage) {
+        throw new PretextPdfError('IMAGE_LOAD_FAILED', `Image "${imageKey}": not found in imageMap. This is an internal error — please report it.`);
+    }
+    // Natural dimensions (in original pixels — aspect ratio is what matters, not the pixel count)
+    const naturalWidth = pdfImage.width;
+    const naturalHeight = pdfImage.height;
+    // Resolve render dimensions (in pt)
+    let renderWidth;
+    let renderHeight;
+    if (element.width !== undefined && element.height !== undefined) {
+        // Both provided: use as-is
+        renderWidth = element.width;
+        renderHeight = element.height;
+    }
+    else if (element.width !== undefined) {
+        // Width only: scale height
+        renderWidth = element.width;
+        renderHeight = renderWidth * (naturalHeight / naturalWidth);
+    }
+    else if (element.height !== undefined) {
+        // Height only: scale width
+        renderHeight = element.height;
+        renderWidth = renderHeight * (naturalWidth / naturalHeight);
+    }
+    else {
+        // Neither: fit to content width
+        renderWidth = contentWidth;
+        renderHeight = renderWidth * (naturalHeight / naturalWidth);
+    }
+    // Clamp to content width
+    if (renderWidth > contentWidth) {
+        const scale = contentWidth / renderWidth;
+        renderWidth = contentWidth;
+        renderHeight = renderHeight * scale;
+    }
+    // Validate height doesn't exceed page
+    if (renderHeight > pageContentHeight) {
+        throw new PretextPdfError('IMAGE_TOO_TALL', `Image "${imageKey}" would render at ${renderHeight.toFixed(1)}pt tall, which exceeds the page content area (${pageContentHeight.toFixed(1)}pt). ` +
+            `Reduce 'height' or increase page size/reduce margins.`);
+    }
+    const imageData = {
+        imageKey,
+        renderWidth,
+        renderHeight,
+        align: element.align ?? 'left',
+    };
+    return {
+        element,
+        height: renderHeight,
+        lines: [],
+        fontSize: 0,
+        lineHeight: 0,
+        fontKey: '',
+        spaceAfter: element.spaceAfter ?? 0,
+        spaceBefore: element.spaceBefore ?? 0,
+        imageData,
+    };
+}
+// ─── Float image block measurement ───────────────────────────────────────────
+export async function measureFloatImageBlock(element, imageKey, imageMap, contentWidth, pageContentHeight, doc) {
+    const floatWidth = element.floatWidth ?? (contentWidth * 0.35);
+    const floatGap = element.floatGap ?? 12;
+    const textColWidth = contentWidth - floatWidth - floatGap;
+    if (textColWidth < 50) {
+        throw new PretextPdfError('COLUMN_WIDTH_TOO_NARROW', `Float image: text column would be ${textColWidth.toFixed(1)}pt (minimum 50pt). ` +
+            `Reduce floatWidth or increase page width.`);
+    }
+    // Measure the image at floatWidth using a synthetic element
+    const syntheticEl = {
+        type: 'image',
+        src: element.src,
+        ...(element.format !== undefined ? { format: element.format } : {}),
+        width: floatWidth,
+        align: 'left',
+        spaceAfter: 0,
+        spaceBefore: 0,
+    };
+    const imageBlock = await measureImageWithKey(syntheticEl, imageKey, imageMap, floatWidth, pageContentHeight);
+    const imageRenderWidth = imageBlock.imageData.renderWidth;
+    const imageRenderHeight = imageBlock.imageData.renderHeight;
+    // Measure the float text
+    const fontSize = element.floatFontSize ?? doc.defaultFontSize ?? 12;
+    const lineHeight = fontSize * 1.5;
+    const fontFamily = element.floatFontFamily ?? doc.defaultFont ?? 'Inter';
+    const fontKey = buildFontKey(fontFamily, 400, 'normal');
+    const textLines = await measureText(element.floatText, fontSize, fontFamily, 400, textColWidth, lineHeight, undefined);
+    // Column X positions
+    const imageColX = element.float === 'left' ? 0 : textColWidth + floatGap;
+    const textColX = element.float === 'left' ? floatWidth + floatGap : 0;
+    const textHeight = textLines.length * lineHeight;
+    const compositeHeight = Math.max(imageRenderHeight, textHeight);
+    return {
+        element,
+        height: compositeHeight,
+        lines: [],
+        fontSize: 0,
+        lineHeight: 0,
+        fontKey: '',
+        spaceAfter: element.spaceAfter ?? 0,
+        spaceBefore: element.spaceBefore ?? 0,
+        floatData: {
+            imageKey,
+            imageRenderWidth,
+            imageRenderHeight,
+            imageColX,
+            textColX,
+            textColWidth,
+            textLines,
+            textFontKey: fontKey,
+            textFontSize: fontSize,
+            textLineHeight: lineHeight,
+            textColor: element.floatColor ?? '#000000',
+        },
+    };
+}
+// ─── Float group measurement (multi-paragraph float) ────────────────────────────
+export async function measureFloatGroup(element, imageKey, imageMap, contentWidth, pageContentHeight, doc, hyphenatorOpts) {
+    const floatWidth = element.floatWidth ?? (contentWidth * 0.35);
+    const floatGap = element.floatGap ?? 12;
+    const textColWidth = contentWidth - floatWidth - floatGap;
+    if (textColWidth < 50) {
+        throw new PretextPdfError('COLUMN_WIDTH_TOO_NARROW', `Float group: text column would be ${textColWidth.toFixed(1)}pt (minimum 50pt). ` +
+            `Reduce floatWidth or increase page width.`);
+    }
+    // Measure the image at floatWidth
+    const syntheticImageEl = {
+        type: 'image',
+        src: '',
+        ...(element.image.height !== undefined ? { height: element.image.height } : {}),
+        align: 'left',
+        spaceAfter: 0,
+        spaceBefore: 0,
+    };
+    const imageBlock = await measureImageWithKey(syntheticImageEl, imageKey, imageMap, floatWidth, pageContentHeight);
+    const imageRenderWidth = imageBlock.imageData.renderWidth;
+    const imageRenderHeight = imageBlock.imageData.renderHeight;
+    // Measure each content element in the text column
+    const baseFontSize = doc.defaultFontSize ?? 12;
+    const textItems = [];
+    let totalTextHeight = 0;
+    for (const contentEl of element.content) {
+        const measuredEl = await measureBlock(contentEl, textColWidth, doc, hyphenatorOpts);
+        // Handle arrays (lists return MeasuredBlock[])
+        const blocks = Array.isArray(measuredEl) ? measuredEl : [measuredEl];
+        for (const block of blocks) {
+            const fontSize = block.fontSize || baseFontSize;
+            const lineHeight = block.lineHeight || (fontSize * 1.5);
+            // Extract text from lines or rich-lines
+            let lines = [];
+            if (block.richLines && block.richLines.length > 0) {
+                // Rich paragraph: extract plain text from rich lines (plain-text fallback)
+                lines = block.richLines.map(rl => ({
+                    text: rl.fragments.map(f => f.text).join(''),
+                    width: rl.totalWidth,
+                }));
+            }
+            else {
+                lines = block.lines;
+            }
+            const yOffsetFromTop = totalTextHeight;
+            const item = {
+                lines,
+                fontSize: block.fontSize,
+                lineHeight: block.lineHeight,
+                fontKey: block.fontKey,
+                fontWeight: 400,
+                spaceAfter: block.spaceAfter,
+                yOffsetFromTop,
+            };
+            if (block.richLines) {
+                item.richLines = block.richLines;
+            }
+            textItems.push(item);
+            totalTextHeight += block.height + block.spaceAfter;
+        }
+    }
+    // Remove trailing spaceAfter (it's not needed at the end)
+    if (textItems.length > 0) {
+        totalTextHeight -= textItems[textItems.length - 1].spaceAfter;
+    }
+    // Column X positions
+    const imageColX = element.float === 'left' ? 0 : textColWidth + floatGap;
+    const textColX = element.float === 'left' ? floatWidth + floatGap : 0;
+    const compositeHeight = Math.max(imageRenderHeight, totalTextHeight);
+    return {
+        element,
+        height: compositeHeight,
+        lines: [],
+        fontSize: 0,
+        lineHeight: 0,
+        fontKey: '',
+        spaceAfter: element.spaceAfter ?? 12,
+        spaceBefore: element.spaceBefore ?? 0,
+        floatGroupData: {
+            imageKey,
+            imageRenderWidth,
+            imageRenderHeight,
+            imageColX,
+            textColX,
+            textColWidth,
+            textItems,
+            totalTextHeight,
+        },
+    };
+}
+// ─── List measurement (returns MeasuredBlock[]) ───────────────────────────────
+async function measureList(element, contentWidth, doc, baseFontSize, hyphenatorOpts) {
+    const baseFontFamily = doc.defaultFont ?? 'Inter';
+    const fontSize = element.fontSize ?? baseFontSize;
+    const lineHeight = element.lineHeight ?? doc.defaultLineHeight ?? (fontSize * 1.5);
+    const indent = element.indent ?? 20;
+    const itemSpaceAfter = element.itemSpaceAfter ?? 4;
+    const fontKey = buildFontKey(baseFontFamily, 400, 'normal');
+    const blocks = [];
+    // Flatten items and nested items
+    const nestedStyle = element.nestedNumberingStyle ?? 'continue';
+    let orderedIndex = 1;
+    const allItems = [];
+    for (let i = 0; i < element.items.length; i++) {
+        const item = element.items[i];
+        const isFirst = i === 0;
+        const marker = element.style === 'ordered'
+            ? `${orderedIndex}.`
+            : (element.marker ?? '•');
+        orderedIndex++;
+        allItems.push({ text: item.text, marker, isNested: false, isFirstInList: isFirst, fontWeight: item.fontWeight ?? 400 });
+        // Nested items (1 level deep)
+        if (item.items && item.items.length > 0) {
+            // 'restart': nested ordered items count from 1, parent counter unaffected
+            // 'continue': nested items share the parent counter (existing behavior)
+            let nestedIndex = nestedStyle === 'restart' ? 1 : orderedIndex;
+            for (let ni = 0; ni < item.items.length; ni++) {
+                const nested = item.items[ni];
+                const nestedMarker = element.style === 'ordered'
+                    ? `${nestedIndex}.`
+                    : '◦'; // hollow bullet for nested unordered
+                nestedIndex++;
+                if (nestedStyle === 'continue')
+                    orderedIndex++;
+                allItems.push({ text: nested.text, marker: nestedMarker, isNested: true, isFirstInList: false, fontWeight: nested.fontWeight ?? 400 });
+            }
+        }
+    }
+    // Compute markerWidth: use explicit override if set, otherwise measure widest marker
+    let markerWidth;
+    if (element.markerWidth != null) {
+        markerWidth = element.markerWidth;
+    }
+    else {
+        const widestMarker = element.style === 'ordered'
+            ? `${allItems.length}.`
+            : (element.marker ?? '•');
+        const measured = await measureNaturalTextWidth(widestMarker, fontSize, baseFontFamily, 400);
+        markerWidth = Math.max(16, measured + 6);
+    }
+    // Width available for item text (after indent + marker column)
+    const textWidth = contentWidth - indent - markerWidth;
+    if (textWidth <= 0) {
+        throw new PretextPdfError('VALIDATION_ERROR', `List indent (${indent}pt) + markerWidth (${markerWidth}pt) exceeds contentWidth (${contentWidth}pt). Reduce indent or markerWidth.`);
+    }
+    for (let i = 0; i < allItems.length; i++) {
+        const item = allItems[i];
+        const isLast = i === allItems.length - 1;
+        const nestedIndent = item.isNested ? indent + markerWidth : indent;
+        const nestedTextWidth = item.isNested ? textWidth - markerWidth : textWidth;
+        const lines = await measureText(item.text, fontSize, baseFontFamily, item.fontWeight, nestedTextWidth, lineHeight, hyphenatorOpts);
+        const listItemData = {
+            marker: item.marker,
+            indent: nestedIndent,
+            markerWidth,
+            color: element.color ?? '#000000',
+            fontWeight: item.fontWeight,
+        };
+        // spaceBefore: only the first item in the entire list gets the list's spaceBefore
+        // spaceAfter: itemSpaceAfter between items, list.spaceAfter on the last item
+        const spaceBefore = item.isFirstInList ? (element.spaceBefore ?? 0) : 0;
+        const spaceAfter = isLast ? (element.spaceAfter ?? 0) : itemSpaceAfter;
+        blocks.push({
+            element, // All items share the parent ListElement (for type checking in renderer)
+            height: Math.max(lines.length, 1) * lineHeight,
+            lines,
+            fontSize,
+            lineHeight,
+            fontKey,
+            spaceAfter,
+            spaceBefore,
+            listItemData,
+        });
+    }
+    return blocks;
+}
+// ─── Table measurement ────────────────────────────────────────────────────────
+async function measureTable(element, contentWidth, doc, baseFontSize, hyphenatorOpts) {
+    const baseFontFamily = doc.defaultFont ?? 'Inter';
+    const fontSize = element.fontSize ?? baseFontSize;
+    const lineHeight = doc.defaultLineHeight ?? (fontSize * 1.5);
+    const cellPaddingH = element.cellPaddingH ?? 8;
+    const cellPaddingV = element.cellPaddingV ?? 6;
+    const borderWidth = element.borderWidth ?? 0.5;
+    const borderColor = element.borderColor ?? '#cccccc';
+    const headerBgColor = element.headerBgColor ?? '#f5f5f5';
+    // Pre-pass: measure natural widths for 'auto' columns — run all in parallel
+    const hasAutoColumns = element.columns.some(c => c.width === 'auto');
+    let naturalWidths;
+    if (hasAutoColumns) {
+        naturalWidths = new Array(element.columns.length).fill(0);
+        const jobs = [];
+        for (const row of element.rows) {
+            let colIdx = 0;
+            for (const cell of row.cells) {
+                const cs = cell.colspan ?? 1;
+                if (element.columns[colIdx]?.width === 'auto') {
+                    jobs.push({
+                        colIdx, cs,
+                        fontWeight: (cell.fontWeight ?? (row.isHeader ? 700 : 400)),
+                        cellFontSize: cell.fontSize ?? fontSize,
+                        cellFamily: cell.fontFamily ?? baseFontFamily,
+                        text: cell.text,
+                    });
+                }
+                colIdx += cs;
+            }
+        }
+        // Measure all auto cells in parallel
+        const widths = await Promise.all(jobs.map(j => measureNaturalTextWidth(j.text, j.cellFontSize, j.cellFamily, j.fontWeight)));
+        // Assign results back
+        for (let i = 0; i < jobs.length; i++) {
+            const { colIdx, cs } = jobs[i];
+            const cellNaturalWidth = widths[i] + 2 * cellPaddingH;
+            const perColumn = cellNaturalWidth / cs;
+            for (let si = colIdx; si < colIdx + cs && si < element.columns.length; si++) {
+                if (element.columns[si]?.width === 'auto') {
+                    naturalWidths[si] = Math.max(naturalWidths[si], perColumn);
+                }
+            }
+        }
+    }
+    // Resolve column widths (passes naturalWidths for 'auto' columns)
+    const columnWidths = resolveColumnWidths(element.columns, contentWidth, cellPaddingH, borderWidth, naturalWidths);
+    // Determine header row count
+    const headerRowCount = element.headerRows !== undefined
+        ? element.headerRows
+        : element.rows.filter(r => r.isHeader).length;
+    const allCellMeta = [];
+    for (const row of element.rows) {
+        let colStart = 0;
+        for (const cell of row.cells) {
+            const cs = cell.colspan ?? 1;
+            const col = element.columns[colStart];
+            let mergedWidth = 0;
+            for (let si = colStart; si < colStart + cs && si < columnWidths.length; si++) {
+                mergedWidth += columnWidths[si];
+                if (si < colStart + cs - 1)
+                    mergedWidth += borderWidth;
+            }
+            const fontWeight = (cell.fontWeight ?? (row.isHeader ? 700 : 400));
+            const fontFamily = cell.fontFamily ?? baseFontFamily;
+            const cellFontSize = cell.fontSize ?? fontSize;
+            const cellLineHeight = doc.defaultLineHeight ?? (cellFontSize * 1.5);
+            const cellFontKey = buildFontKey(fontFamily, fontWeight, 'normal');
+            const textWidth = mergedWidth - 2 * cellPaddingH - borderWidth;
+            const cellDir = (cell.dir ?? 'auto');
+            allCellMeta.push({ cell, row, cs, col, mergedWidth, fontWeight, fontFamily, cellFontSize, cellLineHeight, cellFontKey, textWidth, cellDir });
+            colStart += cs;
+        }
+    }
+    // Step 2: Run all RTL detection + text measurement in parallel across the whole table
+    const cellResults = await Promise.all(allCellMeta.map(async (m) => {
+        const { visual: cellVisualText, isRTL: cellIsRTL } = await detectAndReorderRTL(m.cell.text, m.cellDir);
+        const lines = await measureText(cellVisualText, m.cellFontSize, m.fontFamily, m.fontWeight, Math.max(m.textWidth, 1), m.cellLineHeight, hyphenatorOpts);
+        return { cellVisualText, cellIsRTL, lines };
+    }));
+    // Step 3: Reassemble into measuredRows
+    const measuredRows = [];
+    let cellIdx = 0;
+    for (const row of element.rows) {
+        const measuredCells = [];
+        let maxCellHeight = 0;
+        for (const _ of row.cells) {
+            const m = allCellMeta[cellIdx];
+            const { cellIsRTL, lines } = cellResults[cellIdx];
+            const cellContentHeight = Math.max(lines.length, 1) * m.cellLineHeight;
+            maxCellHeight = Math.max(maxCellHeight, cellContentHeight);
+            const align = m.cell.align ?? m.col.align ?? (cellIsRTL ? 'right' : 'left');
+            const measuredCell = {
+                lines,
+                fontSize: m.cellFontSize,
+                lineHeight: m.cellLineHeight,
+                fontKey: m.cellFontKey,
+                fontFamily: m.fontFamily,
+                align,
+                color: m.cell.color ?? '#000000',
+                colspan: m.cs,
+                mergedWidth: m.mergedWidth,
+                isRTL: cellIsRTL,
+                ...(m.cell.tabularNumbers !== undefined && { tabularNumbers: m.cell.tabularNumbers }),
+            };
+            if (m.cell.bgColor !== undefined)
+                measuredCell.bgColor = m.cell.bgColor;
+            measuredCells.push(measuredCell);
+            cellIdx++;
+        }
+        const rowHeight = maxCellHeight + 2 * cellPaddingV;
+        const activeBoundaries = computeActiveBoundaries(row.cells, element.columns.length);
+        measuredRows.push({ cells: measuredCells, height: rowHeight, isHeader: row.isHeader ?? false, activeBoundaries });
+    }
+    // Header rows are the first N rows
+    const headerRows = measuredRows.slice(0, headerRowCount);
+    const headerRowHeight = headerRows.reduce((sum, r) => sum + r.height, 0);
+    // Total table height = sum of all row heights
+    const totalHeight = measuredRows.reduce((sum, r) => sum + r.height, 0);
+    const tableData = {
+        columnWidths,
+        rows: measuredRows,
+        headerRowCount,
+        headerRowHeight,
+        cellPaddingH,
+        cellPaddingV,
+        borderWidth,
+        borderColor,
+        headerBgColor,
+    };
+    return {
+        element,
+        height: totalHeight,
+        lines: [],
+        fontSize: 0,
+        lineHeight: 0,
+        fontKey: '',
+        spaceAfter: element.spaceAfter ?? 0,
+        spaceBefore: element.spaceBefore ?? 0,
+        tableData,
+    };
+}
+// ─── Column width resolution ──────────────────────────────────────────────────
+/**
+ * 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 function resolveColumnWidths(columns, contentWidth, cellPaddingH, borderWidth, naturalWidths) {
+    const MIN_COLUMN_WIDTH = cellPaddingH * 2 + borderWidth * 2 + 4; // minimum usable pt
+    let totalFixed = 0;
+    let totalStars = 0;
+    let totalAutoNatural = 0;
+    let autoCount = 0;
+    for (let i = 0; i < columns.length; i++) {
+        const col = columns[i];
+        if (typeof col.width === 'number') {
+            totalFixed += col.width;
+        }
+        else if (col.width === 'auto') {
+            // Auto columns reserve their natural width from remaining space
+            const natural = naturalWidths?.[i] ?? MIN_COLUMN_WIDTH;
+            totalAutoNatural += natural;
+            autoCount++;
+        }
+        else {
+            // '*' → 1 star, '2*' → 2 stars, '1.5*' → 1.5 stars
+            const match = col.width.match(/^(\d*\.?\d*)?\*$/);
+            const stars = (match && match[1]) ? parseFloat(match[1]) : 1;
+            totalStars += stars;
+        }
+    }
+    const remaining = contentWidth - totalFixed;
+    if (remaining < -0.01) {
+        throw new PretextPdfError('TABLE_COLUMN_OVERFLOW', `Table fixed column widths (${totalFixed.toFixed(1)}pt) exceed content width (${contentWidth.toFixed(1)}pt). ` +
+            `Reduce column widths or page margins.`);
+    }
+    // How much space is available after fixed columns
+    const availableForFlexible = Math.max(0, remaining);
+    // Auto columns claim their natural width (capped at available space).
+    // Star columns share whatever remains after auto columns.
+    // If auto columns overflow, they get proportional shares of available space.
+    const autoFits = totalAutoNatural <= availableForFlexible;
+    const autoUsed = autoFits ? totalAutoNatural : availableForFlexible;
+    const availableForStars = availableForFlexible - autoUsed;
+    const starUnit = totalStars > 0 ? Math.max(0, availableForStars) / totalStars : 0;
+    return columns.map((col, i) => {
+        let resolved;
+        if (typeof col.width === 'number') {
+            resolved = col.width;
+        }
+        else if (col.width === 'auto') {
+            const natural = naturalWidths?.[i] ?? MIN_COLUMN_WIDTH;
+            if (autoFits) {
+                resolved = natural;
+            }
+            else {
+                // Constrained: proportional share based on natural widths
+                resolved = totalAutoNatural > 0
+                    ? (natural / totalAutoNatural) * availableForFlexible
+                    : MIN_COLUMN_WIDTH;
+            }
+        }
+        else {
+            const match = col.width.match(/^(\d*\.?\d*)?\*$/);
+            const stars = (match && match[1]) ? parseFloat(match[1]) : 1;
+            resolved = stars * starUnit;
+        }
+        if (resolved < MIN_COLUMN_WIDTH) {
+            throw new PretextPdfError('TABLE_COLUMN_TOO_NARROW', `Table column ${i} resolved to ${resolved.toFixed(1)}pt, minimum is ${MIN_COLUMN_WIDTH.toFixed(1)}pt. ` +
+                `Increase the column width or reduce cellPaddingH/borderWidth.`);
+        }
+        return resolved;
+    });
+}
+/**
+ * Compute which column boundaries have visible vertical lines.
+ * A boundary is "active" (visible) if it's not spanned by any merged cell.
+ * Returns array of boundary indices (0 = between col 0 and 1, 1 = between col 1 and 2, etc.)
+ * where vertical lines should be drawn.
+ *
+ * Example: 3 columns with a cell spanning cols 0-1 → active boundaries are [1] (only between cols 1-2)
+ */
+function computeActiveBoundaries(cells, colCount) {
+    // Track which boundaries are "spanned" (internal to a merged cell)
+    const spannedBoundaries = new Set();
+    let colIdx = 0;
+    for (const cell of cells) {
+        const cs = cell.colspan ?? 1;
+        // Boundaries internal to this cell's span are: colIdx to colIdx + cs - 1
+        // The internal boundaries are colIdx, colIdx+1, ..., colIdx+cs-2
+        for (let b = colIdx; b < colIdx + cs - 1; b++) {
+            spannedBoundaries.add(b);
+        }
+        colIdx += cs;
+    }
+    // Active boundaries are all boundaries (0 to colCount-2) that are NOT spanned
+    const activeBoundaries = [];
+    for (let b = 0; b < colCount - 1; b++) {
+        if (!spannedBoundaries.has(b)) {
+            activeBoundaries.push(b);
+        }
+    }
+    return activeBoundaries;
+}
+/**
+ * Measure the natural (unwrapped) width of text in pt.
+ * Uses a very large maxWidth so Pretext never wraps — returns the actual line width.
+ */
+async function measureNaturalTextWidth(text, fontSize, fontFamily, fontWeight) {
+    if (!text || text.trim() === '')
+        return 0;
+    const { prepareWithSegments, layoutWithLines } = await getPretext();
+    const weightPrefix = fontWeight === 700 ? 'bold ' : '';
+    const fontString = `${weightPrefix}${fontSize}px ${fontFamily}`;
+    // Use a very large width to prevent wrapping; also handle multi-line text (\n)
+    // by taking the max line width across all lines
+    const prepared = prepareWithSegments(text, fontString, { whiteSpace: 'pre-wrap' });
+    const result = layoutWithLines(prepared, 99999, fontSize * 1.5);
+    const lines = result.lines ?? [];
+    return lines.reduce((max, line) => Math.max(max, line.width), 0);
+}
+// ─── Text measurement (shared by all text-bearing elements) ──────────────────
+/**
+ * Measure text with automatic word hyphenation (Liang's algorithm via hypher).
+ * Splits on \n to preserve paragraph breaks; tokenizes words; greedily packs with hyphenation fallback.
+ */
+//# sourceMappingURL=measure-blocks.js.map