@stll/folio-core 0.36.0 → 0.37.0

package/dist/layout-bridge/dom/clickToPositionDom.d.ts

@@ -86,6 +86,13 @@ type CollapsedLineEdgeCaretTarget = {
  * cannot decide which span owns a boundary.
  */
 declare function findCollapsedLineEdgeCaretTarget(spans: readonly HTMLElement[], pmPos: number): CollapsedLineEdgeCaretTarget | null;
+/**
+ * Map an unpainted inline position inside a paragraph to the nearest painted
+ * span boundary. Inline metadata and folded fields occupy ProseMirror
+ * positions without emitting glyphs; their carets belong at the adjacent text
+ * slot, not at the paragraph box's physical edge.
+ */
+declare function findParagraphGapCaretTarget(container: ParentNode, pmPos: number): CollapsedLineEdgeCaretTarget | null;
 declare function getCaretPositionFromDom(container: HTMLElement, pmPos: number, overlayRect: DOMRect): DomCaretPosition | null;
 //#endregion
-export { CollapsedLineEdgeCaretGeometry, CollapsedLineEdgeCaretTarget, DomCaretPosition, DomSelectionRect, clickToPositionDom, findCollapsedLineEdgeCaretTarget, findPositionInSpan, getCaretPositionFromDom, getCollapsedLineEdgeCaretGeometry, getSelectionRectsFromDom };
+export { CollapsedLineEdgeCaretGeometry, CollapsedLineEdgeCaretTarget, DomCaretPosition, DomSelectionRect, clickToPositionDom, findCollapsedLineEdgeCaretTarget, findParagraphGapCaretTarget, findPositionInSpan, getCaretPositionFromDom, getCollapsedLineEdgeCaretGeometry, getSelectionRectsFromDom };

package/dist/layout-bridge/dom/clickToPositionDom.js

@@ -1,4 +1,5 @@
 import { closestHtmlElement, findHtmlElement, htmlQueryAll, queryHtmlElement } from "../../utils/domGuards.js";
+import { descendantTextNodes, logicalTextOffset, measurePaintedSpanRange, textBoundaryAt, totalTextLength } from "./textStreamDom.js";
 //#region src/layout-bridge/dom/clickToPositionDom.ts
 /**
 * DOM-based Click-to-Position Mapping
@@ -57,28 +58,30 @@ function findPositionInSpan(spanEl, clientX, clientY) {
 		const rect = spanEl.getBoundingClientRect();
 		return clientX < (rect.left + rect.right) / 2 ? pmStart : pmEnd;
 	}
-	const textNode = spanEl.firstChild;
-	if (!textNode || textNode.nodeType !== Node.TEXT_NODE) return pmStart;
-	const text = textNode;
-	const textLength = text.length;
-	if (textLength === 0) return pmStart;
+	const textNodes = descendantTextNodes(spanEl);
+	if (textNodes.length === 0) return pmStart;
+	if (totalTextLength(textNodes) === 0) return pmStart;
 	const ownerDoc = spanEl.ownerDocument;
-	const native = caretOffsetFromPoint(ownerDoc, text, clientX, clientY);
+	const native = caretOffsetFromPoint(ownerDoc, textNodes, clientX, clientY);
 	if (native !== null) return pmStart + Math.min(native, pmEnd - pmStart);
 	const range = ownerDoc.createRange();
 	let bestOffset = 0;
 	let bestDistance = Number.POSITIVE_INFINITY;
-	for (let i = 0; i < textLength; i++) {
-		range.setStart(text, i);
-		range.setEnd(text, i + 1);
-		const rect = range.getBoundingClientRect();
-		if (rect.width === 0 && rect.height === 0) continue;
-		const midpoint = rect.left + rect.width / 2;
-		const distance = Math.abs(clientX - midpoint);
-		if (distance < bestDistance) {
-			bestDistance = distance;
-			bestOffset = clientX < midpoint ? i : i + 1;
+	let charsProcessed = 0;
+	for (const text of textNodes) {
+		for (let i = 0; i < text.length; i++) {
+			range.setStart(text, i);
+			range.setEnd(text, i + 1);
+			const rect = range.getBoundingClientRect();
+			if (rect.width === 0 && rect.height === 0) continue;
+			const midpoint = rect.left + rect.width / 2;
+			const distance = Math.abs(clientX - midpoint);
+			if (distance < bestDistance) {
+				bestDistance = distance;
+				bestOffset = charsProcessed + (clientX < midpoint ? i : i + 1);
+			}
 		}
+		charsProcessed += text.length;
 	}
 	return pmStart + Math.min(bestOffset, pmEnd - pmStart);
 }
@@ -89,15 +92,21 @@ function findPositionInSpan(spanEl, clientX, clientY) {
 * a different node — callers fall back to a glyph-by-glyph
 * scan in that case.
 */
-function caretOffsetFromPoint(ownerDoc, text, clientX, clientY) {
+function caretOffsetFromPoint(ownerDoc, textNodes, clientX, clientY) {
 	const doc = ownerDoc;
 	if (typeof doc.caretPositionFromPoint === "function") {
 		const pos = doc.caretPositionFromPoint(clientX, clientY);
-		if (pos && pos.offsetNode === text) return pos.offset;
+		if (pos) {
+			const offset = logicalTextOffset(textNodes, pos.offsetNode, pos.offset);
+			if (offset !== null) return offset;
+		}
 	}
 	if (typeof doc.caretRangeFromPoint === "function") {
 		const range = doc.caretRangeFromPoint(clientX, clientY);
-		if (range && range.startContainer === text) return range.startOffset;
+		if (range) {
+			const offset = logicalTextOffset(textNodes, range.startContainer, range.startOffset);
+			if (offset !== null) return offset;
+		}
 	}
 	return null;
 }
@@ -200,22 +209,12 @@ function getSelectionRectsFromDom(container, from, to, overlayRect) {
 	const rects = [];
 	const spans = htmlQueryAll(container, ".layout-page-content span[data-pm-start][data-pm-end]");
 	for (const spanEl of spans) {
-		const pmStart = Number(spanEl.dataset["pmStart"]);
-		if (Number(spanEl.dataset["pmEnd"]) <= from || pmStart >= to) continue;
-		const textNode = spanEl.firstChild;
-		if (!textNode || textNode.nodeType !== Node.TEXT_NODE) continue;
-		const text = textNode;
-		const ownerDoc = spanEl.ownerDocument;
-		const startChar = Math.max(0, from - pmStart);
-		const endChar = Math.min(text.length, to - pmStart);
-		if (startChar >= endChar) continue;
-		const range = ownerDoc.createRange();
-		range.setStart(text, startChar);
-		range.setEnd(text, endChar);
-		const clientRects = range.getClientRects();
+		const measurement = measurePaintedSpanRange(spanEl, from, to);
+		if (measurement.type === "outside") continue;
 		const pageEl = closestHtmlElement(spanEl, ".layout-page");
 		const pageIndex = pageEl ? Number(pageEl.dataset["pageNumber"] || 1) - 1 : 0;
-		for (const clientRect of Array.from(clientRects)) rects.push({
+		const clientRects = measurement.type === "element" ? [measurement.rect] : measurement.rects;
+		for (const clientRect of clientRects) rects.push({
 			x: clientRect.left - overlayRect.left,
 			y: clientRect.top - overlayRect.top,
 			width: clientRect.width,
@@ -273,6 +272,70 @@ function findCollapsedLineEdgeCaretTarget(spans, pmPos) {
 	}
 	return null;
 }
+const getPaintedSpanCaretGeometry = (span, pmPos) => {
+	const collapsed = getCollapsedLineEdgeCaretGeometry(span, pmPos);
+	if (collapsed) return collapsed;
+	const spanRect = span.getBoundingClientRect();
+	const lineHeight = closestHtmlElement(span, ".layout-line")?.getBoundingClientRect().height || spanRect.height || 16;
+	if (span.classList.contains("layout-run-tab")) return {
+		left: pmPos >= Number(span.dataset["pmEnd"]) ? spanRect.right : spanRect.left,
+		top: spanRect.top,
+		height: lineHeight
+	};
+	const textNodes = descendantTextNodes(span);
+	if (textNodes.length === 0) return {
+		left: spanRect.left,
+		top: spanRect.top,
+		height: lineHeight
+	};
+	const pmStart = Number(span.dataset["pmStart"]);
+	const boundary = textBoundaryAt(textNodes, Math.min(Math.max(0, pmPos - pmStart), totalTextLength(textNodes)), "start");
+	if (!boundary) return {
+		left: spanRect.left,
+		top: spanRect.top,
+		height: lineHeight
+	};
+	const range = span.ownerDocument.createRange();
+	range.setStart(boundary.node, boundary.offset);
+	range.setEnd(boundary.node, boundary.offset);
+	const rangeRect = range.getBoundingClientRect();
+	return {
+		left: rangeRect.left,
+		top: rangeRect.top,
+		height: rangeRect.height || lineHeight
+	};
+};
+/**
+* Map an unpainted inline position inside a paragraph to the nearest painted
+* span boundary. Inline metadata and folded fields occupy ProseMirror
+* positions without emitting glyphs; their carets belong at the adjacent text
+* slot, not at the paragraph box's physical edge.
+*/
+function findParagraphGapCaretTarget(container, pmPos) {
+	let best;
+	for (const paragraph of htmlQueryAll(container, ".layout-page-content .layout-paragraph")) {
+		const paragraphStart = Number(paragraph.dataset["pmStart"]);
+		const paragraphEnd = Number(paragraph.dataset["pmEnd"]);
+		if (!(pmPos > paragraphStart && pmPos < paragraphEnd)) continue;
+		for (const span of htmlQueryAll(paragraph, "span[data-pm-start][data-pm-end]")) {
+			const spanStart = Number(span.dataset["pmStart"]);
+			const spanEnd = Number(span.dataset["pmEnd"]);
+			if (!Number.isFinite(spanStart) || !Number.isFinite(spanEnd)) continue;
+			const boundaryPos = pmPos < spanStart ? spanStart : spanEnd;
+			const distance = Math.abs(boundaryPos - pmPos);
+			if (!best || distance < best.distance) best = {
+				span,
+				boundaryPos,
+				distance
+			};
+		}
+	}
+	if (!best) return null;
+	return {
+		span: best.span,
+		geometry: getPaintedSpanCaretGeometry(best.span, best.boundaryPos)
+	};
+}
 function getCaretPositionFromDom(container, pmPos, overlayRect) {
 	const spans = htmlQueryAll(container, ".layout-page-content span[data-pm-start][data-pm-end]");
 	const collapsedTarget = findCollapsedLineEdgeCaretTarget(spans, pmPos);
@@ -306,8 +369,8 @@ function getCaretPositionFromDom(container, pmPos, overlayRect) {
 			continue;
 		}
 		if (pmPos >= pmStart && pmPos <= pmEnd) {
-			const textNode = spanEl.firstChild;
-			if (!textNode || textNode.nodeType !== Node.TEXT_NODE) {
+			const textNodes = descendantTextNodes(spanEl);
+			if (textNodes.length === 0) {
 				const spanRect = spanEl.getBoundingClientRect();
 				const pageEl = closestHtmlElement(spanEl, ".layout-page");
 				const pageIndex = pageEl ? Number(pageEl.dataset["pageNumber"] || 1) - 1 : 0;
@@ -320,11 +383,11 @@ function getCaretPositionFromDom(container, pmPos, overlayRect) {
 					pageIndex
 				};
 			}
-			const text = textNode;
-			const charIndex = Math.min(pmPos - pmStart, text.length);
+			const boundary = textBoundaryAt(textNodes, Math.min(pmPos - pmStart, totalTextLength(textNodes)), "start");
+			if (!boundary) continue;
 			const range = spanEl.ownerDocument.createRange();
-			range.setStart(text, charIndex);
-			range.setEnd(text, charIndex);
+			range.setStart(boundary.node, boundary.offset);
+			range.setEnd(boundary.node, boundary.offset);
 			const rangeRect = range.getBoundingClientRect();
 			const pageEl = closestHtmlElement(spanEl, ".layout-page");
 			const pageIndex = pageEl ? Number(pageEl.dataset["pageNumber"] || 1) - 1 : 0;
@@ -338,6 +401,17 @@ function getCaretPositionFromDom(container, pmPos, overlayRect) {
 			};
 		}
 	}
+	const gapTarget = findParagraphGapCaretTarget(container, pmPos);
+	if (gapTarget) {
+		const pageEl = closestHtmlElement(gapTarget.span, ".layout-page");
+		const pageIndex = pageEl ? Number(pageEl.dataset["pageNumber"] || 1) - 1 : 0;
+		return {
+			x: gapTarget.geometry.left - overlayRect.left,
+			y: gapTarget.geometry.top - overlayRect.top,
+			height: gapTarget.geometry.height,
+			pageIndex
+		};
+	}
 	const paragraphs = htmlQueryAll(container, ".layout-paragraph");
 	for (const pEl of paragraphs) {
 		const pStart = Number(pEl.dataset["pmStart"]);
@@ -360,4 +434,4 @@ function getCaretPositionFromDom(container, pmPos, overlayRect) {
 	return null;
 }
 //#endregion
-export { clickToPositionDom, findCollapsedLineEdgeCaretTarget, findPositionInSpan, getCaretPositionFromDom, getCollapsedLineEdgeCaretGeometry, getSelectionRectsFromDom };
+export { clickToPositionDom, findCollapsedLineEdgeCaretTarget, findParagraphGapCaretTarget, findPositionInSpan, getCaretPositionFromDom, getCollapsedLineEdgeCaretGeometry, getSelectionRectsFromDom };

package/dist/layout-bridge/dom/textStreamDom.d.ts

@@ -0,0 +1,24 @@
+//#region src/layout-bridge/dom/textStreamDom.d.ts
+type TextBoundary = {
+  node: Text;
+  offset: number;
+};
+type PaintedSpanRangeMeasurement = {
+  type: "outside";
+} | {
+  type: "element";
+  rect: DOMRect;
+} | {
+  type: "text";
+  rects: DOMRect[];
+};
+/** Treat every descendant text node as one logical character stream. */
+declare const descendantTextNodes: (root: Node) => Text[];
+declare const totalTextLength: (nodes: readonly Text[]) => number;
+declare const textBoundaryAt: (nodes: readonly Text[], offset: number, edge: "start" | "end") => TextBoundary | null;
+declare const logicalTextOffset: (nodes: readonly Text[], target: Node, offset: number) => number | null;
+declare const createTextStreamRange: (element: HTMLElement, startOffset: number, endOffset: number) => Range | null;
+/** Measure the intersecting portion of one painted position span. */
+declare const measurePaintedSpanRange: (element: HTMLElement, from: number, to: number) => PaintedSpanRangeMeasurement;
+//#endregion
+export { PaintedSpanRangeMeasurement, TextBoundary, createTextStreamRange, descendantTextNodes, logicalTextOffset, measurePaintedSpanRange, textBoundaryAt, totalTextLength };

package/dist/layout-bridge/dom/textStreamDom.js

@@ -0,0 +1,75 @@
+//#region src/layout-bridge/dom/textStreamDom.ts
+const TEXT_NODE_TYPE = 3;
+const isTextNode = (node) => node.nodeType === TEXT_NODE_TYPE;
+/** Treat every descendant text node as one logical character stream. */
+const descendantTextNodes = (root) => {
+	const nodes = [];
+	const visit = (node) => {
+		if (isTextNode(node)) {
+			nodes.push(node);
+			return;
+		}
+		for (const child of node.childNodes) visit(child);
+	};
+	visit(root);
+	return nodes;
+};
+const totalTextLength = (nodes) => {
+	let length = 0;
+	for (const node of nodes) length += node.length;
+	return length;
+};
+const textBoundaryAt = (nodes, offset, edge) => {
+	let consumed = 0;
+	for (const [index, node] of nodes.entries()) {
+		const next = consumed + node.length;
+		if (offset < next || edge === "end" && offset === next || index === nodes.length - 1) return {
+			node,
+			offset: Math.max(0, Math.min(node.length, offset - consumed))
+		};
+		consumed = next;
+	}
+	return null;
+};
+const logicalTextOffset = (nodes, target, offset) => {
+	let consumed = 0;
+	for (const text of nodes) {
+		if (text === target) return consumed + Math.max(0, Math.min(text.length, offset));
+		consumed += text.length;
+	}
+	return null;
+};
+const createTextStreamRange = (element, startOffset, endOffset) => {
+	const nodes = descendantTextNodes(element);
+	const length = totalTextLength(nodes);
+	const boundedStart = Math.max(0, Math.min(length, startOffset));
+	const boundedEnd = Math.max(0, Math.min(length, endOffset));
+	const start = textBoundaryAt(nodes, boundedStart, "start");
+	const end = textBoundaryAt(nodes, boundedEnd, boundedStart === boundedEnd ? "start" : "end");
+	if (!start || !end) return null;
+	const range = element.ownerDocument.createRange();
+	range.setStart(start.node, start.offset);
+	range.setEnd(end.node, end.offset);
+	return range;
+};
+/** Measure the intersecting portion of one painted position span. */
+const measurePaintedSpanRange = (element, from, to) => {
+	const pmStart = Number(element.dataset["pmStart"]);
+	const pmEnd = Number(element.dataset["pmEnd"]);
+	if (!Number.isFinite(pmStart) || !Number.isFinite(pmEnd) || pmEnd <= from || pmStart >= to) return { type: "outside" };
+	if (element.classList.contains("layout-run-tab")) return {
+		type: "element",
+		rect: element.getBoundingClientRect()
+	};
+	const textNodes = descendantTextNodes(element);
+	const startOffset = Math.max(0, from - pmStart);
+	const endOffset = Math.min(totalTextLength(textNodes), to - pmStart);
+	if (startOffset >= endOffset) return { type: "outside" };
+	const range = createTextStreamRange(element, startOffset, endOffset);
+	return range ? {
+		type: "text",
+		rects: Array.from(range.getClientRects())
+	} : { type: "outside" };
+};
+//#endregion
+export { createTextStreamRange, descendantTextNodes, logicalTextOffset, measurePaintedSpanRange, textBoundaryAt, totalTextLength };

package/dist/layout-bridge/headerFooterLayout.js

@@ -1,4 +1,5 @@
 import { getCollapsedLineEdgeCaretGeometry } from "./dom/clickToPositionDom.js";
+import { createTextStreamRange, descendantTextNodes, totalTextLength } from "./dom/textStreamDom.js";
 //#region src/layout-bridge/headerFooterLayout.ts
 const hfDomCache = {
 	header: null,
@@ -75,27 +76,15 @@ function computeHfCaretRectFromView(view, section, doc = globalThis.document) {
 				left: collapsedGeometry.left,
 				height: collapsedGeometry.height
 			};
-			const range = host.ownerDocument.createRange();
-			const walker = host.ownerDocument.createTreeWalker(span, NodeFilter.SHOW_TEXT);
-			let remaining = pmPos - start;
-			let textNode = walker.nextNode();
-			while (textNode) {
-				const len = textNode.data.length;
-				if (remaining <= len) {
-					try {
-						range.setStart(textNode, remaining);
-						range.setEnd(textNode, remaining);
-						const rect = range.getClientRects()[0] ?? range.getBoundingClientRect();
-						if (rect && rect.height > 0) return {
-							top: rect.top,
-							left: rect.left,
-							height: rect.height
-						};
-					} catch {}
-					break;
-				}
-				remaining -= len;
-				textNode = walker.nextNode();
+			const offset = Math.min(pmPos - start, totalTextLength(descendantTextNodes(span)));
+			const range = createTextStreamRange(span, offset, offset);
+			if (range) {
+				const rect = range.getClientRects()[0] ?? range.getBoundingClientRect();
+				if (rect && rect.height > 0) return {
+					top: rect.top,
+					left: rect.left,
+					height: rect.height
+				};
 			}
 			const spanRect = span.getBoundingClientRect();
 			const ratio = (pmPos - start) / Math.max(1, end - start);
@@ -184,7 +173,7 @@ function computeHfSelectionRectsFromView(view, section, doc = globalThis.documen
 	const out = [];
 	const snapshot = getHfDomSnapshot(section, doc);
 	if (!snapshot) return out;
-	const { host, spans } = snapshot;
+	const { spans } = snapshot;
 	for (const spanEl of spans) {
 		const pmStart = Number(spanEl.dataset["pmStart"]);
 		const pmEnd = Number(spanEl.dataset["pmEnd"]);
@@ -200,16 +189,13 @@ function computeHfSelectionRectsFromView(view, section, doc = globalThis.documen
 			});
 			continue;
 		}
-		let textNode = null;
-		if (spanEl.firstChild?.nodeType === Node.TEXT_NODE) textNode = spanEl.firstChild;
-		else if (spanEl.firstChild?.nodeType === Node.ELEMENT_NODE && spanEl.firstChild.tagName === "A" && spanEl.firstChild.firstChild?.nodeType === Node.TEXT_NODE) textNode = spanEl.firstChild.firstChild;
-		if (!textNode) continue;
+		const textNodes = descendantTextNodes(spanEl);
+		if (textNodes.length === 0) continue;
 		const startChar = Math.max(0, from - pmStart);
-		const endChar = Math.min(textNode.length, to - pmStart);
+		const endChar = Math.min(totalTextLength(textNodes), to - pmStart);
 		if (startChar >= endChar) continue;
-		const range = host.ownerDocument.createRange();
-		range.setStart(textNode, startChar);
-		range.setEnd(textNode, endChar);
+		const range = createTextStreamRange(spanEl, startChar, endChar);
+		if (!range) continue;
 		for (const rect of Array.from(range.getClientRects())) out.push({
 			top: rect.top,
 			left: rect.left,

package/dist/layout-engine/index.js

@@ -894,7 +894,7 @@ function layoutTextBox(block, measure, { paginator, sectionMarginTop, sectionPag
 			kind: "textBox",
 			blockId: block.id,
 			x,
-			y: state.topMargin + bandTop,
+			y: block.position?.vertical?.relativeTo === "page" ? sectionMarginTop + bandTop : state.topMargin + bandTop,
 			width: measure.width,
 			height: measure.height,
 			isPositioned: true,
@@ -916,12 +916,21 @@ function layoutTextBox(block, measure, { paginator, sectionMarginTop, sectionPag
 		const vertical = block.position.vertical;
 		const anchorBlockId = readTextBoxAnchorBlockId(block);
 		const anchorParagraph = vertical?.relativeTo === "paragraph" && typeof anchorBlockId === "string" ? state.page.fragments.find((fragment) => fragment.kind === "paragraph" && fragment.blockId === anchorBlockId) : void 0;
-		const y = isPageFrameRelativeAnchor(vertical?.relativeTo) ? state.topMargin + bandTopContentY(vertical, {
+		const bandGeometry = {
 			pageHeight: sectionPageHeight,
 			marginTop: sectionMarginTop,
 			marginBottom: sectionMarginBottom,
 			boxHeight: measure.height
-		}) : (anchorParagraph?.y ?? state.cursorY) + emuToPixels(vertical?.posOffset ?? 0);
+		};
+		let y;
+		if (vertical?.relativeTo === "page") y = sectionMarginTop + bandTopContentY(vertical, bandGeometry);
+		else if (isPageFrameRelativeAnchor(vertical?.relativeTo)) y = state.topMargin + bandTopContentY(vertical, {
+			pageHeight: sectionPageHeight,
+			marginTop: sectionMarginTop,
+			marginBottom: sectionMarginBottom,
+			boxHeight: measure.height
+		});
+		else y = (anchorParagraph?.y ?? state.cursorY) + emuToPixels(vertical?.posOffset ?? 0);
 		const fragment = {
 			kind: "textBox",
 			blockId: block.id,

package/dist/layout-engine/measure/tableFragmentBorderGeometry.d.ts

@@ -0,0 +1,17 @@
+import { CellBorderSpec, TableBlock, TableFragment, TableMeasure } from "../types.js";
+import { TableCellPlacements } from "./tableCellGrid.js";
+//#region src/layout-engine/measure/tableFragmentBorderGeometry.d.ts
+type TableFragmentBottomBorder = {
+  readonly left: number;
+  readonly width: number;
+  readonly border: CellBorderSpec;
+};
+type TableFragmentBottomBordersOptions = {
+  readonly fragment: TableFragment;
+  readonly block: TableBlock;
+  readonly measure: TableMeasure;
+  readonly placements?: TableCellPlacements;
+};
+declare const tableFragmentBottomBorders: ({ fragment, block, measure, placements: suppliedPlacements }: TableFragmentBottomBordersOptions) => readonly TableFragmentBottomBorder[];
+//#endregion
+export { tableFragmentBottomBorders };

package/dist/layout-engine/measure/tableFragmentBorderGeometry.js

@@ -0,0 +1,24 @@
+import { buildTableCellGrid, buildTableCellPlacements } from "./tableCellGrid.js";
+//#region src/layout-engine/measure/tableFragmentBorderGeometry.ts
+const isVisible = (border) => border !== void 0 && border.style !== "none" && border.style !== "nil";
+const tableFragmentBottomBorders = ({ fragment, block, measure, placements: suppliedPlacements }) => {
+	if (fragment.continuesOnNext !== true || fragment.bottomClip === void 0) return [];
+	const splitRow = block.rows.at(fragment.toRow - 1);
+	if (!splitRow) return [];
+	const placements = suppliedPlacements ?? buildTableCellPlacements({
+		grid: buildTableCellGrid(block.rows, measure.columnWidths.length),
+		columnWidths: measure.columnWidths,
+		bidi: block.bidi === true
+	});
+	return splitRow.cells.flatMap((cell) => {
+		const placement = placements.get(cell);
+		const border = cell.borders?.bottom;
+		return placement && isVisible(border) ? [{
+			left: placement.left,
+			width: placement.width,
+			border
+		}] : [];
+	});
+};
+//#endregion
+export { tableFragmentBottomBorders };

package/dist/layout-engine/renderedBreakReconciliation.js

@@ -34,7 +34,7 @@ const reconcileBreakBeforeBlock = ({ state, block, previousBlock, page, blocksBy
 		state
 	};
 	const markerAlreadySatisfied = pageStartsWithPreviousParagraphContinuation(page, previousBlock) || state.type === "pageAdvance" && state.reason === "authoredBoundary" || state.type === "pageAdvance" && state.reason === "reflowBoundary" || state.type === "pageAdvance" && isPaginationEmptyParagraph(block) || state.type === "pageAdvance" && (continuesNumberedSequence(previousBlock, block) || continuesTabbedParagraphSequence(previousBlock, block));
-	const forcePageBreak = (renderedBreakNeedsSnap || block.attrs?.keepNext === true || (block.attrs?.spacing?.before ?? 0) > 0 && previousBlock?.kind !== "sectionBreak" || previousBlock?.kind === "table") && !markerAlreadySatisfied && pageHasVisibleBodyContent(page, blocksById);
+	const forcePageBreak = (renderedBreakNeedsSnap || (block.attrs?.spacing?.before ?? 0) > 0 && block.attrs?.keepNext !== true && previousBlock?.kind !== "sectionBreak" || previousBlock?.kind === "table") && !markerAlreadySatisfied && pageHasVisibleBodyContent(page, blocksById);
 	const followsAuthoredPageBreak = previousBlock?.kind === "pageBreak";
 	const followsSectionBreak = previousBlock?.kind === "sectionBreak";
 	const followsPageBreakingSection = followsSectionBreak && previousBlock.type !== "continuous";

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

@@ -748,6 +748,13 @@ type PageHeaderFooterRefs = {
 type PageBreakBlock = {
   kind: "pageBreak";
   id: BlockId;
+  /** Revision metadata when the structural boundary is newly authored. */
+  isInsertion?: boolean;
+  changeAuthor?: string;
+  changeDate?: string;
+  changeRevisionId?: number;
+  isSuggestion?: boolean;
+  suggestionId?: string;
   pmStart?: number;
   pmEnd?: number;
 };

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

@@ -1,5 +1,5 @@
-import { FlowBlock, Measure } from "../layout-engine/types.js";
 import { ImageAttrs } from "../prosemirror/schema/nodes.js";
+import { FlowBlock, Measure } from "../layout-engine/types.js";
 import { BlockLookup } from "./index.js";
 import { WrapType } from "../types/wrap.js";
 //#region src/layout-painter/imageLayout.d.ts

package/dist/layout-painter/renderTable.js

@@ -2,6 +2,7 @@ import { measureParagraph } from "../layout-engine/measure/measureParagraph.js";
 import { buildTableCellFloatingZones, getTableCellContentWidth, getTableCellFloatingImages } from "../layout-engine/measure/tableCellFloating.js";
 import { createTableCellFlowState, finishTableCellFlow, placeTableCellBlock } from "../layout-engine/measure/tableCellFlow.js";
 import { buildTableCellGrid, buildTableCellPlacements, getSourceCellAt } from "../layout-engine/measure/tableCellGrid.js";
+import { tableFragmentBottomBorders } from "../layout-engine/measure/tableFragmentBorderGeometry.js";
 import { resolveTableInlineOffset, resolveTableInlinePlacement } from "../layout-engine/measure/tableInlinePlacement.js";
 import { isFloatingImageRun, isFloatingTextBoxBlock, resolveTableCellPadding, tableColumnsArePinned } from "../layout-engine/types.js";
 import { applySanitizedImageSrc } from "../utils/sanitizeImageSrc.js";
@@ -727,6 +728,25 @@ function renderTableFragment(fragment, block, measure, context, options = {}) {
 		contentParent.append(rowEl);
 		y += rowMeasure.height;
 	}
+	for (const { left, width, border } of tableFragmentBottomBorders({
+		fragment,
+		block,
+		measure,
+		placements: cellPlacements
+	})) {
+		const borderEl = doc.createElement("div");
+		borderEl.className = CELL_BOTTOM_BORDER_CLASS;
+		borderEl.style.position = "absolute";
+		borderEl.style.left = `${left}px`;
+		borderEl.style.top = "0";
+		borderEl.style.width = `${width}px`;
+		borderEl.style.height = `${fragment.height}px`;
+		borderEl.style.boxSizing = "border-box";
+		borderEl.style.pointerEvents = "none";
+		borderEl.style.zIndex = "1";
+		applyBorder(borderEl, "bottom", border);
+		tableEl.append(borderEl);
+	}
 	let handleY = 0;
 	for (let rowIdx = fragment.fromRow; rowIdx < fragment.toRow; rowIdx++) {
 		if (block.rows[rowIdx]?.hidden) continue;

package/dist/model.d.ts

@@ -1,6 +1,6 @@
 import { document_d_exports } from "./types/document.js";
-import { DeriveBlockIdInput, FolioBlockId, currentFolioBlockId, deriveBlankBlockId, deriveBlockId, getFolioParaIdFromBlockId, getSequentialFolioBlockIdIndex, isBlankFolioBlockId, isFolioBlockId, isSequentialFolioBlockId } from "./types/block-id.js";
 import { BORDER_STYLE_VALUES, CONDITIONAL_STYLE_TYPE_VALUES, EMPHASIS_MARK_VALUES, FIELD_TYPE_VALUES, FLOATING_TABLE_X_SPEC_VALUES, FLOATING_TABLE_Y_SPEC_VALUES, FONT_HINT_VALUES, FONT_THEME_VALUES, FRAME_WRAP_VALUES, FRAME_X_ALIGN_VALUES, FRAME_Y_ALIGN_VALUES, HIGHLIGHT_COLOR_VALUES, IMAGE_HORIZONTAL_ALIGNMENT_VALUES, IMAGE_HORIZONTAL_RELATIVE_TO_VALUES, IMAGE_VERTICAL_ALIGNMENT_VALUES, IMAGE_VERTICAL_RELATIVE_TO_VALUES, IMAGE_WRAP_TEXT_VALUES, IMAGE_WRAP_TYPE_VALUES, LEVEL_SUFFIX_VALUES, LINE_SPACING_RULE_VALUES, NUMBER_FORMAT_VALUES, OUTLINE_STYLE_ATTR_VALUES, OUTLINE_STYLE_CSS_ALIASES, OUTLINE_STYLE_CSS_ALIAS_VALUES, OutlineStyleAttr, OutlineStyleCssAlias, PARAGRAPH_ALIGNMENT_VALUES, POSITIONAL_TAB_ALIGNMENT_VALUES, POSITIONAL_TAB_LEADER_VALUES, POSITIONAL_TAB_RELATIVE_TO_VALUES, SDT_LOCK_VALUES, SDT_TYPE_VALUES, SHADING_PATTERN_VALUES, SHAPE_OUTLINE_STYLE_VALUES, SHAPE_TEXT_ANCHOR_VALUES, SHAPE_TYPE_VALUES, STYLE_TYPE_VALUES, TABLE_CELL_TEXT_DIRECTION_VALUES, TABLE_CELL_VERTICAL_ALIGNMENT_VALUES, TABLE_JUSTIFICATION_VALUES, TABLE_ROW_HEIGHT_RULE_VALUES, TABLE_WIDTH_TYPE_VALUES, TAB_LEADER_VALUES, TAB_STOP_ALIGNMENT_VALUES, TEXT_EFFECT_VALUES, THEME_COLOR_SLOT_VALUES, UNDERLINE_STYLE_VALUES, normalizeShapeTextAnchor } from "./types/documentEnumValues.js";
+import { DeriveBlockIdInput, FolioBlockId, currentFolioBlockId, deriveBlankBlockId, deriveBlockId, getFolioParaIdFromBlockId, getSequentialFolioBlockIdIndex, isBlankFolioBlockId, isFolioBlockId, isSequentialFolioBlockId } from "./types/block-id.js";
 import { types_d_exports } from "./layout-engine/types.js";
 import { measureTypes_d_exports } from "./layout-engine/measure/measureTypes.js";
 export * from "@stll/docx-core/model";

package/dist/paged-layout/rangeProjection.js

@@ -1,4 +1,5 @@
 import { findBodyPmSpans } from "../layout-bridge/dom/findBodyPmSpans.js";
+import { createTextStreamRange, descendantTextNodes, totalTextLength } from "../layout-bridge/dom/textStreamDom.js";
 //#region src/paged-layout/rangeProjection.ts
 /**
 * Shared range → paged-canvas rectangle projection.
@@ -12,7 +13,6 @@ import { findBodyPmSpans } from "../layout-bridge/dom/findBodyPmSpans.js";
 * projection only for ranges whose DOM spans aren't mounted yet
 * (initial paint, off-screen pages).
 */
-const isTextNode = (node) => node?.nodeType === Node.TEXT_NODE;
 const pageIndexOf = (el) => {
 	const page = el.closest(".layout-page");
 	const raw = page instanceof HTMLElement ? page.dataset["pageNumber"] : void 0;
@@ -35,16 +35,13 @@ const domRectsForRange = (pmSpans, overlayRect, zoom, from, to) => {
 			});
 			continue;
 		}
-		let textNode = null;
-		if (isTextNode(spanEl.firstChild)) textNode = spanEl.firstChild;
-		else if (spanEl.firstChild instanceof HTMLElement && spanEl.firstChild.tagName === "A" && isTextNode(spanEl.firstChild.firstChild)) textNode = spanEl.firstChild.firstChild;
-		if (!textNode) continue;
+		const textNodes = descendantTextNodes(spanEl);
+		if (textNodes.length === 0) continue;
 		const startChar = Math.max(0, from - pmStart);
-		const endChar = Math.min(textNode.length, to - pmStart);
+		const endChar = Math.min(totalTextLength(textNodes), to - pmStart);
 		if (startChar >= endChar) continue;
-		const range = spanEl.ownerDocument.createRange();
-		range.setStart(textNode, startChar);
-		range.setEnd(textNode, endChar);
+		const range = createTextStreamRange(spanEl, startChar, endChar);
+		if (!range) continue;
 		const pageIndex = pageIndexOf(spanEl);
 		for (const rect of Array.from(range.getClientRects())) rects.push({
 			x: (rect.left - overlayRect.left) / zoom,

package/dist/paged-layout/transactionDirtyRange.d.ts

@@ -2,5 +2,7 @@ import { DirtyRange } from "./incrementalMeasure.js";
 import { Transaction } from "prosemirror-state";
 //#region src/paged-layout/transactionDirtyRange.d.ts
 declare function getTransactionDirtyRange(transaction: Transaction): DirtyRange | null;
+/** Collect every transaction in an applied batch in the final document's coordinates. */
+declare function getTransactionsDirtyRange(transactions: readonly Transaction[]): DirtyRange | null;
 //#endregion
-export { getTransactionDirtyRange };
+export { getTransactionDirtyRange, getTransactionsDirtyRange };