docxodus 9.7.0 → 9.8.0

package/dist/pagination.d.ts.map

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

package/dist/pagination.js

@@ -5,7 +5,7 @@
  * and flows it across fixed-size page containers based on document dimensions.
  */
 import { formatPageNumber } from "./page-number-format.js";
-import { DEFAULT_MARGIN, DEFAULT_PAGE_WIDTH, parseSectionDimensions, ptToPx, pxToPt, } from "./page-geometry.js";
+import { DEFAULT_MARGIN, DEFAULT_PAGE_WIDTH, parseSectionDimensions, ptToPx, pxToPt, resolvePageBands, } from "./page-geometry.js";
 // Default letter size in points (612 x 792 = 8.5" x 11")
 // Maximum percentage of content height that footnotes can occupy
 // This allows footnotes to expand upward into body content space when needed
@@ -276,7 +276,7 @@ export class PaginationEngine {
      * send it through the oversized-block fallback again.
      */
     smallestEffectiveContentHeight(dims, sectionIndex) {
-        return Math.min(this.getEffectiveHeights(dims, sectionIndex, 1, 1).contentHeight, this.getEffectiveHeights(dims, sectionIndex, 2, 1).contentHeight, this.getEffectiveHeights(dims, sectionIndex, 2, 2).contentHeight);
+        return Math.min(this.getPageBands(dims, sectionIndex, 1, 1).bodyHeight, this.getPageBands(dims, sectionIndex, 2, 1).bodyHeight, this.getPageBands(dims, sectionIndex, 2, 2).bodyHeight);
     }
     /**
      * Builds a clone of a simple table wrapper containing a contiguous run of rows.
@@ -724,7 +724,7 @@ export class PaginationEngine {
             return 0;
         }
         // Measure in the SAME styling context the notes render in: `.page-footnotes` carries
-        // font-size 0.85em and line-height 1.4, so measuring without the class sizes the note
+        // its own font-size and line-height, so measuring without the class sizes the note
         // block against body type and the reserve can never match what is drawn.
         // Create a temporary measurement container
         const measureContainer = document.createElement("div");
@@ -884,7 +884,7 @@ export class PaginationEngine {
     /**
      * Adds footnotes to a page container, including continuation content.
      */
-    addPageFootnotes(pageBox, footnoteIds, dims, footnoteHeight, continuation, partialFootnotes) {
+    addPageFootnotes(pageBox, footnoteIds, dims, bands, footnoteHeight, continuation, partialFootnotes) {
         const hasContinuation = continuation && continuation.remainingElements.length > 0;
         if (footnoteIds.length === 0 && !hasContinuation) {
             return;
@@ -895,11 +895,13 @@ export class PaginationEngine {
         // Create a set of partial footnote IDs for quick lookup
         const partialFootnoteIds = new Set(partialFootnotes?.map(p => p.footnoteId) || []);
         // Calculate max height for footnotes area (content height minus margin for body content)
-        const maxFootnoteHeight = Math.min(footnoteHeight, dims.contentHeight * MAX_FOOTNOTE_AREA_RATIO);
+        const maxFootnoteHeight = Math.min(footnoteHeight, bands.bodyHeight * MAX_FOOTNOTE_AREA_RATIO);
         const footnotesDiv = document.createElement("div");
         footnotesDiv.className = `${this.cssPrefix}footnotes`;
         footnotesDiv.style.position = "absolute";
-        footnotesDiv.style.bottom = `${dims.marginBottom}pt`; // Above footer area
+        // Notes sit at the FOOT OF THE BODY BAND, not at the bottom margin: a footer taller than
+        // its margin raises that edge, and anchoring to the raw margin would draw notes over it.
+        footnotesDiv.style.bottom = `${dims.pageHeight - (bands.bodyTop + bands.bodyHeight)}pt`;
         footnotesDiv.style.left = `${dims.marginLeft}pt`;
         footnotesDiv.style.width = `${dims.contentWidth}pt`;
         footnotesDiv.style.boxSizing = "border-box";
@@ -991,63 +993,37 @@ export class PaginationEngine {
         return sectionHf.footerDefault;
     }
     /**
-     * Computes effective header, footer, and content heights for a specific page position.
-     * Uses pre-measured header/footer heights from the registry.
-     * This method is deterministic - same inputs always produce same outputs.
-     * This enables lazy loading compatibility since available height can be computed
-     * for any page position without knowing the page's content.
+     * The header, body, and footer bands for one page position.
+     *
+     * The single owner of "where does anything sit vertically on this page" — placement in
+     * {@link createPage}, the body budget the flow loop spends, and the note area's anchor all
+     * read it, so those three cannot disagree about where the body ends.
+     *
+     * Deterministic: it depends only on the section's page setup and the registry's pre-measured
+     * story heights, never on the page's content, which is what keeps it lazy-loading compatible.
      */
-    getEffectiveHeights(dims, sectionIndex, pageInSection, globalPageNumber) {
+    getPageBands(dims, sectionIndex, pageInSection, globalPageNumber) {
         const sectionHf = this.hfRegistry.get(sectionIndex);
-        // Determine effective header height
-        let headerHeight = dims.marginTop;
-        if (sectionHf) {
-            let measuredHeaderHeight;
-            // Select the appropriate header height based on page position
-            if (pageInSection === 1 && sectionHf.headerFirstHeight != null) {
-                measuredHeaderHeight = sectionHf.headerFirstHeight;
-            }
-            else if (globalPageNumber % 2 === 0 && sectionHf.headerEvenHeight != null) {
-                measuredHeaderHeight = sectionHf.headerEvenHeight;
-            }
-            else if (sectionHf.headerDefaultHeight != null) {
-                measuredHeaderHeight = sectionHf.headerDefaultHeight;
-            }
-            if (measuredHeaderHeight != null) {
-                // Use the larger of margin height or measured content height
-                headerHeight = Math.max(dims.marginTop, measuredHeaderHeight);
-            }
-        }
-        // Determine effective footer height
-        let footerHeight = dims.marginBottom;
-        if (sectionHf) {
-            let measuredFooterHeight;
-            // Select the appropriate footer height based on page position
-            if (pageInSection === 1 && sectionHf.footerFirstHeight != null) {
-                measuredFooterHeight = sectionHf.footerFirstHeight;
-            }
-            else if (globalPageNumber % 2 === 0 && sectionHf.footerEvenHeight != null) {
-                measuredFooterHeight = sectionHf.footerEvenHeight;
-            }
-            else if (sectionHf.footerDefaultHeight != null) {
-                measuredFooterHeight = sectionHf.footerDefaultHeight;
-            }
-            if (measuredFooterHeight != null) {
-                // Use the larger of margin height or measured content height
-                footerHeight = Math.max(dims.marginBottom, measuredFooterHeight);
-            }
-        }
-        // Calculate effective content height
-        // contentHeight from dims is: pageHeight - marginTop - marginBottom
-        // We need to adjust for any header/footer expansion beyond margins
-        const headerExpansion = headerHeight - dims.marginTop;
-        const footerExpansion = footerHeight - dims.marginBottom;
-        const contentHeight = dims.contentHeight - headerExpansion - footerExpansion;
-        return { headerHeight, footerHeight, contentHeight };
+        return resolvePageBands(dims, this.selectStoryHeight(sectionHf?.headerFirstHeight, sectionHf?.headerEvenHeight, sectionHf?.headerDefaultHeight, pageInSection, globalPageNumber), this.selectStoryHeight(sectionHf?.footerFirstHeight, sectionHf?.footerEvenHeight, sectionHf?.footerDefaultHeight, pageInSection, globalPageNumber));
+    }
+    /**
+     * The measured height of the running story this page position selects, mirroring
+     * {@link selectHeader}/{@link selectFooter}. Zero when the page has no such story.
+     */
+    selectStoryHeight(first, even, fallback, pageInSection, globalPageNumber) {
+        if (pageInSection === 1 && first != null)
+            return first;
+        if (globalPageNumber % 2 === 0 && even != null)
+            return even;
+        return fallback ?? 0;
     }
     /**
      * Measures the content height of a header or footer element.
-     * This is needed because headers/footers can contain more content than fits in the margin area.
+     *
+     * This is what tells {@link resolvePageBands} whether the story stays inside its margin or
+     * pushes the body, so it must measure the story ALONE — any padding added here would have to
+     * be added to the rendered band too, and the two drifting apart is exactly how a header
+     * silently starts overlapping body text.
      */
     measureHeaderFooterHeight(source, contentWidth) {
         // Create a temporary measurement container
@@ -1056,8 +1032,6 @@ export class PaginationEngine {
         measureContainer.style.visibility = "hidden";
         measureContainer.style.width = `${contentWidth}pt`;
         measureContainer.style.left = "-9999px";
-        // Add padding to match the actual rendering
-        measureContainer.style.paddingBottom = "4pt";
         // Clone and add the header/footer content
         for (const child of Array.from(source.childNodes)) {
             measureContainer.appendChild(child.cloneNode(true));
@@ -1083,7 +1057,7 @@ export class PaginationEngine {
         // Track page number within this section for first-page header/footer selection
         let pageInSection = 1;
         // Get effective content height for first page (accounts for header/footer sizes)
-        let { contentHeight: effectiveContentHeight } = this.getEffectiveHeights(dims, sectionIndex, pageInSection, pageNumber);
+        let { bodyHeight: effectiveContentHeight } = this.getPageBands(dims, sectionIndex, pageInSection, pageNumber);
         let remainingHeight = effectiveContentHeight;
         // Track the previous block's bottom margin for margin collapsing
         let prevMarginBottomPt = 0;
@@ -1123,8 +1097,8 @@ export class PaginationEngine {
             pageInSection++;
             currentContent = [];
             // Get effective content height for new page position
-            const newHeights = this.getEffectiveHeights(dims, sectionIndex, pageInSection, pageNumber);
-            effectiveContentHeight = newHeights.contentHeight;
+            const newBands = this.getPageBands(dims, sectionIndex, pageInSection, pageNumber);
+            effectiveContentHeight = newBands.bodyHeight;
             remainingHeight = effectiveContentHeight;
             prevMarginBottomPt = 0; // Reset margin tracking for new page
             currentFootnoteIds = []; // Reset footnotes for new page
@@ -1188,14 +1162,14 @@ export class PaginationEngine {
                         additionalChainFootnoteHeight;
                     const currentAvailableHeight = remainingHeight - currentFootnoteHeight;
                     if (currentChainHeight > currentAvailableHeight) {
-                        const nextPageHeights = this.getEffectiveHeights(dims, sectionIndex, pageInSection + 1, pageNumber + 1);
+                        const nextPageBands = this.getPageBands(dims, sectionIndex, pageInSection + 1, pageNumber + 1);
                         const freshChainBodyHeight = this.measureKeepWithNextChainBodyHeight(keepChain, 0, true);
                         // finishPage transfers this continuation to the new page's
                         // currentContinuation state, so include it in the destination
                         // page's footnote reservation before deciding to move the chain.
                         const freshChainFootnoteHeight = this.measureFootnotesHeight(newChainFootnoteIds, dims.contentWidth, nextPageContinuation);
                         if (freshChainBodyHeight + freshChainFootnoteHeight <=
-                            nextPageHeights.contentHeight) {
+                            nextPageBands.bodyHeight) {
                             finishPage();
                         }
                     }
@@ -1425,6 +1399,144 @@ export class PaginationEngine {
                 el.setAttribute("contenteditable", "false");
         }
     }
+    /**
+     * Resolves floating DrawingML objects after their anchor paragraphs have landed on a page.
+     *
+     * The converter deliberately carries the OOXML bases and offsets as data instead of flattening
+     * them into CSS: page/margin/column bases belong to the page, while paragraph/line/character
+     * bases belong to the laid-out anchor. Once both coordinate systems exist, promote the object
+     * from the clipped text column into the page box and position it in one shared point space.
+     */
+    positionDrawingAnchors(pageBox, contentArea, dims, pageNumber) {
+        const anchors = Array.from(contentArea.querySelectorAll('[data-docx-drawing-anchor="true"]'));
+        if (anchors.length === 0)
+            return;
+        const pageRect = pageBox.getBoundingClientRect();
+        const pixelsPerPoint = pageRect.width / dims.pageWidth;
+        if (!(pixelsPerPoint > 0))
+            return;
+        for (const anchor of anchors) {
+            const staticRect = anchor.getBoundingClientRect();
+            const paragraph = anchor.closest('p, h1, h2, h3, h4, h5, h6');
+            const paragraphRect = paragraph?.getBoundingClientRect() ?? staticRect;
+            const toPageX = (x) => (x - pageRect.left) / pixelsPerPoint;
+            const toPageY = (y) => (y - pageRect.top) / pixelsPerPoint;
+            const context = {
+                staticLeft: toPageX(staticRect.left),
+                staticTop: toPageY(staticRect.top),
+                lineHeight: paragraph
+                    ? (parseFloat(getComputedStyle(paragraph).lineHeight) || staticRect.height) / pixelsPerPoint
+                    : staticRect.height / pixelsPerPoint,
+                paragraphLeft: toPageX(paragraphRect.left),
+                paragraphTop: toPageY(paragraphRect.top),
+                paragraphWidth: paragraphRect.width / pixelsPerPoint,
+                paragraphHeight: paragraphRect.height / pixelsPerPoint,
+            };
+            const widthReference = this.horizontalAnchorReference(anchor.getAttribute('data-docx-anchor-width-relative') ?? 'margin', dims, pageNumber, context);
+            const widthPercent = this.anchorNumber(anchor, 'width-percent');
+            if (widthPercent !== undefined) {
+                anchor.style.width = `${widthReference.size * widthPercent / 100}pt`;
+            }
+            const heightReference = this.verticalAnchorReference(anchor.getAttribute('data-docx-anchor-height-relative') ?? 'margin', dims, pageNumber, context);
+            const heightPercent = this.anchorNumber(anchor, 'height-percent');
+            if (heightPercent !== undefined && anchor.dataset.docxAnchorAutofit !== 'true') {
+                anchor.style.height = `${heightReference.size * heightPercent / 100}pt`;
+            }
+            // Read the final border-box size after relative sizing and before reparenting. The stored
+            // wp:extent remains the fallback; wps:bodyPr insets stay inside it through border-box sizing.
+            const sizedRect = anchor.getBoundingClientRect();
+            const width = sizedRect.width / pixelsPerPoint;
+            const height = sizedRect.height / pixelsPerPoint;
+            const horizontal = this.horizontalAnchorReference(anchor.getAttribute('data-docx-anchor-h-relative') ?? 'column', dims, pageNumber, context);
+            const vertical = this.verticalAnchorReference(anchor.getAttribute('data-docx-anchor-v-relative') ?? 'paragraph', dims, pageNumber, context);
+            const left = this.resolveAnchorAxis(horizontal, width, anchor.getAttribute('data-docx-anchor-h-align'), this.anchorNumber(anchor, 'h-offset'), pageNumber);
+            const top = this.resolveAnchorAxis(vertical, height, anchor.getAttribute('data-docx-anchor-v-align'), this.anchorNumber(anchor, 'v-offset'), pageNumber);
+            pageBox.appendChild(anchor);
+            anchor.style.position = 'absolute';
+            anchor.style.left = `${left}pt`;
+            anchor.style.top = `${top}pt`;
+            anchor.style.margin = '0';
+        }
+    }
+    anchorNumber(anchor, suffix) {
+        const raw = anchor.getAttribute(`data-docx-anchor-${suffix}`);
+        if (raw === null)
+            return undefined;
+        const value = Number(raw);
+        return Number.isFinite(value) ? value : undefined;
+    }
+    horizontalAnchorReference(relativeFrom, dims, pageNumber, context) {
+        const leftMargin = { start: 0, size: dims.marginLeft };
+        const rightMargin = {
+            start: dims.marginLeft + dims.contentWidth,
+            size: dims.marginRight,
+        };
+        switch (relativeFrom) {
+            case 'page':
+                return { start: 0, size: dims.pageWidth };
+            case 'character':
+                return { start: context.staticLeft, size: 0 };
+            case 'leftMargin':
+                return leftMargin;
+            case 'rightMargin':
+                return rightMargin;
+            case 'insideMargin':
+                return pageNumber % 2 === 1 ? leftMargin : rightMargin;
+            case 'outsideMargin':
+                return pageNumber % 2 === 1 ? rightMargin : leftMargin;
+            case 'paragraph':
+                // Not part of ST_RelFromH, but accepting it gives malformed/legacy producers the
+                // intuitive base without conflating it with the whole text column.
+                return { start: context.paragraphLeft, size: context.paragraphWidth };
+            case 'column':
+            case 'margin':
+            default:
+                // The paginator currently lays out one text column per section, so the column and page
+                // margin boxes coincide. Keeping the names distinct here leaves multi-column geometry
+                // localized to this resolver when that layout support is added.
+                return { start: dims.marginLeft, size: dims.contentWidth };
+        }
+    }
+    verticalAnchorReference(relativeFrom, dims, pageNumber, context) {
+        const topMargin = { start: 0, size: dims.marginTop };
+        const bottomMargin = {
+            start: dims.marginTop + dims.contentHeight,
+            size: dims.marginBottom,
+        };
+        switch (relativeFrom) {
+            case 'page':
+                return { start: 0, size: dims.pageHeight };
+            case 'paragraph':
+                return { start: context.paragraphTop, size: context.paragraphHeight };
+            case 'line':
+                return { start: context.staticTop, size: context.lineHeight };
+            case 'topMargin':
+                return topMargin;
+            case 'bottomMargin':
+                return bottomMargin;
+            case 'insideMargin':
+                return pageNumber % 2 === 1 ? topMargin : bottomMargin;
+            case 'outsideMargin':
+                return pageNumber % 2 === 1 ? bottomMargin : topMargin;
+            case 'margin':
+            default:
+                return { start: dims.marginTop, size: dims.contentHeight };
+        }
+    }
+    resolveAnchorAxis(reference, objectSize, alignment, offset, pageNumber) {
+        if (offset !== undefined)
+            return reference.start + offset;
+        let fraction = 0;
+        if (alignment === 'center')
+            fraction = 0.5;
+        else if (alignment === 'right' || alignment === 'bottom')
+            fraction = 1;
+        else if (alignment === 'inside')
+            fraction = pageNumber % 2 === 1 ? 0 : 1;
+        else if (alignment === 'outside')
+            fraction = pageNumber % 2 === 1 ? 1 : 0;
+        return reference.start + (reference.size - objectSize) * fraction;
+    }
     /**
      * Creates a page container element.
      */
@@ -1464,24 +1576,27 @@ export class PaginationEngine {
         // Needed by substitutePageNumberFields: a section that restarts numbering counts from its own
         // first page, not from the document's.
         pageBox.dataset.pageInSection = String(pageInSection);
-        // Get pre-computed effective heights for this page position (no re-measurement needed)
-        const effectiveHeights = this.getEffectiveHeights(dims, sectionIndex, pageInSection, pageNumber);
+        // Where the three bands sit on this page (no re-measurement needed)
+        const bands = this.getPageBands(dims, sectionIndex, pageInSection, pageNumber);
         // Add header if available for this section/page
         const headerSource = this.selectHeader(sectionIndex, pageInSection, pageNumber);
         if (headerSource) {
             const headerDiv = document.createElement("div");
             headerDiv.className = `${this.cssPrefix}header`;
             headerDiv.style.position = "absolute";
-            headerDiv.style.top = "0"; // Start at page top
+            // `w:header` is the distance to the TOP of the story, and the story grows downward from
+            // there; `flex-start` therefore pins the edge the OOXML actually declares, and content
+            // taller than the measurement clips at the bottom rather than sliding up the page.
+            headerDiv.style.top = `${bands.headerTop}pt`;
+            headerDiv.style.bottom = "auto";
             headerDiv.style.left = `${dims.marginLeft}pt`;
             headerDiv.style.width = `${dims.contentWidth}pt`;
-            headerDiv.style.height = `${effectiveHeights.headerHeight}pt`; // Use pre-computed effective height
+            headerDiv.style.height = `${bands.headerHeight}pt`;
             headerDiv.style.overflow = "hidden";
             headerDiv.style.boxSizing = "border-box";
             headerDiv.style.display = "flex";
             headerDiv.style.flexDirection = "column";
-            headerDiv.style.justifyContent = "flex-end"; // Align content to bottom of header area
-            headerDiv.style.paddingBottom = "4pt"; // Small gap before content area
+            headerDiv.style.justifyContent = "flex-start";
             // Clone the header content (skip the wrapper div's data attributes)
             for (const child of Array.from(headerSource.childNodes)) {
                 const clonedheaderDiv = child.cloneNode(true);
@@ -1492,8 +1607,8 @@ export class PaginationEngine {
             pageBox.appendChild(headerDiv);
         }
         // Create content area using pre-computed effective heights
-        const contentAreaTop = effectiveHeights.headerHeight;
-        const contentAreaHeight = effectiveHeights.contentHeight;
+        const contentAreaTop = bands.bodyTop;
+        const contentAreaHeight = bands.bodyHeight;
         const contentArea = document.createElement("div");
         contentArea.className = `${this.cssPrefix}content`;
         contentArea.style.position = "absolute";
@@ -1510,7 +1625,7 @@ export class PaginationEngine {
         // Add footnotes if any references appear on this page (or continuation from previous)
         const hasContinuation = continuation && continuation.remainingElements.length > 0;
         if (footnoteIds.length > 0 || hasContinuation) {
-            this.addPageFootnotes(pageBox, footnoteIds, dims, footnoteHeight, continuation, partialFootnotes);
+            this.addPageFootnotes(pageBox, footnoteIds, dims, bands, footnoteHeight, continuation, partialFootnotes);
         }
         // Add footer if available for this section/page
         const footerSource = this.selectFooter(sectionIndex, pageInSection, pageNumber);
@@ -1518,16 +1633,18 @@ export class PaginationEngine {
             const footerDiv = document.createElement("div");
             footerDiv.className = `${this.cssPrefix}footer`;
             footerDiv.style.position = "absolute";
-            footerDiv.style.bottom = "0"; // Start at page bottom
+            // `w:footer` is the distance to the BOTTOM of the story, and the story grows upward from
+            // there — the mirror of the header, so `flex-end` and a bottom anchor.
+            footerDiv.style.top = "auto";
+            footerDiv.style.bottom = `${dims.footerDistance}pt`;
             footerDiv.style.left = `${dims.marginLeft}pt`;
             footerDiv.style.width = `${dims.contentWidth}pt`;
-            footerDiv.style.height = `${effectiveHeights.footerHeight}pt`; // Use pre-computed effective height
+            footerDiv.style.height = `${bands.footerHeight}pt`;
             footerDiv.style.overflow = "hidden";
             footerDiv.style.boxSizing = "border-box";
             footerDiv.style.display = "flex";
             footerDiv.style.flexDirection = "column";
-            footerDiv.style.justifyContent = "flex-start"; // Align content to top of footer area
-            footerDiv.style.paddingTop = "4pt"; // Small gap after content area
+            footerDiv.style.justifyContent = "flex-end";
             // Clone the footer content (skip the wrapper div's data attributes)
             for (const child of Array.from(footerSource.childNodes)) {
                 const clonedfooterDiv = child.cloneNode(true);
@@ -1546,6 +1663,9 @@ export class PaginationEngine {
         }
         // Add to container
         this.containerElement.appendChild(pageBox);
+        // Floating objects need the final page and anchor-paragraph boxes. Resolve them only after
+        // append, when getBoundingClientRect() is meaningful, and lift them out of content clipping.
+        this.positionDrawingAnchors(pageBox, contentArea, dims, pageNumber);
         // Body and notes must occupy DISJOINT bands. The note block is absolutely positioned against
         // the page bottom and grows upward, while the content area spans the whole text height — so
         // nothing but the layout loop's arithmetic keeps them apart, and any disagreement between the