@stll/folio-core 0.61.0 → 0.63.0

package/dist/layout-bridge/engine/selectionRects.d.ts

@@ -3,7 +3,7 @@ import { FlowBlock, Layout, Measure } from "../../layout-engine/types.js";
 /**
  * A rectangle representing part of a selection.
  */
-type SelectionRect = {
+export type SelectionRect = {
   /** X coordinate in container space. */
   x: number;
   /** Y coordinate in container space. */
@@ -18,7 +18,7 @@ type SelectionRect = {
 /**
  * Caret position for collapsed selection.
  */
-type CaretPosition = {
+export type CaretPosition = {
   /** X coordinate in container space. */
   x: number;
   /** Y coordinate in container space. */
@@ -38,7 +38,7 @@ type CaretPosition = {
  * @param to - End PM position.
  * @returns Array of rectangles covering the selection.
  */
-declare function selectionToRects(layout: Layout, blocks: FlowBlock[], measures: Measure[], from: number, to: number): SelectionRect[];
+export declare function selectionToRects(layout: Layout, blocks: FlowBlock[], measures: Measure[], from: number, to: number): SelectionRect[];
 /**
  * Get caret position for a collapsed selection.
  *
@@ -48,20 +48,19 @@ declare function selectionToRects(layout: Layout, blocks: FlowBlock[], measures:
  * @param pmPosition - The PM position.
  * @returns Caret position, or null if not found.
  */
-declare function getCaretPosition(layout: Layout, blocks: FlowBlock[], measures: Measure[], pmPosition: number): CaretPosition | null;
+export declare function getCaretPosition(layout: Layout, blocks: FlowBlock[], measures: Measure[], pmPosition: number): CaretPosition | null;
 /**
  * Check if a selection spans multiple pages.
  *
  * @param rects - Selection rectangles.
  * @returns True if selection spans multiple pages.
  */
-declare function isMultiPageSelection(rects: SelectionRect[]): boolean;
+export declare function isMultiPageSelection(rects: SelectionRect[]): boolean;
 /**
  * Get selection rectangles grouped by page.
  *
  * @param rects - Selection rectangles.
  * @returns Map of page index to rectangles on that page.
  */
-declare function groupRectsByPage(rects: SelectionRect[]): Map<number, SelectionRect[]>;
-//#endregion
-export { CaretPosition, SelectionRect, getCaretPosition, groupRectsByPage, isMultiPageSelection, selectionToRects };
+export declare function groupRectsByPage(rects: SelectionRect[]): Map<number, SelectionRect[]>;
+//#endregion

package/dist/layout-bridge/engine/selectionRects.js

@@ -1,15 +1,17 @@
 import { measuredLineContentOffset } from "../../layout-engine/lineFlow.js";
-import { buildRunFontStyle } from "../../layout-engine/measure/measureHelpers.js";
+import { automaticRunGap } from "../../layout-engine/measure/automaticTextSpacing.js";
+import { DEFAULT_FONT_FAMILY, buildRunFontStyle } from "../../layout-engine/measure/measureHelpers.js";
 import { measureParagraph } from "../../layout-engine/measure/measureParagraph.js";
-import { measureRun } from "../../layout-engine/measure/measureProvider.js";
+import { measurePositionedRun } from "../../layout-engine/measure/measureProvider.js";
 import { buildTableCellFloatingZones, getTableCellContentWidth, getTableCellFloatingImages } from "../../layout-engine/measure/tableCellFloating.js";
 import { buildTableCellGrid, buildTableCellPlacements, getTableCellSpacingInsetsY } from "../../layout-engine/measure/tableCellGrid.js";
 import { getHeaderRowsHeight } from "../../layout-engine/tableLayout.js";
 import { resolveTableCellPadding } from "../../layout-engine/types.js";
 import { normalizeHorizontalScalePercent } from "../../utils/horizontalScale.js";
-import { resolvePhysicalParagraphInlineLayout } from "../../utils/paragraphInlineLayout.js";
+import { resolveParagraphLineGeometryForBlock, resolvePhysicalParagraphInlineLayout } from "../../utils/paragraphInlineLayout.js";
 import { inlineImageBoundingBox } from "../../utils/rotationBoundingBox.js";
 import { getPageTop } from "./hitTest.js";
+import { computeLinePmRange } from "./linePmRange.js";
 //#region src/layout-bridge/engine/selectionRects.ts
 /**
 * Selection Rectangles
@@ -31,7 +33,7 @@ const EMPTY_PARAGRAPH_SLIVER_WIDTH = 4;
 * Extract FontStyle from a run for measurement.
 */
 function runToFontStyle(run) {
-	return buildRunFontStyle(run, "Arial", 12);
+	return buildRunFontStyle(run, DEFAULT_FONT_FAMILY, 11);
 }
 function mathRunToFontStyle(run) {
 	const horizontalScale = normalizeHorizontalScalePercent(run.horizontalScale);
@@ -71,56 +73,6 @@ function clampToRunPmEnd(run, position) {
 	return run.pmEnd === void 0 ? position : Math.min(position, run.pmEnd);
 }
 /**
-* Calculate the PM range for a line.
-* Note: ProseMirror positions include node boundaries:
-* - blockPmStart is the position of the paragraph node itself
-* - The actual text content starts at blockPmStart + 1 (after the opening tag)
-*
-* Prefers the runs' own PM metadata over cumulative character counting:
-* template-preview value runs carry the source marker's PM range with a
-* different text length, so the one-PM-position-per-character assumption
-* the char-counting fallback makes does not hold for them.
-*/
-function computeLinePmRange(block, line) {
-	const fromRun = block.runs[line.fromRun];
-	const toRun = block.runs[line.toRun];
-	if (fromRun?.pmStart !== void 0 && toRun?.pmStart !== void 0) return {
-		pmStart: fromRun.kind === "text" ? clampToRunPmEnd(fromRun, fromRun.pmStart + line.fromChar) : fromRun.pmStart,
-		pmEnd: toRun.kind === "text" ? clampToRunPmEnd(toRun, toRun.pmStart + line.toChar) : toRun.pmEnd ?? toRun.pmStart + 1
-	};
-	const contentStart = (block.pmStart ?? 0) + 1;
-	let charOffset = 0;
-	let pmStart;
-	for (let runIndex = 0; runIndex < block.runs.length && runIndex <= line.toRun; runIndex++) {
-		const run = block.runs[runIndex];
-		if (!run) continue;
-		if (runIndex < line.fromRun) if (run.kind === "text") charOffset += run.text.length;
-		else charOffset += 1;
-		else if (runIndex === line.fromRun) {
-			charOffset += line.fromChar;
-			pmStart = contentStart + charOffset;
-			break;
-		}
-	}
-	if (pmStart === void 0) pmStart = contentStart;
-	let lineLength = 0;
-	for (let runIndex = line.fromRun; runIndex <= line.toRun && runIndex < block.runs.length; runIndex++) {
-		const run = block.runs[runIndex];
-		if (!run) continue;
-		if (run.kind === "text") {
-			const text = run.text;
-			const start = runIndex === line.fromRun ? line.fromChar : 0;
-			const end = runIndex === line.toRun ? line.toChar : text.length;
-			lineLength += end - start;
-		} else lineLength += 1;
-	}
-	const pmEnd = pmStart + lineLength;
-	return {
-		pmStart,
-		pmEnd
-	};
-}
-/**
 * Find lines in a paragraph that intersect with a PM range.
 */
 function findLinesInRange(block, measure, from, to) {
@@ -206,7 +158,10 @@ function charOffsetToX(block, line, charOffset, _availableWidth) {
 			continue;
 		}
 		if (run.kind === "math") {
-			const mathWidth = measureRun(run.plainText, mathRunToFontStyle(run)).width;
+			const mathWidth = measurePositionedRun({
+				text: run.plainText,
+				style: mathRunToFontStyle(run)
+			}).width;
 			if (charsProcessed + 1 >= charOffset) {
 				if (charOffset <= charsProcessed) return x;
 				return x + mathWidth;
@@ -222,13 +177,18 @@ function charOffsetToX(block, line, charOffset, _availableWidth) {
 			const start = isFirstRun ? line.fromChar : 0;
 			const end = isLastRun ? line.toChar : text.length;
 			const lineText = text.slice(start, end);
+			const next = runIndex < line.toRun && !(runIndex + 1 === line.toRun && line.toChar === 0) ? block.runs[runIndex + 1] : void 0;
+			const measurement = measurePositionedRun({
+				text: lineText,
+				style: runToFontStyle(run),
+				trailingAutomaticSpacingPx: automaticRunGap(run, next)
+			});
 			if (charsProcessed + lineText.length >= charOffset) {
 				const charInRun = charOffset - charsProcessed;
-				const style = runToFontStyle(run);
-				const measurement = measureRun(lineText.slice(0, charInRun), style);
-				return x + measurement.width;
+				let prefix = 0;
+				for (let index = 0; index < charInRun; index += 1) prefix += measurement.charWidths[index] ?? 0;
+				return x + prefix;
 			}
-			const measurement = measureRun(lineText, runToFontStyle(run));
 			x += measurement.width;
 			charsProcessed += lineText.length;
 		}
@@ -265,7 +225,7 @@ function selectionToRects(layout, blocks, measures, from, to) {
 				const paragraphBlock = block;
 				const paragraphMeasure = measure;
 				const paragraphFragment = fragment;
-				const { alignment, indentLeft, indentRight } = resolvePhysicalParagraphInlineLayout(paragraphBlock);
+				const { indentLeft, indentRight } = resolvePhysicalParagraphInlineLayout(paragraphBlock);
 				const availableWidth = Math.max(0, fragment.width - indentLeft - indentRight);
 				const intersectingLines = findLinesInRange(paragraphBlock, paragraphMeasure, selFrom, selTo);
 				for (const { line, index } of intersectingLines) {
@@ -281,11 +241,14 @@ function selectionToRects(layout, blocks, measures, from, to) {
 					const charOffsetTo = pmPosToCharOffset(paragraphBlock, line, sliceTo);
 					const startX = charOffsetToX(paragraphBlock, line, charOffsetFrom, availableWidth);
 					const endX = charOffsetToX(paragraphBlock, line, charOffsetTo, availableWidth);
-					let alignmentOffset = 0;
-					if (alignment === "center") alignmentOffset = Math.max(0, (availableWidth - line.width) / 2);
-					else if (alignment === "right") alignmentOffset = Math.max(0, availableWidth - line.width);
 					const lineOffset = measuredLineContentOffset(paragraphMeasure.lines, paragraphFragment.fromLine, index);
-					const rectX = fragment.x + indentLeft + alignmentOffset + Math.min(startX, endX);
+					const rectX = resolveParagraphLineGeometryForBlock({
+						fragment: paragraphFragment,
+						block: paragraphBlock,
+						line,
+						lineTopYPx: fragment.y + lineOffset,
+						isFirstLine: index === 0 && !paragraphFragment.continuesFromPrev
+					}).paintStartXPx + Math.min(startX, endX);
 					const rectWidth = isEmptyLine ? EMPTY_PARAGRAPH_SLIVER_WIDTH : Math.max(1, Math.abs(endX - startX));
 					const rectY = fragment.y + lineOffset;
 					rects.push({
@@ -309,8 +272,9 @@ function selectionToRects(layout, blocks, measures, from, to) {
 				const tableFragment = fragment;
 				let cellPlacements = tableCellPlacements.get(tableBlock);
 				if (!cellPlacements) {
+					const cellGrid = buildTableCellGrid(tableBlock.rows, tableMeasure.columnWidths.length);
 					cellPlacements = buildTableCellPlacements({
-						grid: buildTableCellGrid(tableBlock.rows, tableMeasure.columnWidths.length),
+						grid: cellGrid,
 						columnWidths: tableMeasure.columnWidths,
 						bidi: tableBlock.bidi === true,
 						cellSpacing: tableBlock.cellSpacing
@@ -332,7 +296,8 @@ function selectionToRects(layout, blocks, measures, from, to) {
 						const placement = cellPlacements.get(cell);
 						if (!placement) continue;
 						const contentWidth = getTableCellContentWidth(cell, cellMeasure);
-						const floatingZones = buildTableCellFloatingZones(getTableCellFloatingImages(cell, cellMeasure, contentWidth), contentWidth);
+						const floatingImages = getTableCellFloatingImages(cell, cellMeasure, contentWidth);
+						const floatingZones = buildTableCellFloatingZones(floatingImages, contentWidth);
 						const contentOffsetX = getCellContentOffsetX(cell);
 						const spacing = getTableCellSpacingInsetsY(tableBlock.cellSpacing, rowIndex, cell.rowSpan ?? 1, tableBlock.rows.length);
 						const contentOffsetY = spacing.top + getCellContentOffsetY(cell, cellMeasure, Math.max(0, rowMeasure.height - spacing.top - spacing.bottom));
@@ -354,7 +319,7 @@ function selectionToRects(layout, blocks, measures, from, to) {
 								floatingZones,
 								paragraphYOffset: blockY
 							});
-							const { alignment, indentLeft, indentRight } = resolvePhysicalParagraphInlineLayout(paragraphBlock);
+							const { indentLeft, indentRight } = resolvePhysicalParagraphInlineLayout(paragraphBlock);
 							const availableWidth = Math.max(0, contentWidth - indentLeft - indentRight);
 							const intersectingLines = findLinesInRange(paragraphBlock, paragraphMeasure, selFrom, selTo);
 							for (const { line, index } of intersectingLines) {
@@ -369,14 +334,21 @@ function selectionToRects(layout, blocks, measures, from, to) {
 								const charOffsetTo = pmPosToCharOffset(paragraphBlock, line, sliceTo);
 								const startX = charOffsetToX(paragraphBlock, line, charOffsetFrom, availableWidth);
 								const endX = charOffsetToX(paragraphBlock, line, charOffsetTo, availableWidth);
-								let alignmentOffset = 0;
-								if (alignment === "center") alignmentOffset = Math.max(0, (availableWidth - line.width) / 2);
-								else if (alignment === "right") alignmentOffset = Math.max(0, availableWidth - line.width);
 								const lineY = measuredLineContentOffset(paragraphMeasure.lines, 0, index);
+								const lineGeometry = resolveParagraphLineGeometryForBlock({
+									fragment: {
+										x: tableFragment.x + placement.left + contentOffsetX,
+										width: contentWidth
+									},
+									block: paragraphBlock,
+									line,
+									lineTopYPx: tableFragment.y + rowY + contentOffsetY + blockY + lineY,
+									isFirstLine: index === 0
+								});
 								const clippedLineY = contentOffsetY + blockY + lineY;
 								if (clippedLineY + line.lineHeight <= clipTop || clippedLineY >= clipBottom) continue;
 								rects.push({
-									x: tableFragment.x + placement.left + contentOffsetX + indentLeft + alignmentOffset + Math.min(startX, endX),
+									x: lineGeometry.paintStartXPx + Math.min(startX, endX),
 									y: tableFragment.y + rowY + clippedLineY - clipTop + pageTopY,
 									width: isEmptyLine ? EMPTY_PARAGRAPH_SLIVER_WIDTH : Math.max(1, Math.abs(endX - startX)),
 									height: line.lineHeight,
@@ -437,15 +409,19 @@ function getCaretPosition(layout, blocks, measures, pmPosition) {
 					if (range.pmStart === void 0 || range.pmEnd === void 0) continue;
 					if (pmPosition >= range.pmStart && pmPosition <= range.pmEnd) {
 						const charOffset = pmPosToCharOffset(paragraphBlock, line, pmPosition);
-						const { alignment, indentLeft, indentRight } = resolvePhysicalParagraphInlineLayout(paragraphBlock);
+						const { indentLeft, indentRight } = resolvePhysicalParagraphInlineLayout(paragraphBlock);
 						const availableWidth = Math.max(0, fragment.width - indentLeft - indentRight);
-						const x = charOffsetToX(paragraphBlock, line, charOffset, availableWidth);
-						let alignmentOffset = 0;
-						if (alignment === "center") alignmentOffset = Math.max(0, (availableWidth - line.width) / 2);
-						else if (alignment === "right") alignmentOffset = Math.max(0, availableWidth - line.width);
 						const lineOffset = measuredLineContentOffset(paragraphMeasure.lines, paragraphFragment.fromLine, lineIndex);
+						const lineGeometry = resolveParagraphLineGeometryForBlock({
+							fragment: paragraphFragment,
+							block: paragraphBlock,
+							line,
+							lineTopYPx: fragment.y + lineOffset,
+							isFirstLine: lineIndex === 0 && !paragraphFragment.continuesFromPrev
+						});
+						const x = charOffsetToX(paragraphBlock, line, charOffset, availableWidth);
 						return {
-							x: fragment.x + indentLeft + alignmentOffset + x,
+							x: lineGeometry.paintStartXPx + x,
 							y: fragment.y + lineOffset + pageTopY,
 							height: line.lineHeight,
 							pageIndex

package/dist/layout-bridge/headerFooterLayout.d.ts

@@ -8,7 +8,7 @@ import { EditorView } from "prosemirror-view";
  *
  * @public
  */
-declare function invalidateHfDomCache(): void;
+export declare function invalidateHfDomCache(): void;
 /**
  * Viewport-relative caret rect for a persistent HF EditorView's selection
  * head. Resolves against the painter's `data-pm-start`/`data-pm-end` spans
@@ -22,7 +22,7 @@ declare function invalidateHfDomCache(): void;
  *
  * @public
  */
-declare function computeHfCaretRectFromView(view: EditorView, section: "header" | "footer", doc?: globalThis.Document): {
+export declare function computeHfCaretRectFromView(view: EditorView, section: "header" | "footer", doc?: globalThis.Document): {
   top: number;
   left: number;
   height: number;
@@ -39,11 +39,10 @@ declare function computeHfCaretRectFromView(view: EditorView, section: "header"
  *
  * @public
  */
-declare function computeHfSelectionRectsFromView(view: EditorView, section: "header" | "footer", doc?: globalThis.Document): Array<{
+export declare function computeHfSelectionRectsFromView(view: EditorView, section: "header" | "footer", doc?: globalThis.Document): Array<{
   top: number;
   left: number;
   width: number;
   height: number;
 }>;
-//#endregion
-export { computeHfCaretRectFromView, computeHfSelectionRectsFromView, invalidateHfDomCache };
+//#endregion

package/dist/layout-bridge/measuring/measureBlocksPipeline.d.ts

@@ -19,7 +19,7 @@
  *
  * @public
  */
-type FloatPageGeometry = {
+export type FloatPageGeometry = {
   pageWidth: number;
   pageHeight: number;
   marginLeft: number;
@@ -29,5 +29,4 @@ type FloatPageGeometry = {
   contentWidth: number;
   contentHeight: number;
 };
-//#endregion
-export { FloatPageGeometry };
+//#endregion

package/dist/layout-bridge/sectionColumns.d.ts

@@ -5,6 +5,5 @@ import { ColumnLayout } from "../layout-engine/types.js";
  * Extract column layout from section properties.
  * Returns undefined for single-column (default) to avoid unnecessary paginator overhead.
  */
-declare function getColumns(sectionProps: document_d_exports.SectionProperties | null | undefined): ColumnLayout | undefined;
-//#endregion
-export { getColumns };
+export declare function getColumns(sectionProps: document_d_exports.SectionProperties | null | undefined): ColumnLayout | undefined;
+//#endregion

package/dist/layout-bridge/tableInsertHover.d.ts

@@ -14,9 +14,9 @@
  * @packageDocumentation
  * @public
  */
-declare const TABLE_INSERT_EDGE_PROXIMITY = 30;
-declare const TABLE_INSERT_HIDE_DELAY_MS = 200;
-type TableInsertHoverHit = {
+export declare const TABLE_INSERT_EDGE_PROXIMITY = 30;
+export declare const TABLE_INSERT_HIDE_DELAY_MS = 200;
+export type TableInsertHoverHit = {
   type: "row" | "column";
   /** Client-coordinate anchor for the button. Caller converts to its UI frame. */
   clientX: number;
@@ -24,7 +24,7 @@ type TableInsertHoverHit = {
   /** PM position of the cell the button targets. */
   cellPmPos: number;
 };
-type TableInsertHoverInput = {
+export type TableInsertHoverInput = {
   mouseX: number;
   mouseY: number;
   pagesContainer: HTMLElement;
@@ -41,6 +41,5 @@ type TableInsertHoverInput = {
  * mouse isn't near a row's left edge or a column's top edge — or if the
  * relevant table belongs to an inactive HF/body region.
  */
-declare function detectTableInsertHover(input: TableInsertHoverInput): TableInsertHoverHit | null;
-//#endregion
-export { TABLE_INSERT_EDGE_PROXIMITY, TABLE_INSERT_HIDE_DELAY_MS, TableInsertHoverHit, TableInsertHoverInput, detectTableInsertHover };
+export declare function detectTableInsertHover(input: TableInsertHoverInput): TableInsertHoverHit | null;
+//#endregion

package/dist/layout-engine/anchorLayoutInCellCompatibility.d.ts

@@ -5,6 +5,5 @@
  * `layoutInCell="0"`. `false` means the authored attribute (or its
  * OOXML default of "confined to the cell") should be honoured as stated.
  */
-declare const resolveAnchorLayoutInCellCompatibility: (compatibilityMode: number | undefined) => boolean;
-//#endregion
-export { resolveAnchorLayoutInCellCompatibility };
+export declare const resolveAnchorLayoutInCellCompatibility: (compatibilityMode: number | undefined) => boolean;
+//#endregion

package/dist/layout-engine/footnoteColumnReflow.d.ts

@@ -10,6 +10,6 @@ type ReflowFootnoteColumnsOptions = {
  * Reserve floors follow the current page-to-footnote assignment. Repeated floor states
  * and persistent overlap use a stable fallback layout instead of throwing.
  */
-declare function reflowFootnoteColumns({ initialLayout, initialReserveFloors, runLayout }: ReflowFootnoteColumnsOptions): Layout;
+export declare function reflowFootnoteColumns({ initialLayout, initialReserveFloors, runLayout }: ReflowFootnoteColumnsOptions): Layout;
 //#endregion
-export { reflowFootnoteColumns };
+export {};

package/dist/layout-engine/headerFooterRefs.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { PageHeaderFooterRefs } from "./types.js";
 //#region src/layout-engine/headerFooterRefs.d.ts
-declare const resolveSectionHeaderFooterRefs: (documentModel: document_d_exports.Document | null | undefined) => PageHeaderFooterRefs[] | undefined;
-//#endregion
-export { resolveSectionHeaderFooterRefs };
+export declare const resolveSectionHeaderFooterRefs: (documentModel: document_d_exports.Document | null | undefined) => PageHeaderFooterRefs[] | undefined;
+//#endregion

package/dist/layout-engine/imageLayout.d.ts

@@ -4,6 +4,5 @@ import { createPaginator } from "./paginator.js";
 /**
  * Layout an image block onto pages.
  */
-declare function layoutImage(block: ImageBlock, measure: ImageMeasure, paginator: ReturnType<typeof createPaginator>): void;
-//#endregion
-export { layoutImage };
+export declare function layoutImage(block: ImageBlock, measure: ImageMeasure, paginator: ReturnType<typeof createPaginator>): void;
+//#endregion

package/dist/layout-engine/index.d.ts

@@ -17,7 +17,7 @@ import { getHeaderRowsHeight } from "./tableLayout.js";
  *
  * This mutates the block attrs in-place before layout runs.
  */
-declare function applyContextualSpacing(blocks: FlowBlock[]): void;
+export declare function applyContextualSpacing(blocks: FlowBlock[]): void;
 /**
  * Layout a document: convert blocks + measures into pages with positioned fragments.
  *
@@ -25,6 +25,6 @@ declare function applyContextualSpacing(blocks: FlowBlock[]): void;
  * shared body band below earlier-column fragments. Retry those documents with the observed
  * reservations as page floors so every column participates in the same footnote geometry.
  */
-declare function layoutDocument(blocks: FlowBlock[], measures: Measure[], options: LayoutOptions): Layout;
+export declare function layoutDocument(blocks: FlowBlock[], measures: Measure[], options: LayoutOptions): Layout;
 //#endregion
-export { BlockId, BorderStyle, type BreakDecision, CellBorderSpec, CellBorders, ColumnBreakBlock, ColumnBreakMeasure, ColumnLayout, DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, DocumentPosition, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, FieldRun, FloatingTablePosition, FlowBlock, FootnoteContent, Fragment, FragmentBase, HeaderFooterContent, HeaderFooterContentHeights, HeaderFooterLayout, HitTestResult, HyperlinkInfo, ImageBlock, ImageFragment, ImageMeasure, ImageRun, ImageRunPosition, type KeepNextChain, Layout, LayoutOptions, LineBreakRun, ListMarkerFormatting, MathRun, Measure, MeasuredLine, NOTE_SEPARATOR_RULE_THICKNESS, NOTE_SEPARATOR_WIDTH_FRACTION, NoteAreaLayout, NoteSeparatorKind, NoteSeparatorRule, Page, PageBreakBlock, PageBreakMeasure, PageHeaderFooterRefs, PageMargins, type PageState, type Paginator, type PaginatorOptions, ParagraphAttrs, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphIndent, ParagraphMeasure, ParagraphSpacing, RenderedPageBreakRun, Run, RunFormatting, SdtGroup, SectionBreakBlock, SectionBreakMeasure, type SectionLayoutConfig, SectionPageNumbering, type SectionState, TabAlignment, TabRun, TabStop, TableBlock, TableCell, TableCellMeasure, TableFragment, TableMeasure, TableRow, TableRowMeasure, TextBoxBlock, TextBoxFlowAttrs, TextBoxFragment, TextBoxGradientFill, TextBoxMeasure, TextRun, applyContextualSpacing, applyPendingToActive, assertExhaustiveFlowBlock, calculateChainHeight, collectSectionConfigs, computeKeepNextChains, createInitialSectionState, createPaginator, findPageIndexContainingPmPos, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getEffectiveColumns, getEffectiveMargins, getEffectivePageSize, getHeaderRowsHeight, getMidChainIndices, getTableRowLeadingWidth, hasKeepLines, hasPageBreakBefore, isFloatingImageRun, isFloatingTextBoxBlock, isListNumPr, isTextWrappingFloatingImageRun, layoutDocument, resolveSectionHeaderFooterRefs, resolveTableCellPadding, resolveTableWidthPx, scheduleSectionBreak, stripFlowBlockPmAnchors, tableColumnsArePinned };
+export { BlockId, BorderStyle, type BreakDecision, CellBorderSpec, CellBorders, ColumnBreakBlock, ColumnBreakMeasure, ColumnLayout, DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, DocumentPosition, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, FieldRun, FloatingTablePosition, FlowBlock, FootnoteContent, Fragment, FragmentBase, HeaderFooterContent, HeaderFooterContentHeights, HeaderFooterLayout, HitTestResult, HyperlinkInfo, ImageBlock, ImageFragment, ImageMeasure, ImageRun, ImageRunPosition, type KeepNextChain, Layout, LayoutOptions, LineBreakRun, ListMarkerFormatting, MathRun, Measure, MeasuredLine, NOTE_SEPARATOR_RULE_THICKNESS, NOTE_SEPARATOR_WIDTH_FRACTION, NoteAreaLayout, NoteSeparatorKind, NoteSeparatorRule, Page, PageBreakBlock, PageBreakMeasure, PageHeaderFooterRefs, PageMargins, type PageState, type Paginator, type PaginatorOptions, ParagraphAttrs, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphIndent, ParagraphMeasure, ParagraphSpacing, RenderedPageBreakRun, Run, RunFormatting, SdtGroup, SectionBreakBlock, SectionBreakMeasure, type SectionLayoutConfig, SectionPageNumbering, type SectionState, TabAlignment, TabRun, TabStop, TableBlock, TableCell, TableCellMeasure, TableFragment, TableMeasure, TableRow, TableRowMeasure, TextBoxBlock, TextBoxFlowAttrs, TextBoxFragment, TextBoxGradientFill, TextBoxMeasure, TextRun, applyPendingToActive, assertExhaustiveFlowBlock, calculateChainHeight, collectSectionConfigs, computeKeepNextChains, createInitialSectionState, createPaginator, findPageIndexContainingPmPos, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getEffectiveColumns, getEffectiveMargins, getEffectivePageSize, getHeaderRowsHeight, getMidChainIndices, getTableRowLeadingWidth, hasKeepLines, hasPageBreakBefore, isFloatingImageRun, isFloatingTextBoxBlock, isListNumPr, isTextWrappingFloatingImageRun, resolveSectionHeaderFooterRefs, resolveTableCellPadding, resolveTableWidthPx, scheduleSectionBreak, stripFlowBlockPmAnchors, tableColumnsArePinned };

package/dist/layout-engine/index.js

@@ -4,7 +4,7 @@ import { layoutImage } from "./imageLayout.js";
 import { calculateChainHeight, computeKeepNextChains, getMidChainIndices, hasKeepLines, hasPageBreakBefore } from "./keep-together.js";
 import "./layoutFlowShared.js";
 import { measuredLineAdvance } from "./lineFlow.js";
-import { annotateNoteSeparators, continuesNoteArea, createNoteAreaContinuation } from "./noteAreaFlow.js";
+import { annotateNoteAreas, continuesNoteArea, createNoteAreaContinuation } from "./noteAreaFlow.js";
 import { createPaginator } from "./paginator.js";
 import { layoutParagraph } from "./paragraphLayout.js";
 import { paragraphsShareStyle, resolveEffectiveParagraphSpacingTree } from "./paragraphSpacing.js";
@@ -63,14 +63,15 @@ function applyContextualSpacing(blocks) {
 */
 function layoutDocument(blocks, measures, options) {
 	const initialLayout = layoutDocumentPass(blocks, measures, options);
-	return annotateNoteSeparators(applySectionVerticalAlignment(options.footnoteHeightById ? reflowFootnoteColumns({
+	const layout = options.footnoteHeightById ? reflowFootnoteColumns({
 		initialLayout,
 		...options.footnoteReservedHeights ? { initialReserveFloors: options.footnoteReservedHeights } : {},
 		runLayout: (reserveFloors) => layoutDocumentPass(blocks, measures, {
 			...options,
 			footnoteReservedHeights: reserveFloors
 		})
-	}) : initialLayout, options.sectionVerticalAlignments), blocks, measures, options.noteAreas);
+	}) : initialLayout;
+	return annotateNoteAreas(applySectionVerticalAlignment(layout, options.sectionVerticalAlignments), blocks, measures, options.noteAreas);
 }
 function layoutDocumentPass(blocks, measures, options) {
 	if (blocks.length !== measures.length) panic(`layoutDocument: expected one measure per block (blocks=${blocks.length}, measures=${measures.length})`);
@@ -156,6 +157,8 @@ function layoutDocumentPass(blocks, measures, options) {
 			if (paginator.getCurrentState().page.number > pageBeforeChainLayout) renderedBreakState = recordReflowBoundary(renderedBreakState, true);
 		}
 		const pageBeforeBlockLayout = paginator.getCurrentState().page.number;
+		const stateBeforeBlockLayout = paginator.getCurrentState();
+		const suppressDocumentStartAutomaticSpaceBefore = i === 0 && block.kind === "paragraph" && block.attrs?.automaticSpacing?.before === true && stateBeforeBlockLayout.page.number === 1 && stateBeforeBlockLayout.topMargin === initialConfig.margins.top && stateBeforeBlockLayout.cursorY === stateBeforeBlockLayout.topMargin;
 		switch (block.kind) {
 			case "paragraph":
 				layoutParagraph({
@@ -164,7 +167,7 @@ function layoutDocumentPass(blocks, measures, options) {
 					paginator,
 					contentWidth: paginator.columnWidth,
 					footnoteHeightById: options.footnoteHeightById,
-					suppressSpaceBefore: breakDecision.suppressSpaceBefore
+					suppressSpaceBefore: breakDecision.suppressSpaceBefore || suppressDocumentStartAutomaticSpaceBefore
 				});
 				break;
 			case "table":
@@ -191,12 +194,13 @@ function layoutDocumentPass(blocks, measures, options) {
 				break;
 			case "sectionBreak": {
 				const nextSectionConfig = sectionConfigs[sectionIdx + 1] ?? initialConfig;
-				handleSectionBreak(block, paginator, nextSectionConfig, normalizeSectionBreakType(sectionBreakTypes[sectionIdx]), sectionIdx + 1);
+				const nextType = normalizeSectionBreakType(sectionBreakTypes[sectionIdx]);
+				handleSectionBreak(block, paginator, nextSectionConfig, nextType, sectionIdx + 1);
 				const nextColumns = nextSectionConfig.columns;
 				const nextBreakIndex = breakIndices[sectionIdx + 1] ?? blocks.length;
 				const nextBreak = blocks[nextBreakIndex];
 				const sectionEndsContinuously = nextBreakIndex === blocks.length || nextBreak?.kind === "sectionBreak" && nextBreak.type === "continuous";
-				if (nextColumns && sectionEndsContinuously) {
+				if (nextColumns && sectionEndsContinuously && options.columnBalancing !== "natural") {
 					const state = paginator.getCurrentState();
 					const balancedHeight = balancedParagraphSectionHeight({
 						blocks,
@@ -215,7 +219,6 @@ function layoutDocumentPass(blocks, measures, options) {
 				sectionIdx++;
 				break;
 			}
-			default: break;
 		}
 		renderedBreakState = reconcileAfterBlock({
 			state: renderedBreakState,

package/dist/layout-engine/justificationCompatibility.d.ts

@@ -1,5 +1,4 @@
 import { ParagraphAttrs } from "./types.js";
 //#region src/layout-engine/justificationCompatibility.d.ts
-declare const resolveJustificationCompatibility: (compatibilityMode: number | undefined) => NonNullable<ParagraphAttrs["justificationCompatibility"]> | undefined;
-//#endregion
-export { resolveJustificationCompatibility };
+export declare const resolveJustificationCompatibility: (compatibilityMode: number | undefined) => NonNullable<ParagraphAttrs["justificationCompatibility"]> | undefined;
+//#endregion

package/dist/layout-engine/keep-together.d.ts

@@ -5,7 +5,7 @@ import { FlowBlock, Measure, TableBlock, TableMeasure } from "./types.js";
  * explicit keepNext links and a trailing table separator that would otherwise
  * be stranded at the bottom of a page.
  */
-type KeepNextChain = {
+export type KeepNextChain = {
   /** Index of the first paragraph in the chain. */
   startIndex: number;
   /** Index of the last keepNext or pass-through empty member. */
@@ -25,7 +25,7 @@ type KeepNextChain = {
  *
  * Returns a map from chain start index to chain info.
  */
-declare function computeKeepNextChains(blocks: FlowBlock[]): Map<number, KeepNextChain>;
+export declare function computeKeepNextChains(blocks: FlowBlock[]): Map<number, KeepNextChain>;
 /**
  * Calculate the height needed to keep consecutive paragraph boundaries from
  * breaking across pages.
@@ -44,19 +44,18 @@ declare function computeKeepNextChains(blocks: FlowBlock[]): Map<number, KeepNex
  * the larger side, as the paginator does), so members contribute only their
  * line advances; otherwise every gap would be reserved twice.
  */
-declare function calculateChainHeight(chain: KeepNextChain, blocks: FlowBlock[], measures: Measure[], incomingSpacing?: number, tableOpeningHeight?: (block: TableBlock, measure: TableMeasure) => number): number;
+export declare function calculateChainHeight(chain: KeepNextChain, blocks: FlowBlock[], measures: Measure[], incomingSpacing?: number, tableOpeningHeight?: (block: TableBlock, measure: TableMeasure) => number): number;
 /**
  * Get the set of indices that are mid-chain (not chain starters).
  * These should skip the keepNext check since their chain starter already decided.
  */
-declare function getMidChainIndices(chains: Map<number, KeepNextChain>): Set<number>;
+export declare function getMidChainIndices(chains: Map<number, KeepNextChain>): Set<number>;
 /**
  * Check if a paragraph has keepLines property (all lines must stay together).
  */
-declare function hasKeepLines(block: FlowBlock): boolean;
+export declare function hasKeepLines(block: FlowBlock): boolean;
 /**
  * Check if a paragraph should start on a new page (pageBreakBefore).
  */
-declare function hasPageBreakBefore(block: FlowBlock): boolean;
-//#endregion
-export { KeepNextChain, calculateChainHeight, computeKeepNextChains, getMidChainIndices, hasKeepLines, hasPageBreakBefore };
+export declare function hasPageBreakBefore(block: FlowBlock): boolean;
+//#endregion

package/dist/layout-engine/keep-together.js

@@ -89,7 +89,7 @@ function computeKeepNextChains(blocks) {
 function minimumOpeningLineCount(block, measure) {
 	const lineCount = measure.lines.length;
 	if (block.attrs?.keepLines === true) return lineCount;
-	if (block.attrs?.widowControl !== false) return lineCount < MIN_WIDOW_CONTROL_SPLIT_LINES * 2 ? lineCount : MIN_WIDOW_CONTROL_SPLIT_LINES;
+	if (block.attrs?.widowControl !== false) return lineCount < 4 ? lineCount : MIN_WIDOW_CONTROL_SPLIT_LINES;
 	return Math.min(1, lineCount);
 }
 /**

package/dist/layout-engine/layoutFlowShared.d.ts

@@ -1,6 +1,5 @@
 import { PageState } from "./paginator.js";
 //#region src/layout-engine/layoutFlowShared.d.ts
-declare const RENDERED_BREAK_REFLOW_TOLERANCE_LINES = 3;
-declare function projectedFootnoteReserveGrowth(state: PageState, additionalDemandHeight: number): number;
-//#endregion
-export { RENDERED_BREAK_REFLOW_TOLERANCE_LINES, projectedFootnoteReserveGrowth };
+export declare const RENDERED_BREAK_REFLOW_TOLERANCE_LINES = 3;
+export declare function projectedFootnoteReserveGrowth(state: PageState, additionalDemandHeight: number): number;
+//#endregion

package/dist/layout-engine/layoutInstrumentation.d.ts

@@ -1,11 +1,11 @@
 import { FlowBlock } from "./types.js";
 //#region src/layout-engine/layoutInstrumentation.d.ts
-type LayoutRunReason = "font-ready" | "hyphenation-ready" | "initial" | "layout-input" | "manual" | "transaction";
-type LayoutPhase = "flow-blocks" | "header-footer" | "initial-fonts" | "layout-document" | "measure-blocks" | "render-pages";
-type HiddenEditorStateReason = "external-document" | "mount";
-type HiddenEditorPhase = "editor-state" | "editor-view" | "to-prose-doc" | "update-state";
-type DocumentLoadPhase = "docx-parse";
-type LayoutInstrumentation = {
+export type LayoutRunReason = "font-ready" | "hyphenation-ready" | "initial" | "layout-input" | "manual" | "transaction";
+export type LayoutPhase = "flow-blocks" | "header-footer" | "initial-fonts" | "layout-document" | "measure-blocks" | "render-pages";
+export type HiddenEditorStateReason = "external-document" | "mount";
+export type HiddenEditorPhase = "editor-state" | "editor-view" | "to-prose-doc" | "update-state";
+export type DocumentLoadPhase = "docx-parse";
+export type LayoutInstrumentation = {
   onDocumentLoadPhase?: (event: {
     durationMs: number;
     phase: DocumentLoadPhase;
@@ -57,17 +57,16 @@ type LayoutInstrumentation = {
 declare global {
   var __folioLayoutInstrumentation: LayoutInstrumentation | undefined;
 }
-declare function recordMeasureBlock(blockIndex: number, block: FlowBlock): void;
-declare function recordMeasureBlockError(blockIndex: number, block: FlowBlock, error: unknown): void;
-declare function recordLayoutComplete(reason?: LayoutRunReason): void;
-declare function recordLayoutStart(reason: LayoutRunReason): void;
-declare function recordLayoutError(reason: LayoutRunReason, error: unknown): void;
-declare function recordMarkupViewIncomplete(view: string): void;
+export declare function recordMeasureBlock(blockIndex: number, block: FlowBlock): void;
+export declare function recordMeasureBlockError(blockIndex: number, block: FlowBlock, error: unknown): void;
+export declare function recordLayoutComplete(reason?: LayoutRunReason): void;
+export declare function recordLayoutStart(reason: LayoutRunReason): void;
+export declare function recordLayoutError(reason: LayoutRunReason, error: unknown): void;
+export declare function recordMarkupViewIncomplete(view: string): void;
 /** A dictionary failed to load; layout continues without hyphenating that language. */
-declare function recordHyphenationDictionaryError(dictionary: string, error: Error): void;
-declare function recordLayoutPhase(reason: LayoutRunReason, phase: LayoutPhase, durationMs: number): void;
-declare function recordHiddenEditorStateCreate(reason: HiddenEditorStateReason): void;
-declare function recordHiddenEditorPhase(reason: HiddenEditorStateReason, phase: HiddenEditorPhase, durationMs: number): void;
-declare function recordDocumentLoadPhase(phase: DocumentLoadPhase, durationMs: number): void;
-//#endregion
-export { DocumentLoadPhase, HiddenEditorPhase, HiddenEditorStateReason, LayoutInstrumentation, LayoutPhase, LayoutRunReason, recordDocumentLoadPhase, recordHiddenEditorPhase, recordHiddenEditorStateCreate, recordHyphenationDictionaryError, recordLayoutComplete, recordLayoutError, recordLayoutPhase, recordLayoutStart, recordMarkupViewIncomplete, recordMeasureBlock, recordMeasureBlockError };
+export declare function recordHyphenationDictionaryError(dictionary: string, error: Error): void;
+export declare function recordLayoutPhase(reason: LayoutRunReason, phase: LayoutPhase, durationMs: number): void;
+export declare function recordHiddenEditorStateCreate(reason: HiddenEditorStateReason): void;
+export declare function recordHiddenEditorPhase(reason: HiddenEditorStateReason, phase: HiddenEditorPhase, durationMs: number): void;
+export declare function recordDocumentLoadPhase(phase: DocumentLoadPhase, durationMs: number): void;
+//#endregion