@stll/folio-core 0.24.0 → 0.25.0

package/dist/controller/layoutPipeline.js

@@ -26,11 +26,12 @@ function bodyMarginsClearHeaderFooter({ authoredMargins, preparedHeader, prepare
 	const headerBottom = preparedHeader ? (authoredMargins.header ?? 0) + (preparedHeader.marginPushBottom ?? preparedHeader.height) : authoredMargins.top;
 	const footerClearance = preparedFooter ? (authoredMargins.footer ?? 0) + (preparedFooter.marginPushBottom ?? preparedFooter.height) : authoredMargins.bottom;
 	const top = Math.max(authoredMargins.top, headerBottom);
+	const clearedTop = Math.max(top, preparedHeader?.bodyTopClearance ?? 0);
 	const bottom = Math.max(authoredMargins.bottom, footerClearance);
-	if (top === authoredMargins.top && bottom === authoredMargins.bottom) return authoredMargins;
+	if (clearedTop === authoredMargins.top && bottom === authoredMargins.bottom) return authoredMargins;
 	return {
 		...authoredMargins,
-		top,
+		top: clearedTop,
 		bottom
 	};
 }
@@ -255,7 +256,6 @@ function runLayoutPipeline(deps, state, options = {}) {
 		let newLayout;
 		let pageFootnoteMap = /* @__PURE__ */ new Map();
 		let footnoteContentMap = /* @__PURE__ */ new Map();
-		const bodyBreakType = finalSectionProperties?.sectionStart;
 		const buildLayoutOpts = () => {
 			const nextLayoutOpts = {
 				pageSize,
@@ -279,7 +279,6 @@ function runLayoutPipeline(deps, state, options = {}) {
 				nextLayoutOpts.finalPageNumbering = finalLayoutConfig.pageNumbering;
 			}
 			if (columns !== void 0) nextLayoutOpts.columns = columns;
-			if (bodyBreakType !== void 0) nextLayoutOpts.bodyBreakType = bodyBreakType;
 			if (sectionHeaderFooterRefs !== void 0) nextLayoutOpts.sectionHeaderFooterRefs = sectionHeaderFooterRefs;
 			if (sectionEvenPageMargins !== void 0) nextLayoutOpts.sectionEvenPageMargins = sectionEvenPageMargins;
 			return nextLayoutOpts;

package/dist/docx/fieldParser.d.ts

@@ -188,7 +188,7 @@ declare function isTocField(field: document_d_exports.Field): boolean;
  * @param instruction - Parsed instruction for format switches
  * @returns Formatted page number string
  */
-declare function computePageNumber(pageNumber: number, instruction?: ParsedFieldInstruction, sectionFormat?: string): string;
+declare function computePageNumber(pageNumber: number, instruction?: ParsedFieldInstruction, sectionFormat?: document_d_exports.NumberFormat): string;
 /**
  * Format a date according to a format string
  *

package/dist/docx/fieldParser.js

@@ -1,3 +1,4 @@
+import { formatOoxmlCounter } from "./ooxmlCounterFormatter.js";
 import { FieldTypeSchema, narrowEnum } from "./parserEnums.js";
 import { parseRun } from "./runParser.js";
 import { findChildren, getAttribute } from "./xmlParser.js";
@@ -354,15 +355,7 @@ function computePageNumber(pageNumber, instruction, sectionFormat) {
 		default: return String(pageNumber);
 	}
 }
-function formatSectionPageNumber(pageNumber, format) {
-	switch (format) {
-		case "upperRoman": return toRoman(pageNumber);
-		case "lowerRoman": return toRoman(pageNumber).toLowerCase();
-		case "upperLetter": return toLetter(pageNumber);
-		case "lowerLetter": return toLetter(pageNumber).toLowerCase();
-		default: return String(pageNumber);
-	}
-}
+const formatSectionPageNumber = (pageNumber, format) => formatOoxmlCounter(pageNumber, format);
 /**
 * Convert number to uppercase Roman numerals
 */

package/dist/docx/paragraphTextBoxEnrichment.js

@@ -158,6 +158,7 @@ const enrichTextBoxRuns = ({ content, xmlChildren, styles, theme, numbering, rel
 				textBody: {
 					content: textBox.content,
 					...textBox.autoFit !== void 0 ? { autoFit: textBox.autoFit } : {},
+					...textBox.textWrap !== void 0 ? { textWrap: textBox.textWrap } : {},
 					...textBox.margins !== void 0 ? { margins: textBox.margins } : {}
 				}
 			};

package/dist/docx/sectionParser.js

@@ -1,6 +1,6 @@
 import { parseFooterReference, parseHeaderReference } from "./headerFooterRefParser.js";
 import { parseEndnoteProperties, parseFootnoteProperties } from "./notePropertiesParser.js";
-import { BorderStyleSchema, ThemeColorSlotSchema, narrowEnum } from "./parserEnums.js";
+import { BorderStyleSchema, NumberFormatSchema, ThemeColorSlotSchema, narrowEnum } from "./parserEnums.js";
 import { findChild, findChildren, getAttribute, getChildElements, getLocalName, parseBooleanElement, parseNumericAttribute } from "./xmlParser.js";
 import { normalizeRevisionId } from "@stll/docx-core/model";
 //#region src/docx/sectionParser.ts
@@ -272,7 +272,7 @@ function parseSectionProperties(sectPr) {
 	const pgNumType = findChild(sectPr, "w", "pgNumType");
 	if (pgNumType) {
 		const pageNumbering = {};
-		const format = getAttribute(pgNumType, "w", "fmt");
+		const format = narrowEnum(getAttribute(pgNumType, "w", "fmt"), NumberFormatSchema);
 		if (format) pageNumbering.format = format;
 		const start = parseNumericAttribute(pgNumType, "w", "start");
 		if (start !== void 0) pageNumbering.start = start;

package/dist/docx/serializer/runSerializer.js

@@ -479,6 +479,7 @@ function serializeShapeContent(content) {
 	if (shape.textBody) {
 		const tb = shape.textBody;
 		const bpAttrs = ["rot=\"0\"", "vert=\"horz\""];
+		if (tb.textWrap) bpAttrs.push(`wrap="${tb.textWrap}"`);
 		if (tb.anchor) bpAttrs.push(`anchor="${tb.anchor === "middle" ? "ctr" : tb.anchor}"`);
 		if (tb.anchorCenter) bpAttrs.push("anchorCtr=\"1\"");
 		if (tb.margins) {

package/dist/docx/textBoxParser.js

@@ -11,6 +11,8 @@ const DEFAULT_MARGIN_EMU = 91440;
 function parseBodyProperties(bodyPr) {
 	if (!bodyPr) return {};
 	const result = {};
+	const textWrap = getAttribute(bodyPr, null, "wrap");
+	if (textWrap === "none" || textWrap === "square") result.textWrap = textWrap;
 	if (findChildByLocalName(bodyPr, "spAutoFit")) result.autoFit = "shape";
 	else if (findChildByLocalName(bodyPr, "normAutofit")) result.autoFit = "normal";
 	else if (findChildByLocalName(bodyPr, "noAutofit")) result.autoFit = "none";
@@ -128,6 +130,7 @@ function parseTextBox(drawingEl) {
 	if (outline) textBox.outline = outline;
 	if (bodyProps.margins) textBox.margins = bodyProps.margins;
 	if (bodyProps.autoFit) textBox.autoFit = bodyProps.autoFit;
+	if (bodyProps.textWrap) textBox.textWrap = bodyProps.textWrap;
 	if (isAnchor) {
 		const position = parseAnchorPosition(container);
 		if (position) textBox.position = position;
@@ -170,6 +173,7 @@ function parseTextBoxFromShape(wsp, size, position, wrap) {
 	if (outline) textBox.outline = outline;
 	if (bodyProps.margins) textBox.margins = bodyProps.margins;
 	if (bodyProps.autoFit) textBox.autoFit = bodyProps.autoFit;
+	if (bodyProps.textWrap) textBox.textWrap = bodyProps.textWrap;
 	if (position) textBox.position = position;
 	if (wrap) textBox.wrap = wrap;
 	return textBox;

package/dist/fields/fieldContext.d.ts

@@ -1,3 +1,4 @@
+import { document_d_exports } from "../types/document.js";
 //#region src/fields/fieldContext.d.ts
 /**
  * Resolution context for evaluating dynamic DOCX fields against a laid-out
@@ -10,7 +11,7 @@ type FieldContext = {
   /** 1-indexed page the field is on (PAGE). */
   pageNumber: number;
   /** OOXML section-level format used when PAGE has no explicit format switch. */
-  pageNumberFormat?: string;
+  pageNumberFormat?: document_d_exports.NumberFormat;
   /** Total pages in the document (NUMPAGES). */
   totalPages: number;
   /** Pages in the field's current section (SECTIONPAGES); omit until the

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

@@ -30,6 +30,14 @@ declare function calculateHeaderFooterMarginPushBounds(blocks: FlowBlock[], meas
   top: number;
   bottom: number;
 };
+/**
+ * Find the lower page edge of header `wrapTopAndBottom` artwork that overlaps
+ * the authored body start. Unlike ordinary anchored artwork, this wrap mode
+ * reserves a full-width horizontal band even when the drawing paints behind
+ * text. Bands wholly below the body start need page-local flow support and are
+ * intentionally not flattened into a top margin here.
+ */
+declare function calculateHeaderFooterBodyTopClearance(blocks: FlowBlock[], flowHeight: number, metrics: HeaderFooterMetrics): number | undefined;
 type ConvertHeaderFooterOptions = {
   styles?: document_d_exports.StyleDefinitions | null;
   theme?: document_d_exports.Theme | null;
@@ -74,4 +82,4 @@ declare function convertHeaderFooterToContent(headerFooter: document_d_exports.H
  */
 declare function convertHeaderFooterPmDocToContent(pmDoc: Node | null | undefined, contentWidth: number, metrics: HeaderFooterMetrics, options: Omit<ConvertHeaderFooterOptions, "styles">): HeaderFooterContent | undefined;
 //#endregion
-export { ConvertHeaderFooterOptions, HeaderFooterMetrics, calculateHeaderFooterMarginPushBounds, calculateHeaderFooterVisualBounds, convertHeaderFooterPmDocToContent, convertHeaderFooterToContent, normalizeHeaderFooterMeasureBlocks, resolveHeaderFooterPositionedVisualTop, resolveHeaderFooterVisualTop };
+export { ConvertHeaderFooterOptions, HeaderFooterMetrics, calculateHeaderFooterBodyTopClearance, calculateHeaderFooterMarginPushBounds, calculateHeaderFooterVisualBounds, convertHeaderFooterPmDocToContent, convertHeaderFooterToContent, normalizeHeaderFooterMeasureBlocks, resolveHeaderFooterPositionedVisualTop, resolveHeaderFooterVisualTop };

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

@@ -290,6 +290,29 @@ function calculateHeaderFooterMarginPushBounds(blocks, measures, flowHeight, met
 	};
 }
 /**
+* Find the lower page edge of header `wrapTopAndBottom` artwork that overlaps
+* the authored body start. Unlike ordinary anchored artwork, this wrap mode
+* reserves a full-width horizontal band even when the drawing paints behind
+* text. Bands wholly below the body start need page-local flow support and are
+* intentionally not flattened into a top margin here.
+*/
+function calculateHeaderFooterBodyTopClearance(blocks, flowHeight, metrics) {
+	if (metrics.section !== "header") return;
+	const flowTop = metrics.margins.header ?? 48;
+	let clearance = 0;
+	for (const block of blocks) {
+		if (block.kind !== "paragraph") continue;
+		for (const run of block.runs) {
+			if (run.kind !== "image" || run.wrapType !== "topAndBottom" || run.position?.vertical?.relativeTo !== "page" && run.position?.vertical?.relativeTo !== "margin") continue;
+			const pageTop = flowTop + resolveHeaderFooterVisualTop(run, 0, flowHeight, metrics) - (run.distTop ?? 0);
+			if (pageTop > metrics.margins.top) continue;
+			const pageBottom = Math.min(metrics.pageSize.h, pageTop + (run.distTop ?? 0) + run.height + (run.distBottom ?? 0));
+			clearance = Math.max(clearance, pageBottom);
+		}
+	}
+	return clearance > 0 ? clearance : void 0;
+}
+/**
 * Convert HeaderFooter (document type) to HeaderFooterContent (render type).
 *
 * Routes through the same pipeline as the body: HF.content ->
@@ -350,6 +373,7 @@ function finalizeHeaderFooterContent(blocks, contentWidth, metrics, options) {
 	}
 	const { visualTop, visualBottom } = calculateHeaderFooterVisualBounds(blocks, measures, flowHeight, metrics);
 	const { top: marginPushTop, bottom: marginPushBottom } = calculateHeaderFooterMarginPushBounds(blocks, measures, flowHeight, metrics);
+	const bodyTopClearance = calculateHeaderFooterBodyTopClearance(blocks, flowHeight, metrics);
 	return {
 		blocks,
 		measures,
@@ -358,6 +382,7 @@ function finalizeHeaderFooterContent(blocks, contentWidth, metrics, options) {
 		visualBottom,
 		marginPushTop,
 		marginPushBottom,
+		...bodyTopClearance !== void 0 ? { bodyTopClearance } : {},
 		textSig: computeHeaderFooterTextSig(blocks),
 		...options.rId ? { rId: options.rId } : {}
 	};
@@ -489,4 +514,4 @@ function serializeRunFmt(run) {
 	return JSON.stringify(out);
 }
 //#endregion
-export { calculateHeaderFooterMarginPushBounds, calculateHeaderFooterVisualBounds, convertHeaderFooterPmDocToContent, convertHeaderFooterToContent, normalizeHeaderFooterMeasureBlocks, resolveHeaderFooterPositionedVisualTop, resolveHeaderFooterVisualTop };
+export { calculateHeaderFooterBodyTopClearance, calculateHeaderFooterMarginPushBounds, calculateHeaderFooterVisualBounds, convertHeaderFooterPmDocToContent, convertHeaderFooterToContent, normalizeHeaderFooterMeasureBlocks, resolveHeaderFooterPositionedVisualTop, resolveHeaderFooterVisualTop };

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

@@ -1221,6 +1221,7 @@ function convertTextBoxNode(node, startPos, opts) {
 	};
 	if (attrs.height !== void 0) textBox.height = attrs.height;
 	if (attrs.autoFit !== void 0) textBox.autoFit = attrs.autoFit;
+	if (attrs.textWrap !== void 0) textBox.textWrap = attrs.textWrap;
 	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;

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

@@ -4,7 +4,7 @@ import { buildRunFontStyle } from "../../layout-engine/measure/measureHelpers.js
 import { measureParagraph } from "../../layout-engine/measure/measureParagraph.js";
 import { measureRun } from "../../layout-engine/measure/measureProvider.js";
 import { buildTableCellFloatingZones, getTableCellContentWidth, getTableCellFloatingImages } from "../../layout-engine/measure/tableCellFloating.js";
-import { getTableRowLeadingWidth } from "../../layout-engine/types.js";
+import { getTableRowLeadingWidth, resolveTableCellPadding } from "../../layout-engine/types.js";
 import { inlineImageBoundingBox } from "../../utils/rotationBoundingBox.js";
 import { getPageTop } from "./hitTest.js";
 //#region src/layout-bridge/engine/selectionRects.ts
@@ -24,8 +24,6 @@ import { getPageTop } from "./hitTest.js";
 * across blank lines visible (eigenpal/docx-editor#836).
 */
 const EMPTY_PARAGRAPH_SLIVER_WIDTH = 4;
-const DEFAULT_TABLE_CELL_PADDING_LEFT = 7;
-const DEFAULT_TABLE_CELL_PADDING_TOP = 1;
 /**
 * Extract FontStyle from a run for measurement.
 */
@@ -49,14 +47,14 @@ function findBlockById(blocks, blockId) {
 	return blocks.findIndex((block) => block.id === blockId);
 }
 function getCellContentOffsetY(cell, cellMeasure, rowHeight) {
-	const padTop = cell.padding?.top ?? DEFAULT_TABLE_CELL_PADDING_TOP;
+	const { top: padTop } = resolveTableCellPadding(cell);
 	const spareHeight = Math.max(0, rowHeight - cellMeasure.height);
 	if (cell.verticalAlign === "bottom") return padTop + spareHeight;
 	if (cell.verticalAlign === "center") return padTop + spareHeight / 2;
 	return padTop;
 }
 function getCellContentOffsetX(cell) {
-	return cell.padding?.left ?? DEFAULT_TABLE_CELL_PADDING_LEFT;
+	return resolveTableCellPadding(cell).left;
 }
 function getMeasuredBlockHeight(measure) {
 	if (!measure) return 0;

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

@@ -1,4 +1,4 @@
-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, ListMarkerFormatting, ListNumPr, MathRun, Measure, MeasuredLine, Page, PageBreakBlock, PageBreakMeasure, PageHeaderFooterRefs, PageMargins, ParagraphAttrs, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphIndent, ParagraphMeasure, ParagraphSpacing, RenderedPageBreakRun, Run, RunFormatting, SdtGroup, SectionBreakBlock, SectionBreakMeasure, SectionPageNumbering, 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 { 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, ListMarkerFormatting, ListNumPr, MathRun, Measure, MeasuredLine, Page, PageBreakBlock, PageBreakMeasure, PageHeaderFooterRefs, PageMargins, ParagraphAttrs, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphIndent, ParagraphMeasure, ParagraphSpacing, RenderedPageBreakRun, Run, RunFormatting, SdtGroup, SectionBreakBlock, SectionBreakMeasure, SectionPageNumbering, TabAlignment, TabRun, TabStop, TableBlock, TableCell, TableCellMeasure, TableFragment, TableMeasure, TableRow, TableRowMeasure, TextBoxBlock, TextBoxFlowAttrs, TextBoxFragment, TextBoxMeasure, TextRun, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getTableRowLeadingWidth, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, resolveTableCellPadding, 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";
@@ -44,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, ListMarkerFormatting, ListNumPr, MathRun, Measure, MeasuredLine, Page, PageBreakBlock, PageBreakMeasure, PageHeaderFooterRefs, PageMargins, type PageState, type Paginator, type PaginatorOptions, ParagraphAttrs, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphIndent, ParagraphMeasure, ParagraphSpacing, RenderedPageBreakRun, Run, RunFormatting, SdtGroup, SectionBreakBlock, SectionBreakMeasure, SectionLayoutConfig, SectionPageNumbering, 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 };
+export { BlockId, BorderStyle, type BreakDecision, CellBorderSpec, CellBorders, ColumnBreakBlock, ColumnBreakMeasure, ColumnLayout, DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, DocumentPosition, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, FieldRun, FloatingTablePosition, FlowBlock, FootnoteContent, Fragment, FragmentBase, HeaderFooterContent, HeaderFooterContentHeights, HeaderFooterLayout, HitTestResult, HyperlinkInfo, ImageBlock, ImageFragment, ImageMeasure, ImageRun, ImageRunPosition, type KeepNextChain, Layout, LayoutOptions, LineBreakRun, ListMarkerFormatting, ListNumPr, MathRun, Measure, MeasuredLine, Page, PageBreakBlock, PageBreakMeasure, PageHeaderFooterRefs, PageMargins, type PageState, type Paginator, type PaginatorOptions, ParagraphAttrs, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphIndent, ParagraphMeasure, ParagraphSpacing, RenderedPageBreakRun, Run, RunFormatting, SdtGroup, SectionBreakBlock, SectionBreakMeasure, SectionLayoutConfig, SectionPageNumbering, 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, resolveTableCellPadding, scheduleSectionBreak, tableColumnsArePinned };

package/dist/layout-engine/index.js

@@ -11,7 +11,7 @@ import { INITIAL_RENDERED_BREAK_STATE, reconcileAfterBlock, reconcileBreakBefore
 import { applyPendingToActive, createInitialSectionState, getEffectiveColumns, getEffectiveMargins, getEffectivePageSize, scheduleSectionBreak } from "./section-breaks.js";
 import { buildTableRowBreakInfo, getRowContinuationSkip, snapRowBreak } from "./tableRowBreak.js";
 import { bandFragmentX, bandTopContentY, isPageFrameRelativeAnchor } from "./textBoxFlow.js";
-import { DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getTableRowLeadingWidth, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, tableColumnsArePinned } from "./types.js";
+import { DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getTableRowLeadingWidth, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, resolveTableCellPadding, tableColumnsArePinned } from "./types.js";
 import { panic } from "better-result";
 //#region src/layout-engine/index.ts
 /**
@@ -257,9 +257,7 @@ function layoutDocument(blocks, measures, options) {
 				break;
 			case "sectionBreak": {
 				const nextSectionConfig = sectionConfigs[sectionIdx + 1] ?? initialConfig;
-				let nextType = options.bodyBreakType ?? sectionBreakTypes[sectionIdx] ?? DEFAULT_SECTION_BREAK_TYPE;
-				if (sectionIdx + 1 < sectionBreakTypes.length) nextType = sectionBreakTypes[sectionIdx + 1] ?? DEFAULT_SECTION_BREAK_TYPE;
-				handleSectionBreak(block, paginator, nextSectionConfig, nextType, sectionIdx + 1);
+				handleSectionBreak(block, paginator, nextSectionConfig, sectionBreakTypes[sectionIdx] ?? DEFAULT_SECTION_BREAK_TYPE, sectionIdx + 1);
 				const nextColumns = nextSectionConfig.columns;
 				const nextBreakIndex = breakIndices[sectionIdx + 1] ?? blocks.length;
 				const nextBreak = blocks[nextBreakIndex];
@@ -937,4 +935,4 @@ function handleSectionBreak(_block, paginator, nextSectionConfig, nextSectionTyp
 	paginator.updateColumns(nextSectionConfig.columns ?? DEFAULT_COLUMNS);
 }
 //#endregion
-export { DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, 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 };
+export { DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, applyContextualSpacing, applyPendingToActive, assertExhaustiveFlowBlock, calculateChainHeight, collectSectionConfigs, computeKeepNextChains, createInitialSectionState, createPaginator, findPageIndexContainingPmPos, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getEffectiveColumns, getEffectiveMargins, getEffectivePageSize, getHeaderRowsHeight, getMidChainIndices, getTableRowLeadingWidth, hasKeepLines, hasPageBreakBefore, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, layoutDocument, resolveSectionHeaderFooterRefs, resolveTableCellPadding, scheduleSectionBreak, tableColumnsArePinned };

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

@@ -2,7 +2,7 @@ import { recordMeasureBlock, recordMeasureBlockError } from "../layoutInstrument
 import { isParagraphFrameTextBox } from "../paragraphFrame.js";
 import { bandFragmentX, bandTopContentY, isPageFrameRelativeAnchor } from "../textBoxFlow.js";
 import { getTextBoxGroupId } from "../textBoxGroup.js";
-import { DEFAULT_TEXTBOX_MARGINS, floatingTextBoxReservesBand, floatingTextBoxWrapsText, tableColumnsArePinned } from "../types.js";
+import { DEFAULT_TEXTBOX_MARGINS, floatingTextBoxReservesBand, floatingTextBoxWrapsText, resolveTableCellPadding, tableColumnsArePinned } from "../types.js";
 import { getCachedParagraphMeasure, setCachedParagraphMeasure } from "./cache.js";
 import { resolveFloatingTableX } from "./floatingTablePosition.js";
 import { findClearLineY, measureParagraph } from "./measureParagraph.js";
@@ -63,8 +63,6 @@ function resolveTableWidthPx(width, widthType, contentWidth) {
 	if (widthType === "dxa" || !widthType || widthType === "auto") return Math.round(width / 20 * 1.333);
 }
 function measureTableBlock(tableBlock, contentWidth, fieldValues) {
-	const DEFAULT_CELL_PADDING_X = 7;
-	const DEFAULT_CELL_PADDING_Y = 0;
 	let columnWidths = tableBlock.columnWidths ?? [];
 	const explicitWidthPx = resolveTableWidthPx(tableBlock.width, tableBlock.widthType, contentWidth);
 	if (columnWidths.length === 0 && tableBlock.rows.length > 0) {
@@ -89,8 +87,7 @@ function measureTableBlock(tableBlock, contentWidth, fieldValues) {
 				for (let c = 0; c < colSpan && columnIndex + c < columnWidths.length; c++) cellWidth += columnWidths[columnIndex + c] ?? 0;
 				if (cellWidth === 0) cellWidth = cell.width ?? 100;
 				columnIndex = getFirstAvailableColumn(cellGrid, rowIdx, columnIndex + colSpan);
-				const padLeft = cell.padding?.left ?? DEFAULT_CELL_PADDING_X;
-				const padRight = cell.padding?.right ?? DEFAULT_CELL_PADDING_X;
+				const { left: padLeft, right: padRight } = resolveTableCellPadding(cell);
 				const cellContentWidth = Math.max(1, cellWidth - padLeft - padRight);
 				const measureWidth = cell.noWrap === true && !columnsPinned ? NO_WRAP_MEASURE_WIDTH : cellContentWidth;
 				const cellMeasure = {
@@ -132,8 +129,7 @@ function measureTableBlock(tableBlock, contentWidth, fieldValues) {
 				placeTableCellBlock(flowState, sourceBlock, blockMeasure);
 			}
 			cell.height = finishTableCellFlow(flowState);
-			const padTop = sourceCell?.padding?.top ?? DEFAULT_CELL_PADDING_Y;
-			const padBottom = sourceCell?.padding?.bottom ?? DEFAULT_CELL_PADDING_Y;
+			const { top: padTop, bottom: padBottom } = resolveTableCellPadding(sourceCell);
 			cell.height += padTop + padBottom;
 			if ((sourceCell?.rowSpan ?? 1) > 1) continue;
 			const borderHeight = getTableCellVerticalBorderHeight(cellGrid, sourceCell, rowIdx);
@@ -444,14 +440,34 @@ function measureTextBoxBlock(tb, fieldValues) {
 	const innerWidth = tb.width - margins.left - margins.right;
 	const innerMeasures = tb.content.map((block) => {
 		if (block.kind === "table") return measureTableBlock(block, innerWidth, fieldValues);
-		return measureParagraph(block, innerWidth, fieldValues ? { fieldValues } : void 0);
+		return measureParagraph(block, tb.textWrap === "none" ? NO_WRAP_MEASURE_WIDTH : innerWidth, fieldValues ? { fieldValues } : void 0);
 	});
+	let naturalContentWidth = 0;
+	for (let index = 0; index < innerMeasures.length; index++) {
+		const measure = innerMeasures[index];
+		if (measure.kind === "table") {
+			naturalContentWidth = Math.max(naturalContentWidth, measure.totalWidth);
+			continue;
+		}
+		const block = tb.content[index];
+		if (!block || block.kind !== "paragraph") continue;
+		const indent = block.attrs?.indent;
+		const left = indent?.left ?? 0;
+		const right = indent?.right ?? 0;
+		for (let lineIndex = 0; lineIndex < measure.lines.length; lineIndex++) {
+			const line = measure.lines[lineIndex];
+			const start = left + (lineIndex === 0 ? (indent?.firstLine ?? 0) - (indent?.hanging ?? 0) : 0);
+			const end = start + line.width + right;
+			naturalContentWidth = Math.max(naturalContentWidth, Math.max(0, end) - Math.min(0, start));
+		}
+	}
+	const fittedWidth = naturalContentWidth + margins.left + margins.right;
+	const totalWidth = tb.autoFit === "shape" && tb.textWrap === "none" ? Math.max(tb.width, fittedWidth) : tb.width;
 	const contentBoxHeight = layoutTextBoxContent(tb.content, innerMeasures).totalHeight + margins.top + margins.bottom;
-	const totalHeight = tb.autoFit === "shape" ? Math.max(tb.height ?? 0, contentBoxHeight) : tb.height ?? contentBoxHeight;
 	return {
 		kind: "textBox",
-		width: tb.width,
-		height: totalHeight,
+		width: totalWidth,
+		height: tb.autoFit === "shape" ? Math.max(tb.height ?? 0, contentBoxHeight) : tb.height ?? contentBoxHeight,
 		innerMeasures
 	};
 }

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

@@ -1,5 +1,6 @@
 import { calculateTabWidth, pixelsToTwips } from "../../prosemirror/utils/tabCalculator.js";
 import { CJK_FALLBACK_FONT_FAMILY, isCjkFont } from "../../utils/fontResolver.js";
+import { isRtlParagraph } from "../../utils/paragraphBaseDirection.js";
 import { inlineImageBoundingBox } from "../../utils/rotationBoundingBox.js";
 import { hasCjk, hasComplexScript } from "../../utils/scriptSegments.js";
 import { measuredLineAdvance } from "../lineFlow.js";
@@ -668,6 +669,7 @@ function findClearLineY(startY, lineHeight, zones, contentWidth, minWidth) {
 function measureParagraph(block, maxWidth, options) {
 	const runs = block.runs;
 	const attrs = block.attrs;
+	const isRtl = isRtlParagraph(block);
 	const spacing = attrs?.spacing;
 	const isJustifiedParagraph = attrs?.alignment === "justify";
 	const justificationProfile = {
@@ -936,9 +938,13 @@ function measureParagraph(block, maxWidth, options) {
 				decimalPrefixWidth
 			});
 			let tabWidth = tabResult.width;
+			const authoredEndpoint = contentX + tabWidth + followingWidth;
+			const activeContentRightEdge = maxWidth - currentLine.rightOffset;
+			const preservesLogicalRtlEndStop = isRtl && tabResult.alignment === "end" && authoredEndpoint <= activeContentRightEdge + WIDTH_TOLERANCE;
 			const landsOnLeftIndent = tabResult.alignment === "start" && indentLeft > 0 && Math.abs(contentX + tabWidth - indentLeft) <= WIDTH_TOLERANCE;
 			const lineRightEdgeX = indentLeft + (isFirstLine ? firstLineOffset + markerInlineWidth : 0) + currentLine.availableWidth + currentLine.leftOffset;
-			if (!landsOnLeftIndent && !hasFollowingTabOnLine(runs, runIndex) && canClampTabToRightEdge(tabResult.alignment, currentLine.width, hasPriorTabOnLine(runs, runIndex), followingWidth, currentLine.availableWidth) && (tabWidth > 0 || followingWidth > 0) && contentX + tabWidth + followingWidth > lineRightEdgeX + WIDTH_TOLERANCE) tabWidth = Math.max(1, lineRightEdgeX - contentX - followingWidth);
+			if (!preservesLogicalRtlEndStop && !landsOnLeftIndent && !hasFollowingTabOnLine(runs, runIndex) && canClampTabToRightEdge(tabResult.alignment, currentLine.width, hasPriorTabOnLine(runs, runIndex), followingWidth, currentLine.availableWidth) && (tabWidth > 0 || followingWidth > 0) && contentX + tabWidth + followingWidth > lineRightEdgeX + WIDTH_TOLERANCE) tabWidth = Math.max(1, lineRightEdgeX - contentX - followingWidth);
+			if (preservesLogicalRtlEndStop) currentLine.availableWidth = Math.max(currentLine.availableWidth, currentLine.width + tabWidth + followingWidth);
 			if (currentLine.width + tabWidth > currentLine.availableWidth + WIDTH_TOLERANCE) {
 				startNewLine(runIndex, 0);
 				updateMaxFont(style);

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

@@ -1,5 +1,5 @@
 import { emuToPixels } from "../../utils/units.js";
-import { isFloatingImageRun } from "../types.js";
+import { isFloatingImageRun, resolveTableCellPadding } from "../types.js";
 import { clampFloatingWrapMargins } from "./clampFloatingWrapMargins.js";
 import { createTableCellFlowState, placeTableCellBlock } from "./tableCellFlow.js";
 //#region src/layout-engine/measure/tableCellFloating.ts
@@ -34,8 +34,7 @@ const resolveCellScopedPosition = ({ run, paragraphY, contentWidth }) => {
 	};
 };
 function getTableCellContentWidth(cell, cellMeasure) {
-	const padLeft = cell?.padding?.left ?? 7;
-	const padRight = cell?.padding?.right ?? 7;
+	const { left: padLeft, right: padRight } = resolveTableCellPadding(cell);
 	return Math.max(0, cellMeasure.width - padLeft - padRight);
 }
 function getTableCellFloatingImages(cell, cellMeasure, contentWidth, resolvePosition) {

package/dist/layout-engine/renderedBreakReconciliation.js

@@ -11,7 +11,7 @@ const INITIAL_RENDERED_BREAK_STATE = { type: "noPageAdvance" };
 */
 const reconcileBreakBeforeBlock = ({ state, block, previousBlock, page, blocksById, hasExplicitPageBreak, renderedBreakNeedsSnap }) => {
 	if (hasExplicitPageBreak) return {
-		forcePageBreak: true,
+		forcePageBreak: !(state.type === "pageAdvance" && state.reason === "authoredBoundary" && state.boundary === "sectionBreak" && previousBlock?.kind === "sectionBreak" && previousBlock.type !== "continuous"),
 		suppressSpaceBefore: false,
 		state: INITIAL_RENDERED_BREAK_STATE
 	};

package/dist/layout-engine/tableRowBreak.js

@@ -2,6 +2,7 @@ import { measureParagraph } from "./measure/measureParagraph.js";
 import { buildTableCellFloatingZones, getTableCellContentWidth, getTableCellFloatingImages } from "./measure/tableCellFloating.js";
 import { createTableCellFlowState, placeTableCellBlock } from "./measure/tableCellFlow.js";
 import { isEmptyParagraph } from "./paragraphSpacing.js";
+import { resolveTableCellPadding } from "./types.js";
 //#region src/layout-engine/tableRowBreak.ts
 /**
 * Table row-break geometry. Ported from eigenpal/docx-editor#698 (folio subset).
@@ -18,7 +19,6 @@ import { isEmptyParagraph } from "./paragraphSpacing.js";
 * here yet (a separate follow-up); each row uses its own cells' content.
 */
 const BREAK_OFFSET_EPSILON = .01;
-const DEFAULT_TABLE_CELL_PADDING_TOP = 1;
 function isInsideRange(offset, range) {
 	return offset > range.top && offset < range.bottom;
 }
@@ -49,7 +49,7 @@ function cellBreakGeometry(cell, measure) {
 	const suppressibleLeadingRanges = [];
 	const cellBlocks = cell?.blocks;
 	const blockMeasures = measure.blocks;
-	const padTop = cell?.padding?.top ?? DEFAULT_TABLE_CELL_PADDING_TOP;
+	const { top: padTop } = resolveTableCellPadding(cell);
 	const contentWidth = getTableCellContentWidth(cell, measure);
 	const floatingZones = buildTableCellFloatingZones(cell !== void 0 ? getTableCellFloatingImages(cell, measure, contentWidth) : [], contentWidth);
 	const flowState = createTableCellFlowState();

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

@@ -1,7 +1,7 @@
 import { OutlineStyleAttr } from "../types/documentEnumValues.js";
-import { ImagePosition, ImageWrap, SdtProperties, SdtType, ShapeTextBody, TableCellFormatting, TableWidthType } from "@stll/docx-core/model";
+import { ImagePosition, ImageWrap, NumberFormat, SdtProperties, SdtType, ShapeTextBody, TableCellFormatting, TableWidthType } from "@stll/docx-core/model";
 declare namespace types_d_exports {
-  export { 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, ListMarkerFormatting, ListNumPr, MathRun, Measure, MeasuredLine, Page, PageBreakBlock, PageBreakMeasure, PageHeaderFooterRefs, PageMargins, ParagraphAttrs, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphIndent, ParagraphMeasure, ParagraphSpacing, RenderedPageBreakRun, Run, RunFormatting, SdtGroup, SectionBreakBlock, SectionBreakMeasure, SectionPageNumbering, TabAlignment, TabRun, TabStop, TableBlock, TableCell, TableCellMeasure, TableFragment, TableMeasure, TableRow, TableRowMeasure, TextBoxBlock, TextBoxFlowAttrs, TextBoxFragment, TextBoxMeasure, TextRun, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getTableRowLeadingWidth, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, tableColumnsArePinned };
+  export { 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, ListMarkerFormatting, ListNumPr, MathRun, Measure, MeasuredLine, Page, PageBreakBlock, PageBreakMeasure, PageHeaderFooterRefs, PageMargins, ParagraphAttrs, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphIndent, ParagraphMeasure, ParagraphSpacing, RenderedPageBreakRun, Run, RunFormatting, SdtGroup, SectionBreakBlock, SectionBreakMeasure, SectionPageNumbering, TabAlignment, TabRun, TabStop, TableBlock, TableCell, TableCellMeasure, TableFragment, TableMeasure, TableRow, TableRowMeasure, TextBoxBlock, TextBoxFlowAttrs, TextBoxFragment, TextBoxMeasure, TextRun, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getTableRowLeadingWidth, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, resolveTableCellPadding, tableColumnsArePinned };
 }
 /**
  * Unique identifier for a block in the document.
@@ -578,6 +578,9 @@ type TableCell = {
    */
   noWrap?: boolean;
 };
+type TableCellPadding = NonNullable<TableCell["padding"]>;
+/** Resolve authored cell margins against the TableNormal defaults. */
+declare const resolveTableCellPadding: (cell: Pick<TableCell, "padding"> | undefined) => TableCellPadding;
 /**
  * A table row containing cells.
  */
@@ -705,11 +708,11 @@ type SectionBreakBlock = {
 /** Normalized section page-number policy. An omitted OOXML start continues numbering. */
 type SectionPageNumbering = {
   type: "continue";
-  format?: string;
+  format?: NumberFormat;
 } | {
   type: "restart";
   start: number;
-  format?: string;
+  format?: NumberFormat;
 };
 type PageHeaderFooterRefs = {
   titlePg?: boolean;
@@ -760,6 +763,8 @@ type TextBoxBlock = {
   height?: number;
   /** Text fitting behavior */
   autoFit?: ShapeTextBody["autoFit"];
+  /** Horizontal text wrapping inside the box */
+  textWrap?: ShapeTextBody["textWrap"];
   /** Fill/background color */
   fillColor?: string;
   /** Border width in pixels */
@@ -1081,7 +1086,7 @@ type Page = {
   /** Authored page number shown by PAGE fields. */
   logicalNumber: number;
   /** OOXML number format for this page's section. */
-  logicalNumberFormat?: string;
+  logicalNumberFormat?: NumberFormat;
   /** Fragments positioned on this page. */
   fragments: Fragment[];
   /** Page margins. */
@@ -1235,8 +1240,6 @@ type LayoutOptions = {
    * page.
    */
   footnoteHeightById?: Map<number, number>;
-  /** Section break type for the body-level (final) section (for section transition logic). */
-  bodyBreakType?: "continuous" | "nextPage" | "evenPage" | "oddPage";
   /** Header/footer references for each document section, by section index. */
   sectionHeaderFooterRefs?: PageHeaderFooterRefs[];
 };
@@ -1308,6 +1311,8 @@ type HeaderFooterContent = {
    */
   marginPushTop?: number;
   marginPushBottom?: number;
+  /** Page-coordinate lower edge of a header wrap band overlapping the body top. */
+  bodyTopClearance?: number;
   /**
    * Relationship id (`rId`) of the source HF part. Emitted as `data-rid`
    * on the painted `.layout-page-header` / `.layout-page-footer` so the
@@ -1380,4 +1385,4 @@ declare function tableColumnsArePinned(table: TableBlock): boolean;
 /** Return the leading visual offset for a row with omitted grid columns. */
 declare const getTableRowLeadingWidth: (row: TableRow, columnWidths: readonly number[]) => number;
 //#endregion
-export { 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, ListMarkerFormatting, ListNumPr, MathRun, Measure, MeasuredLine, Page, PageBreakBlock, PageBreakMeasure, PageHeaderFooterRefs, PageMargins, ParagraphAttrs, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphIndent, ParagraphMeasure, ParagraphSpacing, RenderedPageBreakRun, Run, RunFormatting, SdtGroup, SectionBreakBlock, SectionBreakMeasure, SectionPageNumbering, TabAlignment, TabRun, TabStop, TableBlock, TableCell, TableCellMeasure, TableFragment, TableMeasure, TableRow, TableRowMeasure, TextBoxBlock, TextBoxFlowAttrs, TextBoxFragment, TextBoxMeasure, TextRun, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getTableRowLeadingWidth, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, tableColumnsArePinned, types_d_exports };
+export { 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, ListMarkerFormatting, ListNumPr, MathRun, Measure, MeasuredLine, Page, PageBreakBlock, PageBreakMeasure, PageHeaderFooterRefs, PageMargins, ParagraphAttrs, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphIndent, ParagraphMeasure, ParagraphSpacing, RenderedPageBreakRun, Run, RunFormatting, SdtGroup, SectionBreakBlock, SectionBreakMeasure, SectionPageNumbering, TabAlignment, TabRun, TabStop, TableBlock, TableCell, TableCellMeasure, TableFragment, TableMeasure, TableRow, TableRowMeasure, TextBoxBlock, TextBoxFlowAttrs, TextBoxFragment, TextBoxMeasure, TextRun, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getTableRowLeadingWidth, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, resolveTableCellPadding, tableColumnsArePinned, types_d_exports };

package/dist/layout-engine/types.js

@@ -13,8 +13,22 @@ var types_exports = /* @__PURE__ */ __exportAll({
 	isFloatingImageRun: () => isFloatingImageRun,
 	isFloatingTextBoxBlock: () => isFloatingTextBoxBlock,
 	isTextWrappingFloatingImageRun: () => isTextWrappingFloatingImageRun,
+	resolveTableCellPadding: () => resolveTableCellPadding,
 	tableColumnsArePinned: () => tableColumnsArePinned
 });
+const DEFAULT_TABLE_CELL_PADDING = {
+	top: 0,
+	right: 7,
+	bottom: 0,
+	left: 7
+};
+/** Resolve authored cell margins against the TableNormal defaults. */
+const resolveTableCellPadding = (cell) => ({
+	top: cell?.padding?.top ?? DEFAULT_TABLE_CELL_PADDING.top,
+	right: cell?.padding?.right ?? DEFAULT_TABLE_CELL_PADDING.right,
+	bottom: cell?.padding?.bottom ?? DEFAULT_TABLE_CELL_PADDING.bottom,
+	left: cell?.padding?.left ?? DEFAULT_TABLE_CELL_PADDING.left
+});
 /** Default internal margins for text boxes (OOXML defaults in pixels) */
 const DEFAULT_TEXTBOX_MARGINS = {
 	top: 4,
@@ -128,4 +142,4 @@ const getTableRowLeadingWidth = (row, columnWidths) => {
 	return columnWidths.slice(0, row.gridBefore ?? 0).reduce((sum, columnWidth) => sum + columnWidth, 0);
 };
 //#endregion
-export { DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getTableRowLeadingWidth, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, tableColumnsArePinned, types_exports };
+export { DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getTableRowLeadingWidth, isFloatingImageRun, isFloatingTextBoxBlock, isTextWrappingFloatingImageRun, resolveTableCellPadding, tableColumnsArePinned, types_exports };

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

@@ -1,4 +1,4 @@
-import { MeasuredLine, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphMeasure, Run, TabStop } from "../layout-engine/types.js";
+import { HyperlinkInfo, MeasuredLine, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphMeasure, Run, TabStop } from "../layout-engine/types.js";
 import { RenderContext } from "./renderUtils.js";
 //#region src/layout-painter/renderParagraph.d.ts
 /**
@@ -64,8 +64,14 @@ type RenderLineOptions = {
   context?: RenderContext;
   /** Left indent in pixels */
   leftIndentPx?: number;
+  /** Authored OOXML left indent used by logical tab-stop calculations. */
+  tabLeftIndentPx?: number;
   /** First line indent in pixels (positive) or hanging indent (negative) */
   firstLineIndentPx?: number;
+  /** Paragraph base direction for logical first-line indentation. */
+  isRtl?: boolean;
+  /** Full paragraph content-box width before physical indents. */
+  contentWidthPx?: number;
   /** Line-specific floating image margins (calculated per-line based on Y overlap) */
   floatingMargins?: {
     leftMargin: number;
@@ -73,6 +79,8 @@ type RenderLineOptions = {
   };
   /** Track inline image runs already rendered in this paragraph fragment to prevent duplicates */
   renderedInlineImageKeys?: Set<string>;
+  /** Hyperlink fragments whose complete displayed text is a URL. */
+  leftToRightDisplayedUrlHyperlinks?: ReadonlySet<HyperlinkInfo>;
   /**
    * Rightmost x where inline content may render, in content-area coords. Used
    * by the right-tab anchor (TOC pattern); passed in directly rather than

package/dist/layout-painter/renderParagraph.js

@@ -8,9 +8,9 @@ import { FONT_KERNING_MODE, countCompressibleSpaces, getFontKerningMode, getRunF
 import { isFloatingImageRun } from "../layout-engine/types.js";
 import { calculateTabWidth } from "../prosemirror/utils/tabCalculator.js";
 import { AUTHOR_COLORS, getAuthorColorIdx } from "../utils/authorColors.js";
-import { detectBaseDirection } from "../utils/baseDirection.js";
 import { resolveFontFamily } from "../utils/fontResolver.js";
 import "../utils/fontWeights.js";
+import { isRtlParagraph } from "../utils/paragraphBaseDirection.js";
 import { inlineImageBoundingBox, parseRotationDegrees, rotatedBoundingBox } from "../utils/rotationBoundingBox.js";
 import { applySanitizedImageSrc } from "../utils/sanitizeImageSrc.js";
 import { SCRIPT_CLASS, hasCjk, hasComplexScript, segmentByScript } from "../utils/scriptSegments.js";
@@ -39,12 +39,42 @@ const PARAGRAPH_CLASS_NAMES = {
 	image: "layout-run-image",
 	lineBreak: "layout-run-linebreak"
 };
+const LEFT_TO_RIGHT_DIRECTION = "ltr";
+const RIGHT_TO_LEFT_DIRECTION = "rtl";
+const DISPLAYED_URL_PATTERN = /^(?:https?:\/\/|www\.)\S+$/iu;
 /**
 * Check if run is a text run
 */
 function isTextRun(run) {
 	return run.kind === "text";
 }
+function hyperlinksMatch(left, right) {
+	return left.href === right.href && left.tooltip === right.tooltip && left.noDefaultStyle === right.noDefaultStyle;
+}
+function collectLeftToRightDisplayedUrlHyperlinks(runs) {
+	const result = /* @__PURE__ */ new Set();
+	let index = 0;
+	while (index < runs.length) {
+		const first = runs[index];
+		if (!first || !isTextRun(first) || !first.hyperlink) {
+			index += 1;
+			continue;
+		}
+		const hyperlinks = [];
+		let displayedText = "";
+		let groupEnd = index;
+		while (groupEnd < runs.length) {
+			const run = runs[groupEnd];
+			if (!run || !isTextRun(run) || !run.hyperlink || !hyperlinksMatch(first.hyperlink, run.hyperlink)) break;
+			displayedText += toPaintedText(run.text);
+			hyperlinks.push(run.hyperlink);
+			groupEnd += 1;
+		}
+		if (DISPLAYED_URL_PATTERN.test(displayedText.trim())) for (const hyperlink of hyperlinks) result.add(hyperlink);
+		index = groupEnd;
+	}
+	return result;
+}
 /**
 * Check if run is a tab run
 */
@@ -144,8 +174,8 @@ function applyRunStyles(element, run) {
 		element.style.webkitTextStroke = "1px currentColor";
 		element.style.webkitTextFillColor = "transparent";
 	}
-	if (run.rtl === true) element.dir = "rtl";
-	else if (run.rtl === false) element.dir = "ltr";
+	if (run.rtl === true) element.dir = RIGHT_TO_LEFT_DIRECTION;
+	else if (run.rtl === false) element.dir = LEFT_TO_RIGHT_DIRECTION;
 	if (run.textEffect) {
 		element.classList.add("docx-text-effect", `docx-text-effect-${run.textEffect}`);
 		element.dataset["effect"] = run.textEffect;
@@ -264,7 +294,7 @@ function applyPmPositions(element, pmStart, pmEnd) {
 /**
 * Render a text run
 */
-function renderTextRun(run, doc) {
+function renderTextRun(run, doc, hyperlinkDirection) {
 	const span = doc.createElement("span");
 	span.className = `${PARAGRAPH_CLASS_NAMES.run} ${PARAGRAPH_CLASS_NAMES.text}`;
 	if (run.footnoteRefId !== void 0) {
@@ -284,6 +314,7 @@ function renderTextRun(run, doc) {
 	if (run.hyperlink) {
 		const anchor = doc.createElement("a");
 		anchor.href = run.hyperlink.href;
+		if (hyperlinkDirection || DISPLAYED_URL_PATTERN.test(paintedText.trim())) anchor.dir = LEFT_TO_RIGHT_DIRECTION;
 		if (!run.hyperlink.href.startsWith("#")) {
 			anchor.target = "_blank";
 			anchor.rel = "noopener noreferrer";
@@ -1053,7 +1084,7 @@ function renderLine(block, line, alignment, doc, options) {
 		return withCursiveJoiners(runEl, run, cursiveJoinerPlan, applyJoinerRunStyles, doc);
 	};
 	const renderLineTextRun = (run) => {
-		const runEl = renderTextRun(run, doc);
+		const runEl = renderTextRun(run, doc, run.hyperlink && options?.leftToRightDisplayedUrlHyperlinks?.has(run.hyperlink) ? LEFT_TO_RIGHT_DIRECTION : void 0);
 		if (collapsedLeadingSpaceRuns.has(run)) runEl.dataset["collapsedLeadingSpaces"] = "true";
 		if (collapsedTrailingSpaceRuns.has(run)) runEl.dataset["collapsedTrailingSpaces"] = "true";
 		if (isCollapsedLineEdgeSpaceRun(run)) {
@@ -1125,7 +1156,8 @@ function renderLine(block, line, alignment, doc, options) {
 	const measureText = collapsedSpaceMeasureText ?? (hasTabRuns || hasScaledTextRun ? createTextMeasurer(doc) : void 0);
 	if (hasTabRuns) {
 		const explicitStops = options?.tabStops?.map(convertTabStopToCalc);
-		const leftIndentTwips = options?.leftIndentPx ? Math.round(options.leftIndentPx * 15) : 0;
+		const tabLeftIndentPx = options?.tabLeftIndentPx ?? options?.leftIndentPx ?? 0;
+		const leftIndentTwips = Math.round(tabLeftIndentPx * 15);
 		tabContext = {
 			...explicitStops !== void 0 ? { explicitStops } : {},
 			...block.attrs?.defaultTabStopTwips !== void 0 ? { defaultTabInterval: block.attrs.defaultTabStopTwips } : {},
@@ -1134,11 +1166,13 @@ function renderLine(block, line, alignment, doc, options) {
 	}
 	let currentX;
 	const leftIndentPx = options?.leftIndentPx ?? 0;
+	const tabLeftIndentPx = options?.tabLeftIndentPx ?? leftIndentPx;
+	const floatingLeftOffsetPx = options?.floatingMargins?.leftMargin ?? 0;
 	if (options?.isFirstLine) {
 		const firstLineIndentPx = options.firstLineIndentPx ?? 0;
 		const markerInlineWidth = getListMarkerInlineWidth(block);
-		currentX = leftIndentPx + firstLineIndentPx + markerInlineWidth;
-	} else currentX = leftIndentPx;
+		currentX = tabLeftIndentPx + firstLineIndentPx + markerInlineWidth + floatingLeftOffsetPx;
+	} else currentX = tabLeftIndentPx + floatingLeftOffsetPx;
 	for (let i = 0; i < runsForLine.length; i++) {
 		const run = runsForLine[i];
 		if (isTabRun(run) && tabContext && measureText) {
@@ -1160,7 +1194,7 @@ function renderLine(block, line, alignment, doc, options) {
 					break;
 				}
 			}
-			if (lineRightEdgeX !== void 0 && tabResult.alignment === "end" && !hasFollowingTab && currentX + tabResult.width + followingWidthForCheck >= lineRightEdgeX - RIGHT_EDGE_EPSILON_PX) {
+			if (lineRightEdgeX !== void 0 && options?.isRtl !== true && tabResult.alignment === "end" && !hasFollowingTab && currentX + tabResult.width + followingWidthForCheck >= lineRightEdgeX - RIGHT_EDGE_EPSILON_PX) {
 				lineEl.style.display = "flex";
 				lineEl.style.alignItems = "baseline";
 				lineEl.style.whiteSpace = "pre";
@@ -1173,7 +1207,8 @@ function renderLine(block, line, alignment, doc, options) {
 				tabEl.style.minWidth = "0";
 				tabEl.style.width = "auto";
 				lineEl.append(tabEl);
-				if (options?.isFirstLine && options.firstLineIndentPx !== void 0 && options.firstLineIndentPx !== 0 && lineEl.firstElementChild instanceof HTMLElement) lineEl.firstElementChild.style.marginLeft = `${options.firstLineIndentPx}px`;
+				const firstFlexChild = lineEl.firstElementChild ?? void 0;
+				if (options?.isFirstLine && options.firstLineIndentPx !== void 0 && options.firstLineIndentPx !== 0 && isStyleableHTMLElement(firstFlexChild)) firstFlexChild.style.marginLeft = `${options.firstLineIndentPx}px`;
 				for (let j = i + 1; j < runsForLine.length; j++) {
 					const next = runsForLine[j];
 					if (isTabRun(next) || isLineBreakRun(next)) break;
@@ -1191,7 +1226,10 @@ function renderLine(block, line, alignment, doc, options) {
 				break;
 			}
 			let tabWidth = tabResult.width;
-			if (!(tabResult.alignment === "start" && leftIndentPx > 0 && Math.abs(currentX + tabWidth - leftIndentPx) <= RIGHT_EDGE_EPSILON_PX) && lineRightEdgeX !== void 0 && canClampTabToRightEdge(tabResult.alignment, i > 0, runsForLine.slice(0, i).some(isTabRun), options?.isLastLine === true) && currentX + tabWidth + followingWidthForCheck > lineRightEdgeX) tabWidth = Math.max(1, lineRightEdgeX - currentX - followingWidthForCheck);
+			const activeContentRightEdge = options?.contentWidthPx === void 0 ? void 0 : options.contentWidthPx - (options.floatingMargins?.rightMargin ?? 0);
+			const preservesLogicalRtlEndStop = options?.isRtl === true && tabResult.alignment === "end" && activeContentRightEdge !== void 0 && currentX + tabWidth + followingWidthForCheck <= activeContentRightEdge + RIGHT_EDGE_EPSILON_PX;
+			const landsOnLeftIndent = tabResult.alignment === "start" && tabLeftIndentPx > 0 && Math.abs(currentX + tabWidth - tabLeftIndentPx) <= RIGHT_EDGE_EPSILON_PX;
+			if (!preservesLogicalRtlEndStop && !landsOnLeftIndent && lineRightEdgeX !== void 0 && canClampTabToRightEdge(tabResult.alignment, i > 0, runsForLine.slice(0, i).some(isTabRun), options?.isLastLine === true) && currentX + tabWidth + followingWidthForCheck > lineRightEdgeX) tabWidth = Math.max(1, lineRightEdgeX - currentX - followingWidthForCheck);
 			const tabEl = renderTabRun(run, doc, tabWidth, tabResult.leader);
 			lineEl.append(tabEl);
 			currentX += tabWidth;
@@ -1281,22 +1319,6 @@ function bordersFormGroup(a, b) {
 	return bordersEqual(a.top, b.top) && bordersEqual(a.bottom, b.bottom) && bordersEqual(a.left, b.left) && bordersEqual(a.right, b.right) && bordersEqual(a.between, b.between);
 }
 /**
-* Decide whether a paragraph without an explicit `w:bidi` flag should still be
-* laid out right-to-left. Only paragraphs that carry at least one `w:rtl` run
-* are candidates; among those the base direction follows the first strong
-* directional character (the `dir="auto"` rule), so Hebrew/Arabic-led lines
-* order RTL while an English- (or CJK-/Devanagari-/…) led line stays LTR.
-* eigenpal #723 (#719).
-*/
-function paragraphBaseIsRtl(block) {
-	const runs = block.runs.filter((r) => isTextRun(r) || isFieldRun(r));
-	if (!runs.some((r) => r.rtl)) return false;
-	return detectBaseDirection(runs.map((r) => {
-		if (isTextRun(r)) return r.text;
-		return isFieldRun(r) ? r.fallback ?? "" : "";
-	}).join("")) !== "ltr";
-}
-/**
 * Render a paragraph fragment
 *
 * @param fragment - The fragment to render
@@ -1322,7 +1344,7 @@ function renderParagraphFragment(fragment, block, measure, context, options = {}
 	const lines = measure.lines.slice(fragment.fromLine, fragment.toLine);
 	const alignment = block.attrs?.alignment;
 	if (block.attrs?.styleId) fragmentEl.dataset["styleId"] = block.attrs.styleId;
-	const isRtl = block.attrs?.bidi ?? paragraphBaseIsRtl(block);
+	const isRtl = isRtlParagraph(block);
 	if (isRtl) fragmentEl.dir = "rtl";
 	if (alignment) if (alignment === "center") fragmentEl.style.textAlign = "center";
 	else if (alignment === "right") fragmentEl.style.textAlign = "right";
@@ -1407,6 +1429,7 @@ function renderParagraphFragment(fragment, block, measure, context, options = {}
 	else if (indent?.firstLine && indent.firstLine > 0) firstLineIndentPx = indent.firstLine;
 	let _cumulativeLineY = 0;
 	const renderedInlineImageKeys = options.renderedInlineImageKeys ?? /* @__PURE__ */ new Set();
+	const leftToRightDisplayedUrlHyperlinks = isRtl ? collectLeftToRightDisplayedUrlHyperlinks(block.runs) : void 0;
 	for (let i = 0; i < lines.length; i++) {
 		const line = lines[i];
 		const lineIndex = fragment.fromLine + i;
@@ -1422,13 +1445,17 @@ function renderParagraphFragment(fragment, block, measure, context, options = {}
 			paragraphEndsWithLineBreak,
 			...block.attrs?.tabs !== void 0 ? { tabStops: block.attrs.tabs } : {},
 			leftIndentPx: indentLeft,
+			tabLeftIndentPx: indent?.left ?? 0,
 			firstLineIndentPx: isFirstLine ? firstLineIndentPx : 0,
+			isRtl,
+			contentWidthPx: fragment.width,
 			context,
 			floatingMargins: {
 				leftMargin: lineLeftOffset,
 				rightMargin: lineRightOffset
 			},
 			renderedInlineImageKeys,
+			...leftToRightDisplayedUrlHyperlinks === void 0 ? {} : { leftToRightDisplayedUrlHyperlinks },
 			lineRightEdgePx: fragment.width - indentRight - lineRightOffset
 		});
 		const isFlexLine = lineEl.dataset["flexLine"] === "true";
@@ -1447,13 +1474,8 @@ function renderParagraphFragment(fragment, block, measure, context, options = {}
 		const hasHanging = indent?.hanging && indent.hanging > 0;
 		const hasFirstLine = indent?.firstLine && indent.firstLine > 0;
 		if (isFirstLine) {
-			if (indentLeft !== 0 && hasHanging) {
-				lineEl.style.paddingLeft = `${Math.max(indentLeft, 0)}px`;
-				if (!isFlexLine) lineEl.style.textIndent = `-${indent.hanging ?? 0}px`;
-			} else if (indentLeft !== 0 && hasFirstLine) {
-				lineEl.style.paddingLeft = `${Math.max(indentLeft, 0)}px`;
-				if (!isFlexLine) lineEl.style.textIndent = `${indent.firstLine ?? 0}px`;
-			} else if (indentLeft > 0) lineEl.style.paddingLeft = `${indentLeft}px`;
+			if (indentLeft > 0) lineEl.style.paddingLeft = `${indentLeft}px`;
+			if (hasHanging && !isFlexLine) lineEl.style.textIndent = `-${indent.hanging ?? 0}px`;
 			else if (hasFirstLine && !isFlexLine) lineEl.style.textIndent = `${indent.firstLine ?? 0}px`;
 		} else if (indentLeft > 0) lineEl.style.paddingLeft = `${indentLeft}px`;
 		if (indentRight > 0) lineEl.style.paddingRight = `${indentRight}px`;

package/dist/layout-painter/renderTable.js

@@ -1,7 +1,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 { getTableRowLeadingWidth, isFloatingImageRun, isFloatingTextBoxBlock, tableColumnsArePinned } from "../layout-engine/types.js";
+import { getTableRowLeadingWidth, isFloatingImageRun, isFloatingTextBoxBlock, resolveTableCellPadding, tableColumnsArePinned } from "../layout-engine/types.js";
 import { applySanitizedImageSrc } from "../utils/sanitizeImageSrc.js";
 import { emuToPixels } from "../utils/units.js";
 import { resolveAnchoredImagePosition } from "./anchoredImagePosition.js";
@@ -330,10 +330,7 @@ function renderTableCell({ cell, cellMeasure, x, rowHeight, borderFlags, columns
 	cellEl.style.height = `${rowHeight}px`;
 	cellEl.style.overflow = "hidden";
 	cellEl.style.boxSizing = "border-box";
-	const padTop = cell.padding?.top ?? 1;
-	const padRight = cell.padding?.right ?? 7;
-	const padBottom = cell.padding?.bottom ?? 1;
-	const padLeft = cell.padding?.left ?? 7;
+	const { top: padTop, right: padRight, bottom: padBottom, left: padLeft } = resolveTableCellPadding(cell);
 	cellEl.style.padding = `${padTop}px ${padRight}px ${padBottom}px ${padLeft}px`;
 	if (cell.borders) {
 		if (borderFlags.drawTop) applyBorder(cellEl, "top", cell.borders.top);

package/dist/layout-painter/renderTextBox.js

@@ -26,7 +26,7 @@ function renderTextBoxFragment(fragment, block, measure, context, options = {})
 	containerEl.style.position = "absolute";
 	containerEl.style.width = `${fragment.width}px`;
 	containerEl.style.height = `${fragment.height}px`;
-	containerEl.style.overflow = "hidden";
+	containerEl.style.overflow = block.textWrap === "none" ? "visible" : "hidden";
 	containerEl.style.boxSizing = "border-box";
 	if (block.fillColor) containerEl.style.backgroundColor = block.fillColor;
 	if (block.outlineWidth && block.outlineWidth > 0) {

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

@@ -1,3 +1,4 @@
+import { document_d_exports } from "../types/document.js";
 import { ImageRun, isFloatingImageRun, isTextWrappingFloatingImageRun } from "../layout-engine/types.js";
 //#region src/layout-painter/renderUtils.d.ts
 /**
@@ -17,7 +18,7 @@ type RenderContext = {
   /** Current page number (1-indexed) */
   pageNumber: number;
   /** OOXML section-level format for the current logical page number. */
-  pageNumberFormat?: string;
+  pageNumberFormat?: document_d_exports.NumberFormat;
   /** Total number of pages */
   totalPages: number;
   /** Which section is being rendered */

package/dist/prosemirror/attrs/index.js

@@ -25,6 +25,7 @@ const TEXT_BOX_AUTO_FIT_VALUES = [
 	"normal",
 	"shape"
 ];
+const TEXT_BOX_TEXT_WRAP_VALUES = ["square", "none"];
 const FIELD_KINDS = ["simple", "complex"];
 const MATH_DISPLAYS = ["inline", "block"];
 const SHAPE_FILL_TYPES = [
@@ -463,6 +464,7 @@ const readTextBoxAttrs = (node) => {
 	optionalNumber(attrs, "width", "textBox.attrs.width", issues);
 	optionalNumber(attrs, "height", "textBox.attrs.height", issues);
 	optionalOneOf(attrs, "autoFit", "textBox.attrs.autoFit", issues, TEXT_BOX_AUTO_FIT_VALUES);
+	optionalOneOf(attrs, "textWrap", "textBox.attrs.textWrap", issues, TEXT_BOX_TEXT_WRAP_VALUES);
 	optionalString(attrs, "textBoxId", "textBox.attrs.textBoxId", issues);
 	optionalString(attrs, "fillColor", "textBox.attrs.fillColor", issues);
 	optionalNumber(attrs, "outlineWidth", "textBox.attrs.outlineWidth", issues);

package/dist/prosemirror/conversion/fromProseDoc.js

@@ -1878,6 +1878,7 @@ function convertPMTextBox(node) {
 				content: []
 			}],
 			...attrs.autoFit !== void 0 ? { autoFit: attrs.autoFit } : {},
+			...attrs.textWrap !== void 0 ? { textWrap: attrs.textWrap } : {},
 			margins: (() => {
 				const m = {};
 				if (typeof attrs.marginTop === "number") m.top = pixelsToEmu(attrs.marginTop);

package/dist/prosemirror/conversion/toProseDoc.js

@@ -1523,6 +1523,7 @@ function textBoxFromShape(shape, textBody) {
 	if (shape.outline) textBox.outline = shape.outline;
 	if (textBody.margins) textBox.margins = textBody.margins;
 	if (textBody.autoFit) textBox.autoFit = textBody.autoFit;
+	if (textBody.textWrap) textBox.textWrap = textBody.textWrap;
 	return textBox;
 }
 /**
@@ -1597,6 +1598,7 @@ function convertTextBox(textBox, styleResolver, options) {
 		width: widthPx,
 		height: heightPx,
 		autoFit: textBox.autoFit,
+		textWrap: textBox.textWrap,
 		textBoxId: textBox.id,
 		fillColor,
 		outlineWidth,

package/dist/prosemirror/extensions/nodes/TextBoxExtension.d.ts

@@ -10,6 +10,8 @@ type TextBoxAttrs = {
   height?: number;
   /** Text fitting behavior */
   autoFit?: document_d_exports.ShapeTextBody["autoFit"];
+  /** Horizontal text wrapping inside the box */
+  textWrap?: document_d_exports.ShapeTextBody["textWrap"];
   /** Unique identifier */
   textBoxId?: string;
   /** Fill color as CSS color */

package/dist/prosemirror/extensions/nodes/TextBoxExtension.js

@@ -18,6 +18,9 @@ function parseTextBoxWrapType(raw) {
 function parseTextBoxAutoFit(raw) {
 	if (raw === "none" || raw === "normal" || raw === "shape") return raw;
 }
+function parseTextBoxTextWrap(raw) {
+	if (raw === "none" || raw === "square") return raw;
+}
 const TextBoxExtension = createNodeExtension({
 	name: "textBox",
 	schemaNodeName: "textBox",
@@ -30,6 +33,7 @@ const TextBoxExtension = createNodeExtension({
 			width: { default: 200 },
 			height: { default: null },
 			autoFit: { default: null },
+			textWrap: { default: null },
 			textBoxId: { default: null },
 			fillColor: { default: null },
 			outlineWidth: { default: null },
@@ -63,10 +67,12 @@ const TextBoxExtension = createNodeExtension({
 				const position = parseTextBoxPosition(d["position"]);
 				const wrapType = parseTextBoxWrapType(d["wrapType"]);
 				const autoFit = parseTextBoxAutoFit(d["autoFit"]);
+				const textWrap = parseTextBoxTextWrap(d["textWrap"]);
 				return {
 					...d["width"] ? { width: Number(d["width"]) } : {},
 					...d["height"] ? { height: Number(d["height"]) } : {},
 					...autoFit ? { autoFit } : {},
+					...textWrap ? { textWrap } : {},
 					...d["textboxId"] ? { textBoxId: d["textboxId"] } : {},
 					...d["fillColor"] ? { fillColor: d["fillColor"] } : {},
 					...d["outlineWidth"] ? { outlineWidth: Number(d["outlineWidth"]) } : {},
@@ -95,6 +101,7 @@ const TextBoxExtension = createNodeExtension({
 			if (attrs.width) domAttrs["data-width"] = String(attrs.width);
 			if (attrs.height) domAttrs["data-height"] = String(attrs.height);
 			if (attrs.autoFit) domAttrs["data-auto-fit"] = attrs.autoFit;
+			if (attrs.textWrap) domAttrs["data-text-wrap"] = attrs.textWrap;
 			if (attrs.textBoxId) domAttrs["data-textbox-id"] = attrs.textBoxId;
 			if (attrs.fillColor) domAttrs["data-fill-color"] = attrs.fillColor;
 			if (attrs.outlineWidth) domAttrs["data-outline-width"] = String(attrs.outlineWidth);

package/dist/prosemirror/schema/nodes.d.ts

@@ -457,6 +457,8 @@ type TextBoxAttrs = {
   height?: number;
   /** Text fitting behavior */
   autoFit?: document_d_exports.ShapeTextBody["autoFit"];
+  /** Horizontal text wrapping inside the box */
+  textWrap?: document_d_exports.ShapeTextBody["textWrap"];
   /** Unique identifier */
   textBoxId?: string;
   /** Fill color as CSS color */

package/dist/utils/paragraphBaseDirection.d.ts

@@ -0,0 +1,6 @@
+import { ParagraphBlock } from "../layout-engine/types.js";
+//#region src/utils/paragraphBaseDirection.d.ts
+/** Resolve the paragraph direction used by both measurement and painting. */
+declare const isRtlParagraph: (block: ParagraphBlock) => boolean;
+//#endregion
+export { isRtlParagraph };

package/dist/utils/paragraphBaseDirection.js

@@ -0,0 +1,12 @@
+import { detectBaseDirection } from "./baseDirection.js";
+//#region src/utils/paragraphBaseDirection.ts
+const isDirectionalTextRun = (run) => run.kind === "text" || run.kind === "field";
+/** Resolve the paragraph direction used by both measurement and painting. */
+const isRtlParagraph = (block) => {
+	if (block.attrs?.bidi !== void 0) return block.attrs.bidi;
+	const runs = block.runs.filter(isDirectionalTextRun);
+	if (!runs.some(({ rtl }) => rtl === true)) return false;
+	return detectBaseDirection(runs.map((run) => run.kind === "text" ? run.text : run.fallback ?? "").join("")) !== "ltr";
+};
+//#endregion
+export { isRtlParagraph };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stll/folio-core",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "description": "Headless, framework-neutral core of folio: the OOXML (.docx) parser, document model, ProseMirror integration, and page-layout engine. No React.",
   "keywords": [
     "document-model",
@@ -113,7 +113,7 @@
     "perf": "bun scripts/profile-editor.ts"
   },
   "dependencies": {
-    "@stll/docx-core": "^0.16.0",
+    "@stll/docx-core": "^0.17.0",
     "@stll/docx-utils": "^0.1.0",
     "@stll/template-conditions": "^0.1.0",
     "better-result": "3.0.1",