reamkit 1.1.0 → 1.2.0

package/dist/esm/layout/styled-layout.js

@@ -11,11 +11,12 @@ import { applyNumbering, applyNumberingToHeadersFooters } from "../core/numberin
 import { DEFAULT_RESOLVED_PARAGRAPH, DEFAULT_RESOLVED_RUN } from "../core/style-cascade/types.js";
 import { resolveParagraphProperties, resolveRunProperties } from "../core/style-cascade/resolver.js";
 import "../core/style-cascade/index.js";
-import { PathBuilder } from "../core/vector.js";
-import { arcPoint, arcToBeziers } from "./arc-to-bezier.js";
-import { buildChartScene } from "./chart-geometry.js";
+import { PathBuilder, flipTransform } from "../core/vector.js";
+import { arcPoint, arcToBeziers } from "../core/arc-to-bezier.js";
+import { buildChartScene } from "../core/drawingml/chart-geometry.js";
 import { layoutMath, mathGlyphSegments, variantStyle } from "./math-layout.js";
-import { customPaths, presetPaths, rectPath } from "./preset-geometry.js";
+import { rectPath } from "../core/drawingml/preset-geometry.js";
+import { buildShapePaths, buildShapeTransform, buildStroke } from "../core/drawingml/shape-render.js";
 import { StructTreeBuilder } from "../pdf/struct-tree.js";
 //#region src/layout/styled-layout.ts
 function parsePdfAProfile(pdfA) {
@@ -32,23 +33,199 @@ var TWIP_TO_PT = 1 / 20;
 var EIGHTH_PT = 1 / 8;
 var DEFAULT_CELL_PADDING_TWIPS = 108;
 var DEFAULT_BORDER_SIZE_EIGHTH = 4;
+var FOOTNOTE_RULE_PT = .75;
+var FOOTNOTE_RULE_GAP_ABOVE = 4;
+var FOOTNOTE_SEPARATOR_HEIGHT = 10;
+var FOOTNOTE_RULE_WIDTH = 144;
+function assignNoteNumbers(body) {
+	const footnotes = /* @__PURE__ */ new Map();
+	const endnotes = /* @__PURE__ */ new Map();
+	const paragraphFootnotes = /* @__PURE__ */ new Set();
+	const numberRun = (run, n) => ({
+		...run,
+		text: String(n),
+		properties: {
+			...run.properties,
+			verticalAlign: "superscript"
+		}
+	});
+	const mapParagraph = (paragraph) => {
+		if (!paragraph.runs.some((r) => r.footnoteRef !== void 0 || r.endnoteRef !== void 0)) return paragraph;
+		return {
+			...paragraph,
+			runs: paragraph.runs.map((run) => {
+				if (run.footnoteRef !== void 0) {
+					let n = footnotes.get(run.footnoteRef);
+					if (n === void 0) {
+						n = footnotes.size + 1;
+						footnotes.set(run.footnoteRef, n);
+					}
+					return numberRun(run, n);
+				}
+				if (run.endnoteRef !== void 0) {
+					let n = endnotes.get(run.endnoteRef);
+					if (n === void 0) {
+						n = endnotes.size + 1;
+						endnotes.set(run.endnoteRef, n);
+					}
+					return numberRun(run, n);
+				}
+				return run;
+			})
+		};
+	};
+	const mapElement = (el, topLevel) => {
+		if (el.kind === "paragraph") {
+			if (topLevel) {
+				for (const r of el.paragraph.runs) if (r.footnoteRef !== void 0) paragraphFootnotes.add(r.footnoteRef);
+			}
+			return {
+				kind: "paragraph",
+				paragraph: mapParagraph(el.paragraph)
+			};
+		}
+		if (el.kind === "table") return {
+			kind: "table",
+			table: {
+				...el.table,
+				rows: el.table.rows.map((row) => ({
+					...row,
+					cells: row.cells.map((cell) => ({
+						...cell,
+						content: cell.content.map((c) => mapElement(c, false))
+					}))
+				}))
+			}
+		};
+		if (el.kind === "shape" && el.shape.text) return {
+			kind: "shape",
+			shape: {
+				...el.shape,
+				text: {
+					...el.shape.text,
+					content: el.shape.text.content.map((c) => mapElement(c, false))
+				}
+			}
+		};
+		return el;
+	};
+	const hasRefs = (els) => els.some((el) => {
+		if (el.kind === "paragraph") return el.paragraph.runs.some((r) => r.footnoteRef !== void 0 || r.endnoteRef !== void 0);
+		if (el.kind === "table") return el.table.rows.some((row) => row.cells.some((c) => hasRefs(c.content)));
+		if (el.kind === "shape" && el.shape.text) return hasRefs(el.shape.text.content);
+		return false;
+	});
+	if (!hasRefs(body)) return {
+		body,
+		footnotes,
+		endnotes,
+		deferredFootnotes: []
+	};
+	return {
+		body: body.map((el) => mapElement(el, true)),
+		footnotes,
+		endnotes,
+		deferredFootnotes: [...footnotes.keys()].filter((id) => !paragraphFootnotes.has(id))
+	};
+}
+function substituteNoteNumber(content, n) {
+	const hasPlaceholder = content.some((el) => el.kind === "paragraph" && el.paragraph.runs.some((r) => r.noteNumber));
+	const out = content.map((el) => {
+		if (el.kind !== "paragraph") return el;
+		if (!el.paragraph.runs.some((r) => r.noteNumber)) return el;
+		return {
+			kind: "paragraph",
+			paragraph: {
+				...el.paragraph,
+				runs: el.paragraph.runs.map((r) => r.noteNumber ? {
+					...r,
+					text: String(n),
+					properties: {
+						...r.properties,
+						verticalAlign: "superscript"
+					}
+				} : r)
+			}
+		};
+	});
+	if (hasPlaceholder || out.length === 0) return out;
+	const first = out[0];
+	if (first.kind !== "paragraph") return out;
+	return [{
+		kind: "paragraph",
+		paragraph: {
+			...first.paragraph,
+			runs: [{
+				text: `${n} `,
+				properties: { verticalAlign: "superscript" }
+			}, ...first.paragraph.runs]
+		}
+	}, ...out.slice(1)];
+}
 function layoutStyledDocument(body, options) {
 	const sectionList = resolveSectionList(body, options);
-	const numberedBody = applyNumbering(body, options.numbering);
+	const noteAssigned = assignNoteNumbers(applyNumbering(body, options.numbering));
+	const numberedBody = noteAssigned.body;
 	const numberedHeadersFooters = applyNumberingToHeadersFooters(options.headersFooters, options.numbering);
 	const pdfaProfile = options.pdfA ? parsePdfAProfile(options.pdfA) : void 0;
-	const tagged = options.tagged === true || (pdfaProfile?.tagged ?? false);
+	const tagged = options.tagged === true || options.pdfUA === true || (pdfaProfile?.tagged ?? false);
 	const structBuilder = tagged ? new StructTreeBuilder() : void 0;
 	const fontResources = collectFontResources(numberedBody, numberedHeadersFooters, options);
 	const imageResources = collectImageResources(numberedBody, numberedHeadersFooters, options);
 	const sectionCtxs = sectionList.map((s) => buildSectionContext(s, options, numberedHeadersFooters, fontResources));
 	let sectionIdx = 0;
+	const blocks = numberedBody.map((el, idx) => {
+		while (sectionIdx < sectionCtxs.length - 1 && idx >= sectionCtxs[sectionIdx].endIndex) sectionIdx++;
+		const ctx = sectionCtxs[sectionIdx];
+		return layoutBodyElement(el, options, fontResources, imageResources, ctx.columns ? ctx.columns[0].widthPt : ctx.contentWidth, ctx.pageContentHeight);
+	});
+	const noteBlockCache = /* @__PURE__ */ new Map();
+	const notePlan = options.footnotes && noteAssigned.footnotes.size > 0 ? {
+		numbers: noteAssigned.footnotes,
+		layout: (sectionCtx, id) => {
+			let byId = noteBlockCache.get(sectionCtx);
+			if (!byId) {
+				byId = /* @__PURE__ */ new Map();
+				noteBlockCache.set(sectionCtx, byId);
+			}
+			if (byId.has(id)) return byId.get(id);
+			const content = options.footnotes?.get(id);
+			const n = noteAssigned.footnotes.get(id);
+			let laid = void 0;
+			if (content && n !== void 0 && !noteAssigned.deferredFootnotes.includes(id)) {
+				const noteBlocks = substituteNoteNumber(content, n).map((el) => layoutBodyElement(el, options, fontResources, imageResources, sectionCtx.contentWidth, sectionCtx.pageContentHeight));
+				laid = {
+					blocks: noteBlocks,
+					heightPt: noteBlocks.reduce((sum, b) => sum + (b.kind === "paragraph" ? b.spacingBeforePt + b.heightPt + b.spacingAfterPt : 0), 0)
+				};
+			}
+			byId.set(id, laid);
+			return laid;
+		}
+	} : void 0;
+	const lastCtx = sectionCtxs[sectionCtxs.length - 1];
+	if (lastCtx) {
+		const tailNotes = [];
+		for (const id of noteAssigned.deferredFootnotes) {
+			const content = options.footnotes?.get(id);
+			const n = noteAssigned.footnotes.get(id);
+			if (content && n !== void 0) tailNotes.push({
+				content,
+				n
+			});
+		}
+		for (const [id, n] of noteAssigned.endnotes) {
+			const content = options.endnotes?.get(id);
+			if (content) tailNotes.push({
+				content,
+				n
+			});
+		}
+		for (const note of tailNotes.sort((a, b) => a.n - b.n)) for (const el of substituteNoteNumber(note.content, note.n)) blocks.push(layoutBodyElement(el, options, fontResources, imageResources, lastCtx.contentWidth, lastCtx.pageContentHeight));
+	}
+	const bookmarks = /* @__PURE__ */ new Map();
 	return {
-		pages: paginateSections(numberedBody.map((el, idx) => {
-			while (sectionIdx < sectionCtxs.length - 1 && idx >= sectionCtxs[sectionIdx].endIndex) sectionIdx++;
-			const ctx = sectionCtxs[sectionIdx];
-			return layoutBodyElement(el, options, fontResources, imageResources, ctx.contentWidth, ctx.pageContentHeight);
-		}), sectionCtxs, structBuilder, options.language ?? "en-US"),
+		pages: paginateSections(blocks, sectionCtxs, structBuilder, options.language ?? "en-US", notePlan, bookmarks),
 		resources: options.resources ?? new ResourceStore(),
 		fontResources,
 		imageResources,
@@ -56,7 +233,8 @@ function layoutStyledDocument(body, options) {
 			structBuilder,
 			sectionCtxs,
 			pdfaProfile,
-			tagged
+			tagged,
+			bookmarks
 		}
 	};
 }
@@ -99,6 +277,7 @@ function buildSectionContext(section, options, headersFooters, fontResources) {
 	const contentWidth = dims.pageWidth - dims.marginLeft - dims.marginRight;
 	const headerSet = layoutHeaderSet(section.properties, headersFooters, options, fontResources, contentWidth, dims.marginLeft, dims.pageHeight, dims.headerOffsetPt);
 	const footerSet = layoutFooterSet(section.properties, headersFooters, options, fontResources, contentWidth, dims.marginLeft, dims.pageHeight, dims.footerOffsetPt);
+	const columns = buildColumnGeometry(section.properties.columns, contentWidth);
 	return {
 		endIndex: section.endIndex,
 		properties: section.properties,
@@ -109,12 +288,35 @@ function buildSectionContext(section, options, headersFooters, fontResources) {
 		marginBottom: dims.marginBottom,
 		contentWidth,
 		pageContentHeight: dims.pageHeight - dims.marginTop - dims.marginBottom,
+		...columns ? { columns } : {},
 		headerSet,
 		footerSet,
 		titlePg: section.properties.titlePg === true,
 		evenAndOddHeaders: section.properties.evenAndOddHeaders === true
 	};
 }
+function buildColumnGeometry(cols, contentWidth) {
+	if (!cols || cols.count <= 1) return void 0;
+	const out = [];
+	if (cols.explicit && cols.explicit.length > 1) {
+		let x = 0;
+		for (const c of cols.explicit) {
+			out.push({
+				xOffsetPt: x,
+				widthPt: c.widthPt
+			});
+			x += c.widthPt + c.spacePt;
+		}
+		return out;
+	}
+	const width = (contentWidth - cols.spacePt * (cols.count - 1)) / cols.count;
+	if (width <= 0) return void 0;
+	for (let i = 0; i < cols.count; i++) out.push({
+		xOffsetPt: i * (width + cols.spacePt),
+		widthPt: width
+	});
+	return out;
+}
 function refByType(refs, type) {
 	if (!refs || refs.length === 0) return void 0;
 	return refs.find((r) => r.type === type);
@@ -128,10 +330,17 @@ function markPagination(cmds) {
 function layoutHeaderSet(section, headersFooters, options, fontResources, contentWidth, marginLeft, pageHeight, headerOffsetPt) {
 	const band = (type) => {
 		const ref = refByType(section.headers, type);
-		if (!ref) return [];
+		if (!ref) return { commands: [] };
 		const content = headersFooters.get(ref.relationshipId);
-		if (!content) return [];
-		return markPagination(drawBlocksSequentially(laidOutBlocksFor(content, options, fontResources, contentWidth), marginLeft, pageHeight - headerOffsetPt, pageHeight));
+		if (!content) return { commands: [] };
+		const render = (c) => {
+			return markPagination(drawBlocksSequentially(laidOutBlocksFor(c, options, fontResources, contentWidth), marginLeft, pageHeight - headerOffsetPt, pageHeight));
+		};
+		if (contentHasPageFields(content)) return {
+			commands: [],
+			renderDynamic: (n, total) => render(substitutePageFields(content, n, total))
+		};
+		return { commands: render(content) };
 	};
 	return {
 		default: band("default"),
@@ -142,11 +351,18 @@ function layoutHeaderSet(section, headersFooters, options, fontResources, conten
 function layoutFooterSet(section, headersFooters, options, fontResources, contentWidth, marginLeft, pageHeight, footerOffsetPt) {
 	const band = (type) => {
 		const ref = refByType(section.footers, type);
-		if (!ref) return [];
+		if (!ref) return { commands: [] };
 		const content = headersFooters.get(ref.relationshipId);
-		if (!content) return [];
-		const blocks = laidOutBlocksFor(content, options, fontResources, contentWidth);
-		return markPagination(drawBlocksSequentially(blocks, marginLeft, footerOffsetPt + blocks.reduce((sum, b) => sum + (b.kind === "paragraph" ? b.spacingBeforePt + b.heightPt + b.spacingAfterPt : b.heightPt), 0), pageHeight));
+		if (!content) return { commands: [] };
+		const render = (c) => {
+			const blocks = laidOutBlocksFor(c, options, fontResources, contentWidth);
+			return markPagination(drawBlocksSequentially(blocks, marginLeft, footerOffsetPt + blocks.reduce((sum, b) => sum + (b.kind === "paragraph" ? b.spacingBeforePt + b.heightPt + b.spacingAfterPt : b.heightPt), 0), pageHeight));
+		};
+		if (contentHasPageFields(content)) return {
+			commands: [],
+			renderDynamic: (n, total) => render(substitutePageFields(content, n, total))
+		};
+		return { commands: render(content) };
 	};
 	return {
 		default: band("default"),
@@ -154,9 +370,30 @@ function layoutFooterSet(section, headersFooters, options, fontResources, conten
 		even: band("even")
 	};
 }
+function contentHasPageFields(content) {
+	for (const el of content) if (el.kind === "paragraph" && el.paragraph.runs.some((r) => r.field !== void 0)) return true;
+	return false;
+}
+function substitutePageFields(content, pageNumber, totalPages) {
+	return content.map((el) => {
+		if (el.kind !== "paragraph") return el;
+		if (!el.paragraph.runs.some((r) => r.field !== void 0)) return el;
+		return {
+			kind: "paragraph",
+			paragraph: {
+				...el.paragraph,
+				runs: el.paragraph.runs.map((r) => r.field === void 0 ? r : {
+					...r,
+					text: String(r.field === "PAGE" ? pageNumber : totalPages)
+				})
+			}
+		};
+	});
+}
 function pickBand(set, band) {
-	if (band === "first") return set.first.length > 0 ? set.first : set.default;
-	if (band === "even") return set.even.length > 0 ? set.even : set.default;
+	const has = (e) => e.commands.length > 0 || e.renderDynamic !== void 0;
+	if (band === "first") return has(set.first) ? set.first : set.default;
+	if (band === "even") return has(set.even) ? set.even : set.default;
 	return set.default;
 }
 function bandForPage(pageInSection, globalPageIdx, titlePg, evenAndOddHeaders) {
@@ -174,7 +411,6 @@ function layoutBodyElement(el, options, fontResources, imageResources, contentWi
 	if (el.kind === "chart") return layoutChartBlock(el.chart, options, fontResources, contentWidth, maxHeight);
 	return layoutShapeBlock(el.shape, options, fontResources, imageResources, contentWidth, maxHeight);
 }
-var EMU_PER_PT = 12700;
 function layoutImageBlock(image, imageResources, contentWidth) {
 	let widthPt = image.width;
 	let heightPt = image.height;
@@ -193,12 +429,10 @@ function layoutImageBlock(image, imageResources, contentWidth) {
 		resourceName: res?.resourceName ?? "",
 		spacingBeforePt: image.paragraphProperties.spacingBefore ?? 0,
 		spacingAfterPt: image.paragraphProperties.spacingAfter ?? 0,
-		...image.altText ? { altText: image.altText } : {}
+		...image.altText ? { altText: image.altText } : {},
+		...image.float ? { float: image.float } : {}
 	};
 }
-var DEFAULT_LINE_WIDTH_EMU = 9525;
-var DEFAULT_INSET_LR_EMU = 91440;
-var DEFAULT_INSET_TB_EMU = 45720;
 function layoutShapeBlock(shape, options, fontResources, imageResources, contentWidth, maxHeight) {
 	let widthPt = shape.width;
 	let heightPt = shape.height;
@@ -218,10 +452,10 @@ function layoutShapeBlock(shape, options, fontResources, imageResources, content
 	const t = shape.transform;
 	const pp = shape.paragraphProperties;
 	const text = shape.text;
-	const insetLeftPt = text?.insetLeft ?? DEFAULT_INSET_LR_EMU / EMU_PER_PT;
-	const insetRightPt = text?.insetRight ?? DEFAULT_INSET_LR_EMU / EMU_PER_PT;
-	const insetTopPt = text?.insetTop ?? DEFAULT_INSET_TB_EMU / EMU_PER_PT;
-	const insetBottomPt = text?.insetBottom ?? DEFAULT_INSET_TB_EMU / EMU_PER_PT;
+	const insetLeftPt = text?.insetLeft ?? 7.2;
+	const insetRightPt = text?.insetRight ?? 7.2;
+	const insetTopPt = text?.insetTop ?? 3.6;
+	const insetBottomPt = text?.insetBottom ?? 3.6;
 	const textLines = [];
 	let textHeightPt = 0;
 	if (text && text.content.length > 0) {
@@ -256,82 +490,10 @@ function layoutShapeBlock(shape, options, fontResources, imageResources, content
 		insetTopPt,
 		insetBottomPt,
 		anchor: text?.anchor ?? "t",
-		...shape.altText ? { altText: shape.altText } : {}
+		...shape.altText ? { altText: shape.altText } : {},
+		...shape.float ? { float: shape.float } : {}
 	};
 }
-function buildShapePaths(geometry, widthPt, heightPt) {
-	if (geometry.kind === "preset") return presetPaths(geometry.preset ?? "rect", widthPt, heightPt, geometry.adjust ?? /* @__PURE__ */ new Map()) ?? [rectPath(widthPt, heightPt)];
-	if (geometry.custom) return customPaths(geometry.custom, widthPt, heightPt);
-	return [rectPath(widthPt, heightPt)];
-}
-function buildStroke(line) {
-	if (!line || line.fill === "none") return void 0;
-	const widthPt = line.width ?? DEFAULT_LINE_WIDTH_EMU / EMU_PER_PT;
-	const dash = line.dash && line.dash !== "solid" ? dashPattern(line.dash, widthPt) : void 0;
-	const cap = line.cap === "flat" ? "butt" : line.cap;
-	return {
-		colorHex: line.colorHex ?? "000000",
-		widthPt,
-		...dash ? { dash } : {},
-		...cap ? { cap } : {}
-	};
-}
-function dashPattern(dash, w) {
-	const u = Math.max(w, .1);
-	switch (dash) {
-		case "solid": return;
-		case "dot": return [u, 2 * u];
-		case "dash": return [4 * u, 3 * u];
-		case "dashDot": return [
-			4 * u,
-			3 * u,
-			u,
-			3 * u
-		];
-		case "lgDash": return [8 * u, 3 * u];
-		case "lgDashDot": return [
-			8 * u,
-			3 * u,
-			u,
-			3 * u
-		];
-		case "sysDash": return [3 * u, u];
-		case "sysDot": return [u, u];
-	}
-}
-function buildShapeTransform(pageX, pageY, widthPt, heightPt, rotation60k, flipH, flipV) {
-	const theta = -rotation60k / 6e4 * (Math.PI / 180);
-	const sx = flipH ? -1 : 1;
-	const sy = flipV ? -1 : 1;
-	const cos = Math.cos(theta);
-	const sin = Math.sin(theta);
-	const a = sx * cos;
-	const b = sx * sin;
-	const c = -sy * sin;
-	const d = sy * cos;
-	const cxL = widthPt / 2;
-	const cyL = heightPt / 2;
-	const centerX = pageX + cxL;
-	const centerY = pageY + cyL;
-	return [
-		a,
-		b,
-		c,
-		d,
-		centerX - (a * cxL + c * cyL),
-		centerY - (b * cxL + d * cyL)
-	];
-}
-function flipTransform(m, pageHeight) {
-	return [
-		m[0],
-		-m[1],
-		m[2],
-		-m[3],
-		m[4],
-		pageHeight - m[5]
-	];
-}
 function layoutChartBlock(block, options, fontResources, contentWidth, maxHeight) {
 	let widthPt = block.width;
 	let heightPt = block.height;
@@ -362,7 +524,8 @@ function layoutChartBlock(block, options, fontResources, contentWidth, maxHeight
 		resolvedAlignment: pp.alignment ?? "left",
 		spacingBeforePt: pp.spacingBefore ?? 0,
 		spacingAfterPt: pp.spacingAfter ?? 0,
-		...altText ? { altText } : {}
+		...altText ? { altText } : {},
+		...block.float ? { float: block.float } : {}
 	};
 }
 function buildChartLayout(chart, widthPt, heightPt, font) {
@@ -486,6 +649,8 @@ function collectImageResources(body, headersFooters, options) {
 	};
 	visit(body);
 	for (const hf of headersFooters.values()) visit(hf);
+	for (const note of options.footnotes?.values() ?? []) visit(note);
+	for (const note of options.endnotes?.values() ?? []) visit(note);
 	const flattenAlpha = options.pdfA ? parsePdfAProfile(options.pdfA).part === 1 : false;
 	let counter = 0;
 	for (const resourceId of seen) {
@@ -505,7 +670,7 @@ function collectImageResources(body, headersFooters, options) {
 	}
 	return out;
 }
-function drawBlocksSequentially(blocks, startX, startY, pageHeight) {
+function drawBlocksSequentially(blocks, startX, startY, pageHeight, structId) {
 	const out = [];
 	let cursorY = startY;
 	for (const block of blocks) {
@@ -520,7 +685,8 @@ function drawBlocksSequentially(blocks, startX, startY, pageHeight) {
 				type: "line",
 				line,
 				originX: pt(startX + indentLeft + offset),
-				baselineY: pt(pageHeight - (cursorY + lineDescent(line)))
+				baselineY: pt(pageHeight - (cursorY + lineDescent(line))),
+				...structId !== void 0 ? { structId } : {}
 			});
 		}
 		cursorY -= block.spacingAfterPt;
@@ -600,6 +766,20 @@ function collectFontResources(body, headersFooters, options) {
 				continue;
 			}
 			if (run.inlineImage && !run.text) continue;
+			if (run.field !== void 0) {
+				addRun({
+					text: `${run.text}0123456789`,
+					properties: run.properties
+				}, el.paragraph);
+				continue;
+			}
+			if (run.footnoteRef !== void 0 || run.endnoteRef !== void 0 || run.noteNumber) {
+				addRun({
+					text: `${run.text}0123456789 `,
+					properties: run.properties
+				}, el.paragraph);
+				continue;
+			}
 			addRun(run, el.paragraph);
 		}
 		else if (el.kind === "table") for (const row of el.table.rows) for (const cell of row.cells) visit(cell.content);
@@ -629,6 +809,8 @@ function collectFontResources(body, headersFooters, options) {
 	};
 	visit(body);
 	for (const hf of headersFooters.values()) visit(hf);
+	for (const note of options.footnotes?.values() ?? []) visit(note);
+	for (const note of options.endnotes?.values() ?? []) visit(note);
 	if (used.size === 0) {
 		const regular = options.registry.resolveByStyle(false, false);
 		used.set(regular.variant, {
@@ -672,7 +854,8 @@ function layoutParagraphBlock(paragraph, options, fontResources, imageResources,
 			numId: numbering.numId,
 			level: numbering.ilvl
 		} } : {},
-		...paragraph.runs.some((r) => r.pageBreak) ? { pageBreakAfter: true } : {}
+		...paragraph.runs.some((r) => r.pageBreak) ? { pageBreakAfter: true } : {},
+		...paragraph.bookmarks && paragraph.bookmarks.length > 0 ? { bookmarks: paragraph.bookmarks } : {}
 	};
 }
 function resolveMathItems(items, fontFor) {
@@ -801,6 +984,9 @@ function tokenizePlansLtr(plans) {
 			kind: "text",
 			text: t.text,
 			isSpace: t.isSpace,
+			...plan.run.href !== void 0 ? { href: plan.run.href } : {},
+			...plan.run.footnoteRef !== void 0 ? { footnoteRef: plan.run.footnoteRef } : {},
+			...plan.run.anchor !== void 0 ? { anchor: plan.run.anchor } : {},
 			resolvedRun: plan.resolvedRun,
 			font: plan.font,
 			fontSizePt: plan.fontSizePt,
@@ -851,6 +1037,9 @@ function tokenizePlansBidi(plans, realLevels) {
 				kind: "text",
 				text,
 				isSpace: curSpace,
+				...plan.run.href !== void 0 ? { href: plan.run.href } : {},
+				...plan.run.footnoteRef !== void 0 ? { footnoteRef: plan.run.footnoteRef } : {},
+				...plan.run.anchor !== void 0 ? { anchor: plan.run.anchor } : {},
 				resolvedRun: plan.resolvedRun,
 				font: plan.font,
 				fontSizePt: plan.fontSizePt,
@@ -1368,7 +1557,7 @@ function listItemParagraphNode(builder, stack, list) {
 	frame.lbody = lbody;
 	return builder.create("P", lbody).id;
 }
-function paginateSections(blocks, sectionCtxs, builder, defaultLang = "en-US") {
+function paginateSections(blocks, sectionCtxs, builder, defaultLang = "en-US", notes, bookmarkPositions) {
 	if (sectionCtxs.length === 0) return [];
 	const pages = [];
 	let ctx = sectionCtxs[0];
@@ -1378,22 +1567,121 @@ function paginateSections(blocks, sectionCtxs, builder, defaultLang = "en-US") {
 	let current = [];
 	let pendingPageBreak = false;
 	let cursorY = ctx.pageHeight - ctx.marginTop;
+	let colIdx = 0;
+	let colStartLen = 0;
+	const colLeft = () => ctx.marginLeft + (ctx.columns?.[colIdx]?.xOffsetPt ?? 0);
+	const colWidth = () => ctx.columns?.[colIdx]?.widthPt ?? ctx.contentWidth;
+	const colHasContent = () => current.length > colStartLen;
+	const advanceColumn = () => {
+		if (ctx.columns && colIdx + 1 < ctx.columns.length) {
+			colIdx++;
+			colStartLen = current.length;
+			cursorY = ctx.pageHeight - ctx.marginTop;
+		} else flushPage();
+	};
+	let floatsBehind = [];
+	let floatsFront = [];
+	const floatX = (f, widthPt) => {
+		const h = f.posH;
+		if (!h) return colLeft();
+		const base = h.relativeFrom === "page" ? 0 : h.relativeFrom === "column" ? colLeft() : ctx.marginLeft;
+		const span = h.relativeFrom === "page" ? ctx.pageWidth : h.relativeFrom === "column" ? colWidth() : ctx.contentWidth;
+		if (h.align === "center") return base + (span - widthPt) / 2;
+		if (h.align === "right") return base + span - widthPt;
+		return base + (h.offsetPt ?? 0);
+	};
+	const floatTopYUp = (f) => {
+		const v = f.posV;
+		if (!v) return cursorY;
+		if (v.relativeFrom === "page") return ctx.pageHeight - (v.offsetPt ?? 0);
+		if (v.relativeFrom === "margin") return ctx.pageHeight - ctx.marginTop - (v.offsetPt ?? 0);
+		return cursorY - (v.offsetPt ?? 0);
+	};
 	const listStack = [];
+	let pageNotes = [];
+	let noteReserve = 0;
+	const placedNotes = /* @__PURE__ */ new Set();
+	const bottomLimit = () => ctx.marginBottom + noteReserve;
+	const lineFootnotes = (line) => {
+		if (!notes) return [];
+		const out = [];
+		for (const tok of line.tokens) {
+			if (tok.kind !== "text" || tok.footnoteRef === void 0) continue;
+			const id = tok.footnoteRef;
+			if (placedNotes.has(id) || out.some((o) => o.id === id)) continue;
+			const laid = notes.layout(ctx, id);
+			const n = notes.numbers.get(id);
+			if (!laid || n === void 0) continue;
+			out.push({
+				id,
+				n,
+				blocks: laid.blocks,
+				heightPt: laid.heightPt
+			});
+		}
+		return out;
+	};
+	const renderNotesBand = () => {
+		if (pageNotes.length === 0) return [];
+		const out = [];
+		const top = ctx.marginBottom + noteReserve;
+		out.push({
+			type: "fill",
+			x: pt(ctx.marginLeft),
+			y: pt(ctx.pageHeight - (top - FOOTNOTE_RULE_GAP_ABOVE)),
+			width: pt(FOOTNOTE_RULE_WIDTH),
+			height: pt(FOOTNOTE_RULE_PT),
+			fillColorHex: "000000"
+		});
+		let cursor = top - FOOTNOTE_SEPARATOR_HEIGHT;
+		for (const note of pageNotes.sort((a, b) => a.n - b.n)) {
+			let structId;
+			if (builder) {
+				const noteNode = builder.create("Note", builder.root);
+				structId = builder.create("P", noteNode).id;
+			}
+			out.push(...drawBlocksSequentially(note.blocks, ctx.marginLeft, cursor, ctx.pageHeight, structId));
+			cursor -= note.heightPt;
+		}
+		return out;
+	};
+	const dynBands = [];
 	const flushPage = (force = false) => {
 		if (current.length === 0 && !force) return;
 		const band = bandForPage(pageInSection, globalPageIdx, ctx.titlePg, ctx.evenAndOddHeaders);
 		const header = pickBand(ctx.headerSet, band);
 		const footer = pickBand(ctx.footerSet, band);
+		if (header.renderDynamic) dynBands.push({
+			pageIdx: pages.length,
+			pageNumber: globalPageIdx + 1,
+			position: "header",
+			render: header.renderDynamic
+		});
+		if (footer.renderDynamic) dynBands.push({
+			pageIdx: pages.length,
+			pageNumber: globalPageIdx + 1,
+			position: "footer",
+			render: footer.renderDynamic
+		});
 		pages.push({
 			commands: [
-				...header,
+				...header.commands,
+				...floatsBehind,
 				...current,
-				...footer
+				...floatsFront,
+				...renderNotesBand(),
+				...footer.commands
 			],
 			width: pt(ctx.pageWidth),
 			height: pt(ctx.pageHeight)
 		});
 		current = [];
+		floatsBehind = [];
+		floatsFront = [];
+		pageNotes = [];
+		noteReserve = 0;
+		colIdx = 0;
+		colStartLen = 0;
 		pageInSection++;
 		globalPageIdx++;
 		cursorY = ctx.pageHeight - ctx.marginTop;
@@ -1421,16 +1709,42 @@ function paginateSections(blocks, sectionCtxs, builder, defaultLang = "en-US") {
 				const lang = dominantParagraphLang(block.lines);
 				if (lang && lang !== defaultLang) builder.node(structId).lang = lang;
 			}
+			let firstLineOfBlock = true;
 			for (const line of block.lines) {
 				const h = computeLineHeight(line, block.resolved);
-				if (cursorY - h < ctx.marginBottom && current.length > 0) flushPage();
+				let newNotes = lineFootnotes(line);
+				const addedReserve = (sub) => sub.reduce((sum, x) => sum + x.heightPt, 0) + (pageNotes.length === 0 && sub.length > 0 ? FOOTNOTE_SEPARATOR_HEIGHT : 0);
+				if (cursorY - h < bottomLimit() + addedReserve(newNotes) && colHasContent()) {
+					advanceColumn();
+					newNotes = lineFootnotes(line);
+				}
+				if (newNotes.length > 0) {
+					noteReserve += addedReserve(newNotes);
+					for (const x of newNotes) {
+						placedNotes.add(x.id);
+						pageNotes.push({
+							n: x.n,
+							blocks: x.blocks,
+							heightPt: x.heightPt
+						});
+					}
+				}
+				if (firstLineOfBlock) {
+					firstLineOfBlock = false;
+					if (block.bookmarks && bookmarkPositions) {
+						for (const bookmarkName of block.bookmarks) if (!bookmarkPositions.has(bookmarkName)) bookmarkPositions.set(bookmarkName, {
+							pageIdx: pages.length,
+							yTopPt: cursorY
+						});
+					}
+				}
 				cursorY -= h;
 				const indentLeft = block.resolved.indentLeft + (line.firstLine ? block.resolved.indentFirstLine : 0);
 				const offset = alignmentOffset(block.resolved.alignment, line.contentWidthPt, line.availableWidthPt);
 				current.push({
 					type: "line",
 					line,
-					originX: pt(ctx.marginLeft + indentLeft + offset),
+					originX: pt(colLeft() + indentLeft + offset),
 					baselineY: pt(ctx.pageHeight - (cursorY + lineDescent(line))),
 					...structId !== void 0 ? { structId } : {}
 				});
@@ -1439,93 +1753,108 @@ function paginateSections(blocks, sectionCtxs, builder, defaultLang = "en-US") {
 			if (block.pageBreakAfter) pendingPageBreak = true;
 		} else if (block.kind === "image") {
 			const figId = builder ? createFigure(builder, block.altText, "Image") : void 0;
-			cursorY -= block.spacingBeforePt;
-			if (cursorY - block.heightPt < ctx.marginBottom && current.length > 0) flushPage();
-			cursorY -= block.heightPt;
-			current.push({
-				type: "image",
-				x: pt(ctx.marginLeft),
-				y: pt(ctx.pageHeight - cursorY - block.heightPt),
-				width: pt(block.widthPt),
-				height: pt(block.heightPt),
-				imageResourceName: block.resourceName,
-				...figId !== void 0 ? { structId: figId } : {}
-			});
-			cursorY -= block.spacingAfterPt;
+			const emitImageAt = (x, topYUp, sink) => {
+				sink.push({
+					type: "image",
+					x: pt(x),
+					y: pt(ctx.pageHeight - topYUp),
+					width: pt(block.widthPt),
+					height: pt(block.heightPt),
+					imageResourceName: block.resourceName,
+					...figId !== void 0 ? { structId: figId } : {}
+				});
+			};
+			if (block.float?.wrap === "none") emitImageAt(floatX(block.float, block.widthPt), floatTopYUp(block.float), block.float.behind ? floatsBehind : floatsFront);
+			else {
+				cursorY -= block.spacingBeforePt;
+				if (cursorY - block.heightPt < bottomLimit() && colHasContent()) advanceColumn();
+				cursorY -= block.heightPt;
+				emitImageAt(colLeft(), cursorY + block.heightPt, current);
+				cursorY -= block.spacingAfterPt;
+			}
 		} else if (block.kind === "shape") {
 			const figId = builder ? createFigure(builder, block.altText, "Shape") : void 0;
-			cursorY -= block.spacingBeforePt;
-			if (cursorY - block.heightPt < ctx.marginBottom && current.length > 0) flushPage();
-			cursorY -= block.heightPt;
-			const offset = alignmentOffset(block.resolvedAlignment, block.widthPt, ctx.contentWidth);
-			const x = ctx.marginLeft + offset;
-			const transform = flipTransform(buildShapeTransform(x, cursorY, block.widthPt, block.heightPt, block.rotation60k, block.flipH, block.flipV), ctx.pageHeight);
-			current.push({
-				type: "shape",
-				shape: {
-					paths: block.paths,
-					...block.fillColorHex ? { fillColorHex: block.fillColorHex } : {},
-					...block.stroke ? { stroke: block.stroke } : {},
-					transform
-				},
-				...figId !== void 0 ? { structId: figId } : {}
-			});
-			if (block.textLines.length > 0) {
-				const shapeBottom = cursorY;
-				const shapeTop = cursorY + block.heightPt;
-				const innerWidth = Math.max(1, block.widthPt - block.insetLeftPt - block.insetRightPt);
-				let textY;
-				if (block.anchor === "b") textY = shapeBottom + block.insetBottomPt + block.textHeightPt;
-				else if (block.anchor === "ctr") textY = shapeBottom + (block.heightPt + block.textHeightPt) / 2;
-				else textY = shapeTop - block.insetTopPt;
-				for (const line of block.textLines) {
-					const h = computeLineHeight(line, line.resolved);
-					textY -= h;
-					const lineOffset = alignmentOffset(line.resolved.alignment, line.contentWidthPt, innerWidth);
-					current.push({
-						type: "line",
-						line,
-						originX: pt(x + block.insetLeftPt + lineOffset),
-						baselineY: pt(ctx.pageHeight - (textY + lineDescent(line))),
-						...figId !== void 0 ? { structId: figId } : {}
-					});
+			const emitShapeAt = (x, bottomYUp, sink) => {
+				const transform = flipTransform(buildShapeTransform(x, bottomYUp, block.widthPt, block.heightPt, block.rotation60k, block.flipH, block.flipV), ctx.pageHeight);
+				sink.push({
+					type: "shape",
+					shape: {
+						paths: block.paths,
+						...block.fillColorHex ? { fillColorHex: block.fillColorHex } : {},
+						...block.stroke ? { stroke: block.stroke } : {},
+						transform
+					},
+					...figId !== void 0 ? { structId: figId } : {}
+				});
+				if (block.textLines.length > 0) {
+					const shapeBottom = bottomYUp;
+					const shapeTop = bottomYUp + block.heightPt;
+					const innerWidth = Math.max(1, block.widthPt - block.insetLeftPt - block.insetRightPt);
+					let textY;
+					if (block.anchor === "b") textY = shapeBottom + block.insetBottomPt + block.textHeightPt;
+					else if (block.anchor === "ctr") textY = shapeBottom + (block.heightPt + block.textHeightPt) / 2;
+					else textY = shapeTop - block.insetTopPt;
+					for (const line of block.textLines) {
+						const h = computeLineHeight(line, line.resolved);
+						textY -= h;
+						const lineOffset = alignmentOffset(line.resolved.alignment, line.contentWidthPt, innerWidth);
+						sink.push({
+							type: "line",
+							line,
+							originX: pt(x + block.insetLeftPt + lineOffset),
+							baselineY: pt(ctx.pageHeight - (textY + lineDescent(line))),
+							...figId !== void 0 ? { structId: figId } : {}
+						});
+					}
 				}
+			};
+			if (block.float?.wrap === "none") emitShapeAt(floatX(block.float, block.widthPt), floatTopYUp(block.float) - block.heightPt, block.float.behind ? floatsBehind : floatsFront);
+			else {
+				cursorY -= block.spacingBeforePt;
+				if (cursorY - block.heightPt < bottomLimit() && colHasContent()) advanceColumn();
+				cursorY -= block.heightPt;
+				const offset = alignmentOffset(block.resolvedAlignment, block.widthPt, colWidth());
+				emitShapeAt(colLeft() + offset, cursorY, current);
+				cursorY -= block.spacingAfterPt;
 			}
-			cursorY -= block.spacingAfterPt;
 		} else if (block.kind === "chart") {
 			const figId = builder ? createFigure(builder, block.altText, "Chart") : void 0;
 			const fig = figId !== void 0 ? { structId: figId } : {};
-			cursorY -= block.spacingBeforePt;
-			if (cursorY - block.heightPt < ctx.marginBottom && current.length > 0) flushPage();
-			cursorY -= block.heightPt;
-			const offset = alignmentOffset(block.resolvedAlignment, block.widthPt, ctx.contentWidth);
-			const x = ctx.marginLeft + offset;
-			const y = cursorY;
-			for (const s of block.layout.shapes) current.push({
-				type: "shape",
-				shape: {
-					paths: s.paths,
-					...s.fillColorHex ? { fillColorHex: s.fillColorHex } : {},
-					...s.stroke ? { stroke: s.stroke } : {},
-					transform: flipTransform([
-						1,
-						0,
-						0,
-						1,
-						x,
-						y
-					], ctx.pageHeight)
-				},
-				...fig
-			});
-			for (const t of block.layout.texts) current.push({
-				type: "line",
-				line: t.line,
-				originX: pt(x + t.x),
-				baselineY: pt(ctx.pageHeight - (y + t.y)),
-				...fig
-			});
-			cursorY -= block.spacingAfterPt;
+			const emitChartAt = (x, bottomYUp, sink) => {
+				for (const s of block.layout.shapes) sink.push({
+					type: "shape",
+					shape: {
+						paths: s.paths,
+						...s.fillColorHex ? { fillColorHex: s.fillColorHex } : {},
+						...s.stroke ? { stroke: s.stroke } : {},
+						transform: flipTransform([
+							1,
+							0,
+							0,
+							1,
+							x,
+							bottomYUp
+						], ctx.pageHeight)
+					},
+					...fig
+				});
+				for (const t of block.layout.texts) sink.push({
+					type: "line",
+					line: t.line,
+					originX: pt(x + t.x),
+					baselineY: pt(ctx.pageHeight - (bottomYUp + t.y)),
+					...fig
+				});
+			};
+			if (block.float?.wrap === "none") emitChartAt(floatX(block.float, block.widthPt), floatTopYUp(block.float) - block.heightPt, block.float.behind ? floatsBehind : floatsFront);
+			else {
+				cursorY -= block.spacingBeforePt;
+				if (cursorY - block.heightPt < bottomLimit() && colHasContent()) advanceColumn();
+				cursorY -= block.heightPt;
+				const offset = alignmentOffset(block.resolvedAlignment, block.widthPt, colWidth());
+				emitChartAt(colLeft() + offset, cursorY, current);
+				cursorY -= block.spacingAfterPt;
+			}
 		} else {
 			const colCount = block.rows.reduce((max, r) => Math.max(max, r.cells.reduce((s, c) => Math.max(s, c.colStart + c.colSpan), 0)), 0);
 			const headerRows = [];
@@ -1533,7 +1862,7 @@ function paginateSections(blocks, sectionCtxs, builder, defaultLang = "en-US") {
 			else break;
 			const headerHeightPt = headerRows.reduce((s, r) => s + r.heightPt, 0);
 			const tableNode = builder ? builder.create("Table", builder.root) : void 0;
-			const tableX = ctx.marginLeft + block.xOffsetPt;
+			const tableX = colLeft() + block.xOffsetPt;
 			for (let ri = 0; ri < block.rows.length; ri++) {
 				const row = block.rows[ri];
 				const isLeadingHeader = ri < headerRows.length;
@@ -1555,10 +1884,11 @@ function paginateSections(blocks, sectionCtxs, builder, defaultLang = "en-US") {
 				for (let ci = 0; ci < chunks.length; ci++) {
 					const chunk = chunks[ci];
 					const forcedBreak = ci === 0 && row.breakBefore && !isLeadingHeader && current.length > 0;
-					const overflow = cursorY - chunk.heightPt < ctx.marginBottom && current.length > 0;
+					const overflow = cursorY - chunk.heightPt < bottomLimit() && colHasContent();
 					if (forcedBreak || overflow) {
-						flushPage();
-						if (!isLeadingHeader && headerRows.length > 0 && cursorY - headerHeightPt - chunk.heightPt >= ctx.marginBottom) for (const hr of headerRows) {
+						if (forcedBreak) flushPage();
+						else advanceColumn();
+						if (!isLeadingHeader && headerRows.length > 0 && cursorY - headerHeightPt - chunk.heightPt >= bottomLimit()) for (const hr of headerRows) {
 							emitRowChunk(current, hr, tableX, cursorY, ctx.pageHeight, colCount, void 0);
 							cursorY -= hr.heightPt;
 						}
@@ -1571,6 +1901,12 @@ function paginateSections(blocks, sectionCtxs, builder, defaultLang = "en-US") {
 	}
 	flushPage();
 	if (pages.length === 0) flushPage(true);
+	for (const d of dynBands) {
+		const cmds = d.render(d.pageNumber, pages.length);
+		const page = pages[d.pageIdx];
+		if (d.position === "header") page.commands.unshift(...cmds);
+		else page.commands.push(...cmds);
+	}
 	return pages;
 }
 function tableCellRowSpan(rows, startRowIdx, colStart) {