@stll/folio-core 0.7.0 → 0.8.0

package/dist/layout-bridge/convert/headerFooterLayout.js

@@ -16,6 +16,10 @@ function hasAuthoredVisualContent(block) {
 	if (attrs.spacingExplicit?.before || attrs.spacingExplicit?.after) return true;
 	return false;
 }
+function preservesInheritedSpacing(block) {
+	if (!isVisuallyEmptyParagraph(block)) return false;
+	return block.attrs?.styleId !== void 0 || block.attrs?.hasDirectParagraphFormatting === true || block.attrs?.hasDirectParagraphMarkFormatting === true;
+}
 function normalizeHeaderFooterMeasureBlocks(blocks, section = "header") {
 	return normalizeFlowBlockArray(blocks, { suppressTrailingEmptyAfterTable: section === "header" });
 }
@@ -33,8 +37,9 @@ function normalizeFlowBlockArray(blocks, normalization) {
 		const explicit = block.attrs?.spacingExplicit;
 		const hasResolvedBefore = block.attrs?.spacing?.before != null;
 		const hasResolvedAfter = block.attrs?.spacing?.after != null;
-		const beforeIsInherited = hasResolvedBefore && !explicit?.before;
-		const afterIsInherited = hasResolvedAfter && !explicit?.after;
+		const preserveInherited = preservesInheritedSpacing(block);
+		const beforeIsInherited = hasResolvedBefore && !explicit?.before && !preserveInherited;
+		const afterIsInherited = hasResolvedAfter && !explicit?.after && !preserveInherited;
 		const stripsSpacing = beforeIsInherited || afterIsInherited;
 		const stripsImages = block.runs.some(isAnchoredImageRun);
 		if (!stripsSpacing && !stripsImages && !isTrailingEmpty) return block;
@@ -79,6 +84,10 @@ function isVisuallyEmptyParagraph(block) {
 	if (block.kind !== "paragraph") return false;
 	return block.runs.every((run) => run.kind === "text" && run.text.trim().length === 0);
 }
+function isPaintlessParagraph(block) {
+	if (block.kind !== "paragraph") return false;
+	return block.runs.every((run) => run.kind === "text" && run.text.trim().length === 0 || run.kind === "tab" || run.kind === "lineBreak");
+}
 function normalizeTableBlock(block) {
 	const blockState = { changed: false };
 	const rows = block.rows.map((row) => {
@@ -232,6 +241,10 @@ function calculateHeaderFooterVisualBounds(blocks, measures, flowHeight, metrics
 * these bounds separately describe the in-flow portion for API consumers.
 */
 function calculateHeaderFooterMarginPushBounds(blocks, measures, flowHeight, metrics) {
+	if (blocks.length > 0 && blocks.every((block) => isPaintlessParagraph(block) && !hasAuthoredVisualContent(block))) return {
+		top: 0,
+		bottom: 0
+	};
 	let top = 0;
 	let bottom = 0;
 	let cursorY = 0;
@@ -422,6 +435,7 @@ function serializeParagraphAttrs(attrs) {
 		"listMarker",
 		"listIsBullet",
 		"listMarkerHidden",
+		"listMarkerAlignment",
 		"listMarkerSuffix",
 		"tabs"
 	];

package/dist/layout-bridge/convert/paragraphFrames.d.ts

@@ -0,0 +1,7 @@
+import { BlockId, FlowBlock } from "../../layout-engine/types.js";
+
+//#region src/layout-bridge/convert/paragraphFrames.d.ts
+type BlockIdFactory = () => BlockId;
+declare function groupParagraphFrames(blocks: FlowBlock[], nextBlockId: BlockIdFactory): FlowBlock[];
+//#endregion
+export { groupParagraphFrames };

package/dist/layout-bridge/convert/paragraphFrames.js

@@ -0,0 +1,136 @@
+import { pixelsToEmu } from "../../utils/units.js";
+import { setTextBoxGroupId } from "../../layout-engine/textBoxGroup.js";
+import { getParagraphFrame, markParagraphFrameTextBox } from "../../layout-engine/paragraphFrame.js";
+//#region src/layout-bridge/convert/paragraphFrames.ts
+const FRAME_PROPERTIES = [
+	"width",
+	"height",
+	"hSpace",
+	"vSpace",
+	"hAnchor",
+	"vAnchor",
+	"x",
+	"y",
+	"xAlign",
+	"yAlign",
+	"wrap"
+];
+function framesEqual(left, right) {
+	return FRAME_PROPERTIES.every((property) => left[property] === right[property]);
+}
+function horizontalRelativeTo(anchor) {
+	if (anchor === "page" || anchor === "margin") return anchor;
+	return "column";
+}
+function verticalRelativeTo(anchor) {
+	if (anchor === "page" || anchor === "margin") return anchor;
+	return "paragraph";
+}
+function framePosition(frame) {
+	const horizontal = frame.x !== void 0 || frame.xAlign !== void 0 || frame.hAnchor !== void 0 ? {
+		relativeTo: horizontalRelativeTo(frame.hAnchor),
+		...frame.x !== void 0 ? { posOffset: pixelsToEmu(frame.x) } : {},
+		...frame.xAlign !== void 0 ? { align: frame.xAlign } : {}
+	} : void 0;
+	const verticalAlign = frame.yAlign === "inline" ? void 0 : frame.yAlign;
+	const vertical = frame.y !== void 0 || verticalAlign !== void 0 || frame.vAnchor !== void 0 ? {
+		relativeTo: verticalRelativeTo(frame.vAnchor),
+		...frame.y !== void 0 ? { posOffset: pixelsToEmu(frame.y) } : {},
+		...verticalAlign !== void 0 ? { align: verticalAlign } : {}
+	} : void 0;
+	if (horizontal === void 0 && vertical === void 0) return;
+	return {
+		...horizontal !== void 0 ? { horizontal } : {},
+		...vertical !== void 0 ? { vertical } : {}
+	};
+}
+function frameWrapType(frame) {
+	switch (frame.wrap) {
+		case "notBeside": return "topAndBottom";
+		case "none": return "inFront";
+		case "through": return "through";
+		case "tight": return "tight";
+		case "around":
+		case "auto":
+		case void 0: return "square";
+		default:
+			frame.wrap;
+			return "square";
+	}
+}
+function toFrameTextBox(content, frame, nextBlockId) {
+	const first = content.at(0);
+	const last = content.at(-1);
+	const textBox = {
+		kind: "textBox",
+		id: nextBlockId(),
+		width: frame.width ?? 200,
+		margins: {
+			top: 0,
+			right: 0,
+			bottom: 0,
+			left: 0
+		},
+		content,
+		displayMode: "float",
+		wrapType: frameWrapType(frame),
+		wrapText: "bothSides",
+		distTop: frame.vSpace ?? 0,
+		distBottom: frame.vSpace ?? 0,
+		distLeft: frame.hSpace ?? 0,
+		distRight: frame.hSpace ?? 0,
+		...first?.pmStart !== void 0 ? { pmStart: first.pmStart } : {},
+		...last?.pmEnd !== void 0 ? { pmEnd: last.pmEnd } : {}
+	};
+	if (frame.height !== void 0) textBox.height = frame.height;
+	const position = framePosition(frame);
+	if (position !== void 0) textBox.position = position;
+	markParagraphFrameTextBox(textBox);
+	return textBox;
+}
+function groupParagraphFrames(blocks, nextBlockId) {
+	const grouped = [];
+	let index = 0;
+	let activeFrameSetId;
+	while (index < blocks.length) {
+		const block = blocks[index];
+		if (block?.kind !== "paragraph") {
+			if (block) grouped.push(block);
+			activeFrameSetId = void 0;
+			index += 1;
+			continue;
+		}
+		const frame = getParagraphFrame(block);
+		if (frame === void 0) {
+			grouped.push(block);
+			if (block.runs.length > 0 || activeFrameSetId === void 0 || !hasFollowingParagraphFrame(blocks, index + 1)) activeFrameSetId = void 0;
+			index += 1;
+			continue;
+		}
+		activeFrameSetId ??= `paragraph-frame-${block.pmStart ?? block.id}`;
+		const content = [];
+		while (index < blocks.length) {
+			const paragraph = blocks[index];
+			if (paragraph?.kind !== "paragraph") break;
+			const paragraphFrame = getParagraphFrame(paragraph);
+			if (paragraphFrame === void 0 || !framesEqual(frame, paragraphFrame)) break;
+			content.push(paragraph);
+			index += 1;
+		}
+		const textBox = toFrameTextBox(content, frame, nextBlockId);
+		setTextBoxGroupId(textBox, activeFrameSetId);
+		grouped.push(textBox);
+	}
+	return grouped;
+}
+function hasFollowingParagraphFrame(blocks, startIndex) {
+	for (let index = startIndex; index < blocks.length; index++) {
+		const block = blocks[index];
+		if (block?.kind !== "paragraph") return false;
+		if (getParagraphFrame(block) !== void 0) return true;
+		if (block.runs.length > 0) return false;
+	}
+	return false;
+}
+//#endregion
+export { groupParagraphFrames };

package/dist/layout-bridge/convert/toFlowBlocks.js

@@ -6,12 +6,14 @@ import { resolveColor, resolveHighlightToCss } from "../../utils/colorResolver.j
 import { resolveShadingFill } from "../../utils/formatToStyle.js";
 import { convertBulletToUnicode } from "../../docx/bulletMarkers.js";
 import { setTextBoxGroupId } from "../../layout-engine/textBoxGroup.js";
+import { setParagraphFrame } from "../../layout-engine/paragraphFrame.js";
 import { getColumns } from "../sectionColumns.js";
 import { directionIsRtl } from "../../prosemirror/paragraphDirection.js";
 import { expectBlockSdtAttrs, expectCharacterSpacingMarkAttrs, expectCommentMarkAttrs, expectEmphasisMarkAttrs, expectFieldAttrs, expectFontFamilyMarkAttrs, expectFontSizeMarkAttrs, expectFootnoteRefMarkAttrs, expectHardBreakAttrs, expectHighlightMarkAttrs, expectHyperlinkMarkAttrs, expectImageAttrs, expectMathAttrs, expectParagraphAttrs, expectRunFormattingOverrideMarkAttrs, expectRunShadingMarkAttrs, expectTableAttrs, expectTableCellAttrs, expectTableRowAttrs, expectTextBoxAttrs, expectTextColorMarkAttrs, expectTextEffectMarkAttrs, expectTrackedChangeMarkAttrs, expectUnderlineMarkAttrs } from "../../prosemirror/attrs/index.js";
 import { autospacingMatchesBase } from "../../prosemirror/autospacingBase.js";
 import { runShadingAttrsToShading } from "../../prosemirror/conversion/runShadingMark.js";
 import { assertValidProseMirrorDocument } from "../../prosemirror/validation.js";
+import { groupParagraphFrames } from "./paragraphFrames.js";
 //#region src/layout-bridge/convert/toFlowBlocks.ts
 const DEFAULT_FONT = "Calibri";
 const DEFAULT_TABLE_CELL_MARGIN_TWIPS = {
@@ -613,6 +615,9 @@ function readNumberFormats(value) {
 function readListMarkerSuffix(value) {
 	if (value === "tab" || value === "space" || value === "nothing") return value;
 }
+function readListMarkerAlignment(value) {
+	if (value === "left" || value === "center" || value === "right") return value;
+}
 function toPreviousListAttrs(previousFormatting) {
 	const attrs = {};
 	const numPr = previousFormatting["numPr"];
@@ -639,6 +644,8 @@ function toPreviousListAttrs(previousFormatting) {
 	if (typeof listMarkerFontFamily === "string") attrs.listMarkerFontFamily = listMarkerFontFamily;
 	const listMarkerFontSize = previousFormatting["listMarkerFontSize"];
 	if (typeof listMarkerFontSize === "number") attrs.listMarkerFontSize = listMarkerFontSize;
+	const listMarkerAlignment = readListMarkerAlignment(previousFormatting["listMarkerAlignment"]);
+	if (listMarkerAlignment) attrs.listMarkerAlignment = listMarkerAlignment;
 	const listMarkerSuffix = readListMarkerSuffix(previousFormatting["listMarkerSuffix"]);
 	if (listMarkerSuffix) attrs.listMarkerSuffix = listMarkerSuffix;
 	return attrs;
@@ -662,6 +669,7 @@ function applyDeletedListMarkerAttrs(attrs, change, listCounters, listAbstractCo
 	if (previousListAttrs.listMarkerHidden !== void 0) attrs.listMarkerHidden = previousListAttrs.listMarkerHidden;
 	if (previousListAttrs.listMarkerFontFamily) attrs.listMarkerFontFamily = previousListAttrs.listMarkerFontFamily;
 	if (previousListAttrs.listMarkerFontSize) attrs.listMarkerFontSize = previousListAttrs.listMarkerFontSize;
+	if (previousListAttrs.listMarkerAlignment) attrs.listMarkerAlignment = previousListAttrs.listMarkerAlignment;
 	if (previousListAttrs.listMarkerSuffix) attrs.listMarkerSuffix = previousListAttrs.listMarkerSuffix;
 }
 function convertParagraphAttrs(pmAttrs, theme, listCounters, listAbstractCounters, listSeenNumIds, defaultTabStopTwips, originalListCounters, originalListAbstractCounters, originalListSeenNumIds) {
@@ -793,6 +801,7 @@ function convertParagraphAttrs(pmAttrs, theme, listCounters, listAbstractCounter
 	if (pmAttrs.listMarkerHidden) attrs.listMarkerHidden = true;
 	if (pmAttrs.listMarkerFontFamily) attrs.listMarkerFontFamily = pmAttrs.listMarkerFontFamily;
 	if (pmAttrs.listMarkerFontSize) attrs.listMarkerFontSize = pmAttrs.listMarkerFontSize;
+	if (pmAttrs.listMarkerAlignment) attrs.listMarkerAlignment = pmAttrs.listMarkerAlignment;
 	if (pmAttrs.listMarkerSuffix) attrs.listMarkerSuffix = pmAttrs.listMarkerSuffix;
 	if (pmAttrs.listMarkerSecondSlotOffsetTwips !== void 0) attrs.listMarkerSecondSlotOffsetTwips = pmAttrs.listMarkerSecondSlotOffsetTwips;
 	if (!pmAttrs.numPr) {
@@ -836,6 +845,7 @@ function convertParagraph(node, startPos, options) {
 	if (runs.length === 0) {
 		if (pmAttrs._originalFormatting && Object.entries(pmAttrs._originalFormatting).some(([key, value]) => key !== "runProperties" && value !== void 0 && value !== null)) attrs.hasDirectParagraphFormatting = true;
 		const paragraphMarkFormatting = pmAttrs._originalFormatting?.runProperties;
+		if (paragraphMarkFormatting && Object.values(paragraphMarkFormatting).some((value) => value !== void 0 && value !== null)) attrs.hasDirectParagraphMarkFormatting = true;
 		if (paragraphMarkFormatting?.fontSize !== void 0) attrs.defaultFontSize = paragraphMarkFormatting.fontSize / 2;
 		const paragraphMarkFontFamily = paragraphMarkFormatting?.fontFamily?.ascii ?? paragraphMarkFormatting?.fontFamily?.hAnsi;
 		if (paragraphMarkFontFamily) attrs.defaultFontFamily = paragraphMarkFontFamily;
@@ -845,7 +855,7 @@ function convertParagraph(node, startPos, options) {
 		if (attrs.listMarker !== void 0) attrs.listMarkerHidden = true;
 	}
 	const bookmarkNames = pmAttrs.bookmarks?.map((b) => b.name);
-	return {
+	const block = {
 		kind: "paragraph",
 		id: nextBlockId(),
 		runs,
@@ -855,6 +865,21 @@ function convertParagraph(node, startPos, options) {
 		pmStart: startPos,
 		pmEnd: startPos + node.nodeSize
 	};
+	const frame = pmAttrs._originalFormatting?.frame;
+	if (frame !== void 0 && frame.dropCap !== "drop" && frame.dropCap !== "margin") setParagraphFrame(block, {
+		...frame.width !== void 0 ? { width: twipsToPixels(frame.width) } : {},
+		...frame.height !== void 0 ? { height: twipsToPixels(frame.height) } : {},
+		...frame.hSpace !== void 0 ? { hSpace: twipsToPixels(frame.hSpace) } : {},
+		...frame.vSpace !== void 0 ? { vSpace: twipsToPixels(frame.vSpace) } : {},
+		...frame.hAnchor !== void 0 ? { hAnchor: frame.hAnchor } : {},
+		...frame.vAnchor !== void 0 ? { vAnchor: frame.vAnchor } : {},
+		...frame.x !== void 0 ? { x: twipsToPixels(frame.x) } : {},
+		...frame.y !== void 0 ? { y: twipsToPixels(frame.y) } : {},
+		...frame.xAlign !== void 0 ? { xAlign: frame.xAlign } : {},
+		...frame.yAlign !== void 0 ? { yAlign: frame.yAlign } : {},
+		...frame.wrap !== void 0 ? { wrap: frame.wrap } : {}
+	});
+	return block;
 }
 /**
 * Word keeps terminal empty body paragraphs after a final table as editable
@@ -879,6 +904,16 @@ function suppressTerminalEmptyParagraphsAfterTable(blocks) {
 		};
 	}
 }
+function suppressFinalParagraphInRepeatedEmptySuffix(blocks) {
+	let suffixStart = blocks.length;
+	while (suffixStart > 0 && isPaintlessTerminalParagraph(blocks[suffixStart - 1])) suffixStart -= 1;
+	if (suffixStart === 0 || blocks.length - suffixStart < 2 || blocks[suffixStart - 1]?.kind === "table") return;
+	const finalBlock = blocks.at(-1);
+	if (isPaintlessTerminalParagraph(finalBlock)) finalBlock.attrs = {
+		...finalBlock.attrs,
+		suppressEmptyParagraphHeight: true
+	};
+}
 function reserveLeadingEmptyOutlineHeight(blocks) {
 	const firstBlock = blocks.at(0);
 	if (firstBlock?.kind !== "paragraph" || firstBlock.runs.length !== 0 || firstBlock.attrs?.outlineLevel !== 0) return;
@@ -983,7 +1018,7 @@ function convertTableCell(node, startPos, options, tableCellMargins) {
 	};
 	const cell = {
 		id: nextBlockId(),
-		blocks,
+		blocks: groupParagraphFrames(blocks, nextBlockId),
 		colSpan: attrs.colspan,
 		rowSpan: attrs.rowspan,
 		padding
@@ -1011,6 +1046,8 @@ function convertTableRow(node, startPos, options, tableCellMargins) {
 		id: nextBlockId(),
 		cells
 	};
+	if (attrs._originalFormatting?.gridBefore) row.gridBefore = attrs._originalFormatting.gridBefore;
+	if (attrs._originalFormatting?.gridAfter) row.gridAfter = attrs._originalFormatting.gridAfter;
 	if (attrs.height) row.height = twipsToPixels(attrs.height);
 	if (attrs.heightRule) row.heightRule = attrs.heightRule;
 	if (attrs.isHeader) row.isHeader = attrs.isHeader;
@@ -1136,6 +1173,7 @@ function convertTextBoxNode(node, startPos, opts) {
 		pmEnd: startPos + node.nodeSize
 	};
 	if (attrs.height !== void 0) textBox.height = attrs.height;
+	if (attrs.autoFit !== void 0) textBox.autoFit = attrs.autoFit;
 	if (attrs.fillColor !== void 0) textBox.fillColor = attrs.fillColor;
 	if (attrs.outlineWidth !== void 0) textBox.outlineWidth = attrs.outlineWidth;
 	if (attrs.outlineColor !== void 0) textBox.outlineColor = attrs.outlineColor;
@@ -1342,7 +1380,8 @@ function toFlowBlocks(doc, options = {}) {
 	});
 	reserveLeadingEmptyOutlineHeight(blocks);
 	suppressTerminalEmptyParagraphsAfterTable(blocks);
-	return mergeRunInParagraphs(blocks);
+	suppressFinalParagraphInRepeatedEmptySuffix(blocks);
+	return groupParagraphFrames(mergeRunInParagraphs(blocks), nextBlockId);
 }
 /**
 * Merge consecutive paragraph blocks where the first carries

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

@@ -1,4 +1,5 @@
 import { measuredLineRangeHeight } from "../../layout-engine/lineFlow.js";
+import { getTableRowLeadingWidth } from "../../layout-engine/types.js";
 import { getHeaderRowsHeight } from "../../layout-engine/index.js";
 //#region src/layout-bridge/engine/hitTest.ts
 /**
@@ -213,7 +214,7 @@ function hitTestTableCell(pageHit, blocks, measures, pagePoint) {
 		const rowMeasure = tableMeasure.rows[rowIndex];
 		const row = tableBlock.rows[rowIndex];
 		if (!rowMeasure || !row) continue;
-		let colX = 0;
+		let colX = getTableRowLeadingWidth(row, tableMeasure.columnWidths);
 		let colIndex = -1;
 		if (rowMeasure.cells.length === 0 || row.cells.length === 0) continue;
 		for (let c = 0; c < rowMeasure.cells.length; c++) {

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

@@ -2,6 +2,7 @@ import { measureRun } from "../../layout-engine/measure/measureProvider.js";
 import { buildRunFontStyle } from "../../layout-engine/measure/measureHelpers.js";
 import { inlineImageBoundingBox } from "../../utils/rotationBoundingBox.js";
 import { measuredLineContentOffset } from "../../layout-engine/lineFlow.js";
+import { getTableRowLeadingWidth } from "../../layout-engine/types.js";
 import { measureParagraph } from "../../layout-engine/measure/measureParagraph.js";
 import { buildTableCellFloatingZones, getTableCellContentWidth, getTableCellFloatingImages } from "../../layout-engine/measure/tableCellFloating.js";
 import { getHeaderRowsHeight } from "../../layout-engine/index.js";
@@ -314,7 +315,7 @@ function selectionToRects(layout, blocks, measures, from, to) {
 					if (!row || !rowMeasure) continue;
 					const clipTop = tableFragment.topClip ?? 0;
 					const clipBottom = tableFragment.bottomClip ?? rowMeasure.height;
-					let cellX = 0;
+					let cellX = getTableRowLeadingWidth(row, tableMeasure.columnWidths);
 					for (let cellIndex = 0; cellIndex < row.cells.length; cellIndex++) {
 						const cell = row.cells[cellIndex];
 						const cellMeasure = rowMeasure.cells[cellIndex];

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

@@ -0,0 +1,7 @@
+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 };

package/dist/layout-engine/headerFooterRefs.js

@@ -0,0 +1,40 @@
+//#region src/layout-engine/headerFooterRefs.ts
+const resolveSectionRefs = (props, inherited, documentEvenAndOddHeaders) => {
+	const refs = {
+		...inherited,
+		evenAndOddHeaders: props.evenAndOddHeaders ?? documentEvenAndOddHeaders
+	};
+	if (props.titlePg !== void 0) refs.titlePg = props.titlePg;
+	for (const ref of props.headerReferences ?? []) if (ref.type === "default") refs.headerDefault = ref.rId;
+	else if (ref.type === "first") refs.headerFirst = ref.rId;
+	else refs.headerEven = ref.rId;
+	for (const ref of props.footerReferences ?? []) if (ref.type === "default") refs.footerDefault = ref.rId;
+	else if (ref.type === "first") refs.footerFirst = ref.rId;
+	else refs.footerEven = ref.rId;
+	return refs;
+};
+const inheritedRefsFrom = (refs) => ({
+	...refs.headerDefault === void 0 ? {} : { headerDefault: refs.headerDefault },
+	...refs.headerFirst === void 0 ? {} : { headerFirst: refs.headerFirst },
+	...refs.headerEven === void 0 ? {} : { headerEven: refs.headerEven },
+	...refs.footerDefault === void 0 ? {} : { footerDefault: refs.footerDefault },
+	...refs.footerFirst === void 0 ? {} : { footerFirst: refs.footerFirst },
+	...refs.footerEven === void 0 ? {} : { footerEven: refs.footerEven }
+});
+const resolveSectionHeaderFooterRefs = (documentModel) => {
+	const body = documentModel?.package.document;
+	if (!body) return;
+	const sections = [];
+	if (body.sections && body.sections.length > 0) sections.push(...body.sections.map(({ properties }) => properties));
+	else if (body.finalSectionProperties) sections.push(body.finalSectionProperties);
+	if (sections.length === 0) return;
+	const documentEvenAndOddHeaders = documentModel.package.settings?.evenAndOddHeaders === true;
+	let inherited = {};
+	return sections.map((props) => {
+		const refs = resolveSectionRefs(props, inherited, documentEvenAndOddHeaders);
+		inherited = inheritedRefsFrom(refs);
+		return refs;
+	});
+};
+//#endregion
+export { resolveSectionHeaderFooterRefs };

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

@@ -1,6 +1,7 @@
-import { BlockId, BorderStyle, 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, Layout, LayoutOptions, LineBreakRun, ListNumPr, MathRun, Measure, MeasuredLine, Page, PageBreakBlock, PageBreakMeasure, PageHeaderFooterRefs, PageMargins, ParagraphAttrs, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphIndent, ParagraphMeasure, ParagraphSpacing, Run, RunFormatting, SdtGroup, SectionBreakBlock, SectionBreakMeasure, TabAlignment, TabRun, TabStop, TableBlock, TableCell, TableCellMeasure, TableFragment, TableMeasure, TableRow, TableRowMeasure, TextBoxBlock, TextBoxFlowAttrs, TextBoxFragment, TextBoxMeasure, TextRun, floatingTextBoxReservesBand, floatingTextBoxWrapsText, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, tableColumnsArePinned } from "./types.js";
+import { BlockId, BorderStyle, 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, Layout, LayoutOptions, LineBreakRun, ListNumPr, MathRun, Measure, MeasuredLine, Page, PageBreakBlock, PageBreakMeasure, PageHeaderFooterRefs, PageMargins, ParagraphAttrs, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphIndent, ParagraphMeasure, ParagraphSpacing, Run, RunFormatting, SdtGroup, SectionBreakBlock, SectionBreakMeasure, TabAlignment, TabRun, TabStop, TableBlock, TableCell, TableCellMeasure, TableFragment, TableMeasure, TableRow, TableRowMeasure, TextBoxBlock, TextBoxFlowAttrs, TextBoxFragment, TextBoxMeasure, TextRun, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getTableRowLeadingWidth, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, tableColumnsArePinned } from "./types.js";
 import { PageState, Paginator, PaginatorOptions, createPaginator } from "./paginator.js";
 import { KeepNextChain, calculateChainHeight, computeKeepNextChains, getMidChainIndices, hasKeepLines, hasPageBreakBefore } from "./keep-together.js";
+import { resolveSectionHeaderFooterRefs } from "./headerFooterRefs.js";
 import { BreakDecision, SectionState, applyPendingToActive, createInitialSectionState, getEffectiveColumns, getEffectiveMargins, getEffectivePageSize, scheduleSectionBreak } from "./section-breaks.js";
 import { assertExhaustiveFlowBlock, findPageIndexContainingPmPos } from "./pmPageIndex.js";
 
@@ -43,4 +44,4 @@ declare function layoutDocument(blocks: FlowBlock[], measures: Measure[], option
  */
 declare function getHeaderRowsHeight(measure: TableMeasure, headerRowCount: number): number;
 //#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, ListNumPr, MathRun, Measure, MeasuredLine, Page, PageBreakBlock, PageBreakMeasure, PageHeaderFooterRefs, PageMargins, type PageState, type Paginator, type PaginatorOptions, ParagraphAttrs, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphIndent, ParagraphMeasure, ParagraphSpacing, Run, RunFormatting, SdtGroup, SectionBreakBlock, SectionBreakMeasure, SectionLayoutConfig, type SectionState, TabAlignment, TabRun, TabStop, TableBlock, TableCell, TableCellMeasure, TableFragment, TableMeasure, TableRow, TableRowMeasure, TextBoxBlock, TextBoxFlowAttrs, TextBoxFragment, TextBoxMeasure, TextRun, applyContextualSpacing, applyPendingToActive, assertExhaustiveFlowBlock, calculateChainHeight, collectSectionConfigs, computeKeepNextChains, createInitialSectionState, createPaginator, findPageIndexContainingPmPos, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getEffectiveColumns, getEffectiveMargins, getEffectivePageSize, getHeaderRowsHeight, getMidChainIndices, hasKeepLines, hasPageBreakBefore, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, layoutDocument, scheduleSectionBreak, 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, ListNumPr, MathRun, Measure, MeasuredLine, Page, PageBreakBlock, PageBreakMeasure, PageHeaderFooterRefs, PageMargins, type PageState, type Paginator, type PaginatorOptions, ParagraphAttrs, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphIndent, ParagraphMeasure, ParagraphSpacing, Run, RunFormatting, SdtGroup, SectionBreakBlock, SectionBreakMeasure, SectionLayoutConfig, type SectionState, TabAlignment, TabRun, TabStop, TableBlock, TableCell, TableCellMeasure, TableFragment, TableMeasure, TableRow, TableRowMeasure, TextBoxBlock, TextBoxFlowAttrs, TextBoxFragment, TextBoxMeasure, TextRun, applyContextualSpacing, applyPendingToActive, assertExhaustiveFlowBlock, calculateChainHeight, collectSectionConfigs, computeKeepNextChains, createInitialSectionState, createPaginator, findPageIndexContainingPmPos, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getEffectiveColumns, getEffectiveMargins, getEffectivePageSize, getHeaderRowsHeight, getMidChainIndices, getTableRowLeadingWidth, hasKeepLines, hasPageBreakBefore, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, layoutDocument, resolveSectionHeaderFooterRefs, scheduleSectionBreak, tableColumnsArePinned };