@stll/folio-core 0.3.1 → 0.5.0

package/dist/paged-layout/headerFooterMargins.js

@@ -1,120 +0,0 @@
-//#region src/paged-layout/headerFooterMargins.ts
-/**
-* Floor on the body content area, in pixels. Header/footer overflow can
-* never shrink the content band below this, so a degenerate document
-* (a header taller than the page) still renders some body text.
-*/
-const MIN_CONTENT_HEIGHT_PX = 24;
-function headerHeight(content) {
-	if (!content) return 0;
-	return content.marginPushBottom ?? content.visualBottom ?? content.height;
-}
-function footerHeight(content) {
-	if (!content) return 0;
-	const bottom = content.marginPushBottom ?? content.visualBottom ?? content.height;
-	const top = content.marginPushTop ?? content.visualTop ?? 0;
-	return Math.max(bottom - top, content.height);
-}
-/**
-* Build a function that, applied to any `PageMargins`, extends `top`/`bottom`
-* to clear the same header/footer content the body's effective margins do.
-* Returns the identity function when no extension is needed.
-*
-* Header/footer distances are taken from the *given* margins (the source
-* paragraph's section margins), not the body's, so each section's authored
-* `w:header`/`w:footer` distances are honored.
-*/
-/**
-* Build an extender that pushes body margins clear of HF content.
-*
-* `mode === "default"` ignores `firstPageHeaderContent` /
-* `firstPageFooterContent`. The first-page H/F only renders on page 1 of
-* a `<w:titlePg/>`-enabled section, so margins for pages 2+ within the
-* same section must NOT be extended for first-page overflow — extending
-* them would push body content down on every page even though only page
-* 1 actually carries the overflowing header. This produced visible
-* regressions on NVCA-style first-page-header docs, where pages 2+
-* inherited page 1's title-page header reservation.
-*
-* `mode === "firstPage"` uses the larger of the default and first-page
-* H/F heights — applied only to the first-page margins of a titlePg
-* section.
-*/
-function buildExtender({ headerContent, footerContent, firstPageHeaderContent, firstPageFooterContent, pageSize, warn, mode }) {
-	const headerContentHeight = mode === "firstPage" ? Math.max(headerHeight(headerContent), headerHeight(firstPageHeaderContent)) : headerHeight(headerContent);
-	const footerContentHeight = mode === "firstPage" ? Math.max(footerHeight(footerContent), footerHeight(firstPageFooterContent)) : footerHeight(footerContent);
-	return (margins) => {
-		const headerDistance = margins.header ?? 48;
-		const footerDistance = margins.footer ?? 48;
-		const availableHeaderSpace = margins.top - headerDistance;
-		const availableFooterSpace = margins.bottom - footerDistance;
-		const maxMargins = pageSize ? Math.max(0, pageSize.h - MIN_CONTENT_HEIGHT_PX) : void 0;
-		const fitsContent = headerContentHeight <= availableHeaderSpace && footerContentHeight <= availableFooterSpace;
-		const fitsPage = maxMargins === void 0 || margins.top + margins.bottom <= maxMargins;
-		if (fitsContent && fitsPage) return margins;
-		const out = { ...margins };
-		if (headerContentHeight > availableHeaderSpace) out.top = Math.max(margins.top, headerDistance + headerContentHeight);
-		if (footerContentHeight > availableFooterSpace) out.bottom = Math.max(margins.bottom, footerDistance + footerContentHeight);
-		if (pageSize && maxMargins !== void 0 && out.top + out.bottom > maxMargins) {
-			if (warn) warn(`header/footer content exceeds page height; clamping margins to preserve a content area. pageHeight=${Math.round(pageSize.h)} top=${Math.round(out.top)} bottom=${Math.round(out.bottom)}`);
-			out.bottom = Math.max(0, Math.min(out.bottom, maxMargins - out.top));
-			if (out.top + out.bottom > maxMargins) out.top = Math.max(0, maxMargins - out.bottom);
-		}
-		return out;
-	};
-}
-function computeHeaderFooterMarginExtender(input) {
-	return buildExtender({
-		...input,
-		mode: "default"
-	});
-}
-/**
-* Like `computeHeaderFooterMarginExtender` but also accounts for the
-* first-page header/footer content. Apply this only to the margins used
-* for page 1 of a `<w:titlePg/>`-enabled section.
-*/
-function computeFirstPageHeaderFooterMarginExtender(input) {
-	return buildExtender({
-		...input,
-		mode: "firstPage"
-	});
-}
-function computeEffectiveHeaderFooterMargins({ margins, headerContent, footerContent, firstPageHeaderContent, firstPageFooterContent, pageSize, warn }) {
-	return computeHeaderFooterMarginExtender({
-		headerContent,
-		footerContent,
-		firstPageHeaderContent,
-		firstPageFooterContent,
-		pageSize,
-		warn
-	})(margins);
-}
-/**
-* Extend every section break's margins to clear the same header/footer
-* overflow the body margins do (eigenpal #400), so an overflowing footer
-* never re-overlaps body text on a later section.
-*
-* The walk mirrors `collectSectionConfigs`: a break that omits its own
-* `pageSize` or `margins` inherits the previous section's. Each break's
-* authored-or-inherited margins are extended against the section's *own*
-* resolved page height, so a taller page never keeps a smaller page's
-* clamped reservation (and vice versa). Materializes `margins` on every
-* non-inheriting break in place.
-*/
-function extendSectionBreakMargins(sectionBreaks, { content, bodyPageSize, bodyMargins, warn }) {
-	let pageSize = bodyPageSize;
-	let margins = bodyMargins;
-	for (const sb of sectionBreaks) {
-		if (!sb.pageSize && !sb.margins) continue;
-		pageSize = sb.pageSize ?? pageSize;
-		margins = computeHeaderFooterMarginExtender({
-			...content,
-			pageSize,
-			warn
-		})(sb.margins ?? margins);
-		sb.margins = margins;
-	}
-}
-//#endregion
-export { computeEffectiveHeaderFooterMargins, computeFirstPageHeaderFooterMarginExtender, computeHeaderFooterMarginExtender, extendSectionBreakMargins };