postext 1.3.3 → 1.4.0

package/dist/pipeline/build.js

@@ -2,7 +2,7 @@ import { applyTitleBreaks } from '../parse/inlineFormatting';
 import { dimensionToPx } from '../units';
 import { createVDTDocument, createVDTBlock, createBoundingBox, } from '../vdt';
 import { anchorBox } from '../design/layout';
-import { parseMarkdownMemo } from '../parse';
+import { parseMarkdownMemo, spaceDirectiveLines } from '../parse';
 import { buildPageLabels, computeHeadingNumbers, } from '../numbering';
 import { extractFrontmatter } from '../frontmatter';
 import { initHyphenator } from '../measure';
@@ -14,7 +14,7 @@ import { resolveBodyStyle, resolveBlockquoteStyle } from './styles';
 import { computeLevelIndentsPx, computeOrderedLevelIndentsPx, computeOrderedListRunMetrics, } from './lists';
 import { resetLinePositions, createPageWithColumns, currentColumn, advanceToNextColumn, advanceToNextPageBoundary, enforcePageParity, placeBlockInColumn, placeAtomicBlock, createPartPage, pageHasContent, sideColumnOf, sideColumns, sideUsedBottom, pageIsOccupied, bandColumns, currentBand, isBandLevel, bandUsedBottom, closeBandAndInsertSpan, } from './placement';
 import { chooseParagraphSplit } from './orphanWidow';
-import { applyStyleAttrs, computePageMetrics, isMarkerBlock, nextNonMarkerBlock, prevNonMarkerBlock, rollbackTrailingBlocks, } from './buildHelpers';
+import { applyStyleAttrs, computePageMetrics, isMarkerBlock, nextNonMarkerBlock, spaceLinesAfter, prevNonMarkerBlock, rollbackTrailingBlocks, } from './buildHelpers';
 import { measureContentBlock } from './measureContentBlock';
 import { planParagraphContainers } from './paragraphContainers';
 import { planParts, derivePartMeasureContext } from './parts';
@@ -2678,6 +2678,19 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
                     flushPendingNumberingAtBoundary();
                 }
             }
+            else if (name === 'space') {
+                // Explicit vertical space (`:::space{lines=N}`), in body lines. It
+                // adds to the margin between its neighbours (the pending margin
+                // still collapses with the next block's top margin) and, like
+                // LaTeX's `\vspace`, is discarded at a break: it vanishes at a
+                // column top, and one that does not fit ends the column instead of
+                // carrying over.
+                const col = currentColumn(doc, cursor);
+                if (col.blocks.length > 0) {
+                    const px = (spaceDirectiveLines(attrs) ?? 1) * baselineGrid;
+                    col.availableHeight = Math.max(0, col.availableHeight - px);
+                }
+            }
             else if (name === 'numbering') {
                 const change = {};
                 const fmt = attrs.format;
@@ -3273,7 +3286,9 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
                     const minLinesNeeded = resolved.bodyText.avoidWidows
                         ? Math.max(1, resolved.bodyText.widowMinLines)
                         : 1;
-                    const minSpaceAfter = minLinesNeeded * bodyStyle.lineHeightPx;
+                    // A `:::space` between the heading and its text needs room too.
+                    const minSpaceAfter = minLinesNeeded * bodyStyle.lineHeightPx
+                        + spaceLinesAfter(contentBlocks, blockIdx) * baselineGrid;
                     if (remainAfterHeading < minSpaceAfter) {
                         if (curCol.blocks.length === 0)
                             shortColumnMoves++;