@stll/folio-core 0.5.0 → 0.6.1

package/dist/i18n/messages/messages.gen.d.ts

@@ -35,6 +35,7 @@ type Messages = {
         "red": "Red";
         "yellow": "Yellow";
       };
+      "custom": "Custom";
       "customColor": "Custom Color";
       "noColor": "No color";
       "standardColors": "Standard Colors";
@@ -59,6 +60,7 @@ type Messages = {
       "closeDialog": "Close";
       "insert": "Insert";
       "px": "px";
+      "remove": "Remove";
       "update": "Update";
     };
     "contentControlDateAriaLabel": "Pick a date";
@@ -122,13 +124,16 @@ type Messages = {
         "title": "Footnote & Endnote Properties";
       };
       "hyperlink": {
+        "addressLabel": "Address";
         "bookmarkLabel": "Bookmark";
         "bookmarkPlaceholder": "Select a bookmark";
         "displayTextHint": "Defaults to the selected text";
         "displayTextLabel": "Display text";
         "displayTextPlaceholder": "Text to display";
         "invalidUrl": "Enter a valid URL";
+        "linkTo": "Link to";
         "removeLink": "Remove link";
+        "screenTipLabel": "Screen tip";
         "tabBookmark": "Bookmark";
         "tabWebAddress": "Web address";
         "titleEdit": "Edit hyperlink";
@@ -150,9 +155,11 @@ type Messages = {
           "top": "Top";
         };
         "alignment": "Alignment";
+        "distanceFromText": "Distance from text (px)";
         "horizontal": "Horizontal";
         "offset": "Offset";
         "offsetPx": "Offset (px)";
+        "position": "Position";
         "relativeOptions": {
           "character": "Character";
           "column": "Column";
@@ -173,12 +180,17 @@ type Messages = {
           "dashed": "Dashed";
           "dotted": "Dotted";
           "double": "Double";
+          "groove": "Groove";
+          "inset": "Inset";
+          "outset": "Outset";
+          "ridge": "Ridge";
           "solid": "Solid";
         };
         "color": "Color";
         "dimensions": "Dimensions";
         "heightLabel": "Height";
         "lockAspectRatio": "Lock aspect ratio";
+        "preview": "Preview";
         "style": "Style";
         "textWrapping": "Text wrapping";
         "title": "Image Properties";
@@ -193,6 +205,11 @@ type Messages = {
           "wrapRight": "Wrap right";
         };
       };
+      "insertImage": {
+        "altText": "Alt text";
+        "imageFile": "Image file";
+        "title": "Insert Image";
+      };
       "insertSymbol": {
         "categories": {
           "arrows": "Arrows";
@@ -209,18 +226,19 @@ type Messages = {
         "title": "Insert symbol";
       };
       "insertTable": {
-        "autofit": "Autofit";
+        "autofit": "Autofit to contents";
         "columnWidthLabel": "Column width";
         "columnsLabel": "Columns";
         "fixedWidth": "Fixed width";
         "hoverToSelect": "Hover to select table size";
         "insertButton": "Insert";
         "orSpecifySize": "Or specify size";
+        "plainTable": "Plain table";
         "rowsLabel": "Rows";
         "sizeSelector": "Table size selector";
         "style": "Style";
         "tableSize": "{cols} × {rows} table";
-        "title": "Insert table";
+        "title": "Insert Table";
         "validationHint": "Rows: {minRows}–{maxRows}, columns: {minCols}–{maxCols}";
       };
       "pageSetup": {
@@ -245,6 +263,16 @@ type Messages = {
         "sizeLabel": "Size";
         "title": "Page Setup";
         "top": "Top";
+        "unitInches": "in";
+      };
+      "pasteSpecial": {
+        "pasteMode": "Paste mode";
+        "title": "Paste Special";
+      };
+      "splitCell": {
+        "mergeBeforeSplit": "Merge selected cells before splitting";
+        "splitButton": "Split";
+        "title": "Split Cell";
       };
       "tableProperties": {
         "alignOptions": {
@@ -266,6 +294,23 @@ type Messages = {
           "percentage": "Percentage";
         };
       };
+      "watermark": {
+        "color": "Color";
+        "diagonal": "Diagonal";
+        "font": "Font";
+        "imageRelationshipId": "Header image relationship id";
+        "imageTarget": "Image target";
+        "noWatermark": "No watermark";
+        "opacity": "Opacity";
+        "pictureWatermark": "Picture watermark";
+        "scale": "Scale";
+        "targetIsExternalUrl": "Target is an external URL";
+        "text": "Text";
+        "textWatermark": "Text watermark";
+        "title": "Watermark";
+        "type": "Type";
+        "washout": "Washout";
+      };
     };
     "discardChanges": "Discard";
     "dismiss": "Dismiss";
@@ -338,6 +383,17 @@ type Messages = {
       "superscriptShortcut": "Superscript (Ctrl+Shift+=)";
     };
     "formattingToolbar": "Formatting toolbar";
+    "headerFooter": {
+      "closeFooterEditing": "Close footer editing";
+      "closeHeaderEditing": "Close header editing";
+      "footer": "Footer";
+      "header": "Header";
+      "insertPageCount": "Insert total page count";
+      "insertPageNumber": "Insert current page number";
+      "options": "Options";
+      "removeFooter": "Remove footer";
+      "removeHeader": "Remove header";
+    };
     "hideDetails": "Hide details";
     "historyGroup": "History";
     "imageOverlay": {
@@ -399,6 +455,7 @@ type Messages = {
     };
     "listFormatting": "List formatting";
     "listsGroup": "Lists";
+    "loadDocumentFailedTitle": "Failed to Load Document";
     "loadingDocument": "Loading document...";
     "loadingEditor": "Loading editor...";
     "lockFile": "Lock file";
@@ -411,8 +468,10 @@ type Messages = {
     "moreFormatting": "More formatting";
     "networkError": "Network error. Please check your internet connection and try again.";
     "nextChange": "Next Change";
+    "noDocumentLoaded": "No document loaded";
     "numberedList": "Numbered List";
     "parseError": "The document could not be parsed. It may be corrupted or in an unsupported format.";
+    "parseErrorTitle": "Unable to Parse Document";
     "paste": "Paste";
     "pasteUnformatted": "Paste without formatting";
     "previousChange": "Previous Change";
@@ -572,6 +631,7 @@ type Messages = {
     "viewGroup": "View";
     "viewer": {
       "pageIndicator": "Page {current} of {total}";
+      "pageOfTotal": "{current} of {total}";
     };
     "zoom": {
       "zoomIn": "Zoom in";

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { FolioAIBlock, FolioAIBlockAnchor, FolioAIBlockKind, FolioAIBlockPreviewRun, FolioAIComment, FolioAIEditAppliedOperation, FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditOperation, FolioAIEditPrecondition, FolioAIEditReviewMeta, FolioAIEditSeverity, FolioAIEditSkipReason, FolioAIEditSkippedOperation, FolioAIEditSnapshot, FolioAISignatureParty } from "./ai-edits/types.js";
 import { applyFolioAIEditOperations } from "./ai-edits/apply.js";
 import { document_d_exports } from "./types/document.js";
-import { ApplyFolioDocumentOperationsOptions, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FolioDocumentOperation, FolioDocumentOperationAffectedTarget, FolioDocumentOperationBatch, FolioDocumentOperationCapabilities, FolioDocumentOperationIssue, FolioDocumentOperationMode, FolioDocumentOperationPrecondition, FolioDocumentOperationReceipt, FolioDocumentOperationRecovery, FolioDocumentOperationResult, FolioDocumentOperationStatus, FolioDocumentOperationType, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch } from "./document-operations.js";
+import { ApplyFolioDocumentOperationsOptions, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FolioDocumentOperation, FolioDocumentOperationAffectedTarget, FolioDocumentOperationBatch, FolioDocumentOperationCapabilities, FolioDocumentOperationIssue, FolioDocumentOperationMode, FolioDocumentOperationPrecondition, FolioDocumentOperationReceipt, FolioDocumentOperationRecovery, FolioDocumentOperationResult, FolioDocumentOperationStatus, FolioDocumentOperationType, FolioDocumentOperationUndoFailureReason, FolioDocumentOperationUndoHandle, FolioDocumentOperationUndoResult, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch } from "./document-operations.js";
 import { createFolioAIEditSnapshot, hashFolioAIBlockText, normalizeFolioAIBlockText } from "./ai-edits/snapshot.js";
 import { DeriveBlockIdInput, FolioBlockId, deriveBlockId, getFolioParaIdFromBlockId, isFolioBlockId, isSequentialFolioBlockId } from "./types/block-id.js";
 import { WordDiffSegment, diffWordSegments } from "./ai-edits/word-diff.js";
@@ -27,4 +27,4 @@ import { toMarkdown, toMarkdownResult } from "./markdown/index.js";
 import { EmbeddedFont, EmbeddedFontParts, extractEmbeddedFonts, getEmbeddedFontFaces } from "./fonts/embeddedFonts.js";
 import { getGoogleFontsEnabled, setGoogleFontsEnabled } from "./utils/fontResolver.js";
 type Document = document_d_exports.Document;
-export { type AIBarStatus, type AIChatMode, type AICitation, type AICitationRange, type AICitationSource, type AIGenerateInput, type AISuggestion, type AISuggestionApplyMode, type AISuggestionPreset, type AISuggestionSeverity, type AISuggestionStatus, type AcceptAutocompleteResult, type AnonymizationMatch, type AnonymizationTerm, type ApplyFolioDocumentOperationsOptions, type ApplyResult, type AutocompleteSuggestionPluginOptions, type AutocompleteSuggestionState, type AutocompleteSuggestionStatus, type AutocompleteTriggerCheck, type AutocompleteTriggerOptions, type AutocompleteTriggerSkipReason, type CreateEmptyDocumentOptions, DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, type DeriveBlockIdInput, type DirectiveKind, type DirectiveRange, type Document, type DocxCompatibility, type EmbeddedFont, type EmbeddedFontParts, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIComment, type FolioAIEditAppliedOperation, type FolioAIEditApplyMode, type FolioAIEditApplyResult, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditReviewMeta, type FolioAIEditSeverity, type FolioAIEditSkipReason, type FolioAIEditSkippedOperation, type FolioAIEditSnapshot, type FolioAISignatureParty, type FolioBlockId, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationStatus, type FolioDocumentOperationType, type ImageMeta, type ImageRef, InvalidFolioDocumentOperationBatchError, type MarkdownOptions, type MarkdownResult, type PositionalText, type ResolvedAnchor, type TemplatePreviewSpan, type TemplatePreviewValue, type TemplatePreviewValues, type TemplateSlashMenuKeyAction, type TemplateSlashMenuState, UnsupportedFolioDocumentOperationVersionError, type WordDiffSegment, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, deriveBlockId, diffWordSegments, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };
+export { type AIBarStatus, type AIChatMode, type AICitation, type AICitationRange, type AICitationSource, type AIGenerateInput, type AISuggestion, type AISuggestionApplyMode, type AISuggestionPreset, type AISuggestionSeverity, type AISuggestionStatus, type AcceptAutocompleteResult, type AnonymizationMatch, type AnonymizationTerm, type ApplyFolioDocumentOperationsOptions, type ApplyResult, type AutocompleteSuggestionPluginOptions, type AutocompleteSuggestionState, type AutocompleteSuggestionStatus, type AutocompleteTriggerCheck, type AutocompleteTriggerOptions, type AutocompleteTriggerSkipReason, type CreateEmptyDocumentOptions, DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, type DeriveBlockIdInput, type DirectiveKind, type DirectiveRange, type Document, type DocxCompatibility, type EmbeddedFont, type EmbeddedFontParts, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIComment, type FolioAIEditAppliedOperation, type FolioAIEditApplyMode, type FolioAIEditApplyResult, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditReviewMeta, type FolioAIEditSeverity, type FolioAIEditSkipReason, type FolioAIEditSkippedOperation, type FolioAIEditSnapshot, type FolioAISignatureParty, type FolioBlockId, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationStatus, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type ImageMeta, type ImageRef, InvalidFolioDocumentOperationBatchError, type MarkdownOptions, type MarkdownResult, type PositionalText, type ResolvedAnchor, type TemplatePreviewSpan, type TemplatePreviewValue, type TemplatePreviewValues, type TemplateSlashMenuKeyAction, type TemplateSlashMenuState, UnsupportedFolioDocumentOperationVersionError, type WordDiffSegment, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, deriveBlockId, diffWordSegments, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };

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

@@ -6,8 +6,9 @@ import { resolveColor, resolveHighlightToCss } from "../../utils/colorResolver.j
 import { resolveShadingFill } from "../../utils/formatToStyle.js";
 import { convertBulletToUnicode } from "../../docx/bulletMarkers.js";
 import { setTextBoxGroupId } from "../../layout-engine/textBoxGroup.js";
+import { getColumns } from "../sectionColumns.js";
 import { directionIsRtl } from "../../prosemirror/paragraphDirection.js";
-import { expectBlockSdtAttrs, expectCharacterSpacingMarkAttrs, expectCommentMarkAttrs, expectEmphasisMarkAttrs, expectFieldAttrs, expectFontFamilyMarkAttrs, expectFontSizeMarkAttrs, expectFootnoteRefMarkAttrs, expectHighlightMarkAttrs, expectHyperlinkMarkAttrs, expectImageAttrs, expectMathAttrs, expectParagraphAttrs, expectRunFormattingOverrideMarkAttrs, expectRunShadingMarkAttrs, expectTableAttrs, expectTableCellAttrs, expectTableRowAttrs, expectTextBoxAttrs, expectTextColorMarkAttrs, expectTextEffectMarkAttrs, expectTrackedChangeMarkAttrs, expectUnderlineMarkAttrs } from "../../prosemirror/attrs/index.js";
+import { expectBlockSdtAttrs, expectCharacterSpacingMarkAttrs, expectCommentMarkAttrs, expectEmphasisMarkAttrs, expectFieldAttrs, expectFontFamilyMarkAttrs, expectFontSizeMarkAttrs, expectFootnoteRefMarkAttrs, expectHardBreakAttrs, expectHighlightMarkAttrs, expectHyperlinkMarkAttrs, expectImageAttrs, expectMathAttrs, expectParagraphAttrs, expectRunFormattingOverrideMarkAttrs, expectRunShadingMarkAttrs, expectTableAttrs, expectTableCellAttrs, expectTableRowAttrs, expectTextBoxAttrs, expectTextColorMarkAttrs, expectTextEffectMarkAttrs, expectTrackedChangeMarkAttrs, expectUnderlineMarkAttrs } from "../../prosemirror/attrs/index.js";
 import { autospacingMatchesBase } from "../../prosemirror/autospacingBase.js";
 import { runShadingAttrsToShading } from "../../prosemirror/conversion/runShadingMark.js";
 import { assertValidProseMirrorDocument } from "../../prosemirror/validation.js";
@@ -919,6 +920,7 @@ function convertTableCell(node, startPos, options, tableCellMargins) {
 			const block = convertParagraph(child, offset, options);
 			blocks.push(block);
 		} else if (child.type.name === "table") blocks.push(convertTable(child, offset, options));
+		else if (child.type.name === "textBox") blocks.push(convertTextBoxNode(child, offset, options));
 		offset += child.nodeSize;
 	});
 	const trailingBlock = blocks.at(-1);
@@ -1213,9 +1215,17 @@ function toFlowBlocks(doc, options = {}) {
 		}
 		switch (node.type.name) {
 			case "paragraph": {
-				const block = convertParagraph(node, pos, opts);
 				const pmAttrs = expectParagraphAttrs(node);
-				trackedPush(block);
+				const onlyChild = node.childCount === 1 ? node.firstChild : null;
+				if (onlyChild?.type.name === "hardBreak" && expectHardBreakAttrs(onlyChild).breakType === "column") {
+					const columnBreak = {
+						kind: "columnBreak",
+						id: nextBlockId(),
+						pmStart: pos,
+						pmEnd: pos + node.nodeSize
+					};
+					trackedPush(columnBreak);
+				} else trackedPush(convertParagraph(node, pos, opts));
 				const secProps = pmAttrs._sectionProperties;
 				if (secProps || pmAttrs.sectionBreakType) {
 					const sectionBreak = {
@@ -1245,16 +1255,8 @@ function toFlowBlocks(doc, options = {}) {
 							if (secProps.headerDistance !== void 0) sectionBreak.margins.header = twipsToPixels(secProps.headerDistance);
 							if (secProps.footerDistance !== void 0) sectionBreak.margins.footer = twipsToPixels(secProps.footerDistance);
 						}
-						const colCount = secProps.columnCount ?? 1;
-						if (colCount > 1) {
-							const cols = {
-								count: colCount,
-								gap: twipsToPixels(secProps.columnSpace ?? 720),
-								equalWidth: secProps.equalWidth ?? true
-							};
-							if (secProps.separator !== void 0) cols.separator = secProps.separator;
-							sectionBreak.columns = cols;
-						}
+						const columns = getColumns(secProps);
+						if (columns) sectionBreak.columns = columns;
 					}
 					trackedPush(sectionBreak);
 				}

package/dist/layout-bridge/sectionColumns.js

@@ -7,13 +7,18 @@ const DEFAULT_COLUMN_SPACE_TWIPS = 720;
 * Returns undefined for single-column (default) to avoid unnecessary paginator overhead.
 */
 function getColumns(sectionProps) {
-	const count = sectionProps?.columnCount ?? 1;
+	const authoredColumns = sectionProps?.columns;
+	const count = sectionProps?.columnCount ?? authoredColumns?.length ?? 1;
 	if (count <= 1) return void 0;
 	const columns = {
 		count,
 		gap: twipsToPixels(sectionProps?.columnSpace ?? DEFAULT_COLUMN_SPACE_TWIPS),
 		equalWidth: sectionProps?.equalWidth ?? true
 	};
+	if (sectionProps?.equalWidth === false && authoredColumns?.length === count && authoredColumns.every(({ width }) => width !== void 0)) {
+		columns.widths = authoredColumns.map(({ width }) => twipsToPixels(width ?? 0));
+		columns.gaps = authoredColumns.slice(0, -1).map(({ space }) => twipsToPixels(space ?? sectionProps.columnSpace ?? DEFAULT_COLUMN_SPACE_TWIPS));
+	}
 	if (sectionProps?.separator !== void 0) columns.separator = sectionProps.separator;
 	return columns;
 }

package/dist/layout-engine/index.js

@@ -156,7 +156,8 @@ function layoutDocument(blocks, measures, options) {
 		pageSize: finalPageSize,
 		margins: finalMargins
 	};
-	if (options.columns !== void 0) finalConfig.columns = options.columns;
+	const finalColumns = options.finalColumns ?? options.columns;
+	if (finalColumns !== void 0) finalConfig.columns = finalColumns;
 	const { configs: sectionConfigs, breakIndices } = collectSectionConfigs(blocks, bodyConfig, finalConfig);
 	const sectionBreakTypes = [...breakIndices.map((index) => blocks[index].type), options.bodyBreakType];
 	const initialConfig = sectionConfigs.at(0) ?? bodyConfig;
@@ -197,11 +198,11 @@ function layoutDocument(blocks, measures, options) {
 		const pageBeforeBlockLayout = paginator.getCurrentState().page.number;
 		switch (block.kind) {
 			case "paragraph":
-				layoutParagraph(block, measure, paginator, paginator.getContentWidth(), options.footnoteHeightById);
+				layoutParagraph(block, measure, paginator, paginator.columnWidth, options.footnoteHeightById);
 				break;
 			case "table":
 				if (block.floating) layoutFloatingTable(block, measure, paginator, paginator.getContentWidth());
-				else layoutTable(block, measure, paginator);
+				else layoutTable(block, measure, paginator, options.footnoteHeightById);
 				break;
 			case "image":
 				layoutImage(block, measure, paginator);
@@ -416,9 +417,10 @@ function getHeaderRowsHeight(measure, headerRowCount) {
 /**
 * Layout a table block onto pages.
 */
-function layoutTable(block, measure, paginator) {
+function layoutTable(block, measure, paginator, footnoteHeightById) {
 	const rows = measure.rows;
 	if (rows.length === 0) return;
+	const rowFootnoteIds = block.rows.map((row) => collectTableRowFootnoteIds(row, footnoteHeightById));
 	const headerRowCount = countHeaderRows(block);
 	const headerRowsHeight = getHeaderRowsHeight(measure, headerRowCount);
 	let currentRowIndex = 0;
@@ -427,9 +429,9 @@ function layoutTable(block, measure, paginator) {
 		let x = paginator.getColumnX(columnIndex);
 		if (block.justification === "center") x += (paginator.columnWidth - measure.totalWidth) / 2;
 		else if (block.justification === "right") x = x + paginator.columnWidth - measure.totalWidth;
-		else if (block.indent !== void 0) {
-			const leadingCellMargin = block.rows[0]?.cells[0]?.padding?.left ?? 0;
-			x += block.indent - leadingCellMargin;
+		else {
+			const leadingCellMargin = block.rows.at(0)?.cells.at(0)?.padding?.left ?? 0;
+			x += (block.indent ?? 0) - leadingCellMargin;
 		}
 		return x;
 	};
@@ -507,13 +509,42 @@ function layoutTable(block, measure, paginator) {
 		const normalHeaderOverhead = repeatHeaderRowsForNormalFragment ? headerRowsHeight : 0;
 		let rowsHeight = 0;
 		let fittingRows = 0;
+		const pageFootnoteIds = new Set(state.page.footnoteIds ?? []);
+		const fragmentFootnoteIds = [];
+		let fragmentFootnoteHeight = 0;
+		let retryOnNextFlowRegion = false;
 		for (let j = currentRowIndex; j < rows.length; j++) {
 			const rowHeight = rows[j].height;
-			if (rowsHeight + rowHeight + normalHeaderOverhead <= availableHeight || fittingRows === 0) {
+			const currentRowFootnoteIds = rowFootnoteIds[j] ?? [];
+			const fragmentFootnoteCountBeforeRow = fragmentFootnoteIds.length;
+			let rowFootnoteHeight = 0;
+			for (const id of currentRowFootnoteIds) {
+				if (pageFootnoteIds.has(id) || fragmentFootnoteIds.includes(id)) continue;
+				fragmentFootnoteIds.push(id);
+				rowFootnoteHeight += footnoteHeightById?.get(id) ?? 0;
+			}
+			const separatorHeight = pageFootnoteIds.size === 0 && fragmentFootnoteHeight + rowFootnoteHeight > 0 ? 12 : 0;
+			if (rowsHeight + rowHeight + normalHeaderOverhead + fragmentFootnoteHeight + rowFootnoteHeight + separatorHeight <= availableHeight) {
 				rowsHeight += rowHeight;
+				fragmentFootnoteHeight += rowFootnoteHeight;
 				fittingRows++;
-			} else break;
+			} else if (fittingRows === 0) {
+				if (state.cursorY === state.topMargin && state.page.fragments.length === 0) {
+					rowsHeight += rowHeight;
+					fragmentFootnoteHeight += rowFootnoteHeight;
+					fittingRows++;
+					break;
+				}
+				fragmentFootnoteIds.splice(fragmentFootnoteCountBeforeRow);
+				paginator.forceColumnBreak();
+				retryOnNextFlowRegion = true;
+				break;
+			} else {
+				fragmentFootnoteIds.splice(fragmentFootnoteCountBeforeRow);
+				break;
+			}
 		}
+		if (retryOnNextFlowRegion) continue;
 		const fragmentHeight = rowsHeight + normalHeaderOverhead;
 		const isLastFragment = currentRowIndex + fittingRows >= rows.length;
 		const desiredX = computeTableX(state.columnIndex);
@@ -533,6 +564,7 @@ function layoutTable(block, measure, paginator) {
 			...repeatHeaderRowsForNormalFragment ? { headerRowCount } : {},
 			...block.sdtGroups ? { sdtGroups: block.sdtGroups } : {}
 		};
+		if (fragmentFootnoteHeight > 0) paginator.addFootnoteHeight(fragmentFootnoteHeight, fragmentFootnoteIds);
 		fragment.y = paginator.addFragment(fragment, fragmentHeight, bandSkip, 0).y;
 		fragment.x = desiredX;
 		currentRowIndex += fittingRows;
@@ -549,6 +581,25 @@ function layoutTable(block, measure, paginator) {
 		}
 	}
 }
+function collectTableRowFootnoteIds(row, footnoteHeightById) {
+	if (!row || !footnoteHeightById) return [];
+	const ids = [];
+	const walk = (blocks) => {
+		for (const block of blocks) {
+			if (block.kind === "paragraph") {
+				for (const run of block.runs) if (run.kind === "text" && run.footnoteRefId !== void 0 && footnoteHeightById.has(run.footnoteRefId) && !ids.includes(run.footnoteRefId)) ids.push(run.footnoteRefId);
+				continue;
+			}
+			if (block.kind === "table") {
+				for (const nestedRow of block.rows) for (const cell of nestedRow.cells) walk(cell.blocks);
+				continue;
+			}
+			if (block.kind === "textBox") walk(block.content);
+		}
+	};
+	for (const cell of row.cells) walk(cell.blocks);
+	return ids;
+}
 /**
 * Layout a floating table (anchored) without advancing the cursor.
 */
@@ -587,8 +638,9 @@ function layoutFloatingTable(block, measure, paginator, contentWidth) {
 		else if (spec === "center") y = baseY + (contentHeight - tableHeight) / 2;
 	}
 	if (!usedExplicitY) y = paginator.ensureFits(tableHeight).cursorY;
-	const minX = margins.left;
-	const maxX = margins.left + contentWidth - tableWidth;
+	const pageAnchored = floating?.horzAnchor === "page";
+	const minX = pageAnchored ? 0 : margins.left;
+	const maxX = pageAnchored ? page.size.w - tableWidth : margins.left + contentWidth - tableWidth;
 	if (Number.isFinite(maxX)) x = Math.max(minX, Math.min(x, maxX));
 	const fragment = {
 		kind: "table",

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

@@ -1,4 +1,4 @@
-import { DEFAULT_TEXTBOX_MARGINS, floatingTextBoxReservesBand, tableColumnsArePinned } from "../types.js";
+import { DEFAULT_TEXTBOX_MARGINS, floatingTextBoxReservesBand, isFloatingTextBoxBlock, tableColumnsArePinned } from "../types.js";
 import { findClearLineY, measureParagraph } from "./measureParagraph.js";
 import { getCachedParagraphMeasure, setCachedParagraphMeasure } from "./cache.js";
 import { getTextBoxGroupId } from "../textBoxGroup.js";
@@ -56,6 +56,7 @@ function isInlineFlowImageRun(run) {
 	return true;
 }
 function measureTableCellBlockVisualHeight(block, blockMeasure) {
+	if (block.kind === "textBox" && isFloatingTextBoxBlock(block)) return 0;
 	if (block.kind !== "paragraph" || blockMeasure.kind !== "paragraph") {
 		if ("totalHeight" in blockMeasure) return blockMeasure.totalHeight;
 		if ("height" in blockMeasure) return blockMeasure.height;
@@ -95,7 +96,7 @@ function measureTableBlock(tableBlock, contentWidth, fieldValues) {
 		columnWidths = Array.from({ length: colCount }, () => equalWidth);
 	} else if (columnWidths.length > 0 && explicitWidthPx) {
 		const totalWidth = columnWidths.reduce((sum, w) => sum + w, 0);
-		if (totalWidth > 0 && Math.abs(totalWidth - explicitWidthPx) > 1) {
+		if (!(tableBlock.layout !== "fixed" && (tableBlock.widthType === void 0 || tableBlock.widthType === "dxa") && totalWidth - explicitWidthPx > 1) && totalWidth > 0 && Math.abs(totalWidth - explicitWidthPx) > 1) {
 			const scale = explicitWidthPx / totalWidth;
 			columnWidths = columnWidths.map((w) => w * scale);
 		}
@@ -176,6 +177,7 @@ function measureTableBlock(tableBlock, contentWidth, fieldValues) {
 			const padTop = sourceCell?.padding?.top ?? DEFAULT_CELL_PADDING_Y;
 			const padBottom = sourceCell?.padding?.bottom ?? DEFAULT_CELL_PADDING_Y;
 			cell.height += padTop + padBottom;
+			if ((sourceCell?.rowSpan ?? 1) > 1) continue;
 			const borderHeight = getTableCellVerticalBorderHeight(sourceCell, rowIdx === 0);
 			maxCellHeightWithBorders = Math.max(maxCellHeightWithBorders, cell.height + borderHeight);
 			maxBorderHeight = Math.max(maxBorderHeight, borderHeight);
@@ -186,6 +188,27 @@ function measureTableBlock(tableBlock, contentWidth, fieldValues) {
 		else if (explicitHeight) row.height = Math.max(maxCellHeightWithBorders, explicitHeight + maxBorderHeight);
 		else row.height = maxCellHeightWithBorders;
 	}
+	for (let rowIdx = 0; rowIdx < rows.length; rowIdx++) {
+		const sourceRow = tableBlock.rows[rowIdx];
+		const measuredRow = rows[rowIdx];
+		if (!sourceRow || !measuredRow) continue;
+		for (let cellIdx = 0; cellIdx < sourceRow.cells.length; cellIdx++) {
+			const sourceCell = sourceRow.cells[cellIdx];
+			const measuredCell = measuredRow.cells[cellIdx];
+			const rowSpan = sourceCell?.rowSpan ?? 1;
+			if (!sourceCell || !measuredCell || rowSpan <= 1) continue;
+			const spanEnd = Math.min(rows.length, rowIdx + rowSpan);
+			let combinedHeight = 0;
+			for (let spannedRowIdx = rowIdx; spannedRowIdx < spanEnd; spannedRowIdx++) combinedHeight += rows[spannedRowIdx]?.height ?? 0;
+			const deficit = measuredCell.height + getTableCellVerticalBorderHeight(sourceCell, rowIdx === 0) - combinedHeight;
+			if (deficit <= 0) continue;
+			for (let spannedRowIdx = spanEnd - 1; spannedRowIdx >= rowIdx; spannedRowIdx--) {
+				if (tableBlock.rows[spannedRowIdx]?.heightRule === "exact") continue;
+				rows[spannedRowIdx].height += deficit;
+				break;
+			}
+		}
+	}
 	const totalHeight = rows.reduce((h, r) => h + r.height, 0);
 	const totalWidth = columnWidths.reduce((w, cw) => w + cw, 0) || explicitWidthPx || contentWidth;
 	return {

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

@@ -55,6 +55,8 @@ declare function createPaginator(options: PaginatorOptions): {
     count: number;
     gap: number;
     equalWidth?: boolean;
+    widths?: number[];
+    gaps?: number[];
     separator?: boolean;
   }; /** Get current state. */
   getCurrentState: () => PageState; /** Get available height in current column. */

package/dist/layout-engine/paginator.js

@@ -7,12 +7,13 @@ import { panic } from "better-result";
 * Tracks the current page, cursor position, and available space.
 * Creates new pages when content doesn't fit.
 */
-/**
-* Calculate the width of a single column.
-*/
-function calculateColumnWidth(pageWidth, leftMargin, rightMargin, columns) {
-	return (pageWidth - leftMargin - rightMargin - (columns.count - 1) * columns.gap) / columns.count;
+/** Calculate active column widths, preferring authored unequal widths. */
+function calculateColumnWidths(pageWidth, leftMargin, rightMargin, columns) {
+	if (columns.widths?.length === columns.count && columns.widths.every((width) => Number.isFinite(width) && width > 0)) return [...columns.widths];
+	const equalWidth = (pageWidth - leftMargin - rightMargin - (columns.count - 1) * columns.gap) / columns.count;
+	return Array.from({ length: columns.count }, () => equalWidth);
 }
+const gapAfterColumn = (columns, columnIndex) => columns.gaps?.[columnIndex] ?? columns.gap;
 function arePageSizesEqual(left, right) {
 	return left.w === right.w && left.h === right.h;
 }
@@ -49,9 +50,9 @@ function createPaginator(options) {
 		return arePageSizesEqual(state.page.size, pageSize) && areMarginsEqual(state.page.margins, getPageMargins(state.page.number));
 	}
 	if (getContentHeight() <= 0) panic("Paginator: page size and margins yield no content area");
-	let columnWidth = calculateColumnWidth(pageSize.w, margins.left, margins.right, columns);
-	function recalculateColumnWidth() {
-		columnWidth = calculateColumnWidth(pageSize.w, margins.left, margins.right, columns);
+	let columnWidths = calculateColumnWidths(pageSize.w, margins.left, margins.right, columns);
+	function recalculateColumnWidths() {
+		columnWidths = calculateColumnWidths(pageSize.w, margins.left, margins.right, columns);
 	}
 	function applyPendingLayout() {
 		if (pendingPageSize) pageSize = pendingPageSize;
@@ -59,7 +60,7 @@ function createPaginator(options) {
 		pendingPageSize = void 0;
 		pendingMargins = void 0;
 		if (getContentHeight() <= 0) panic("Paginator: section page size and margins yield no content area");
-		recalculateColumnWidth();
+		recalculateColumnWidths();
 	}
 	function getPageMargins(pageNumber) {
 		const pageMargins = pageNumber === 1 && options.firstPageMargins ? { ...options.firstPageMargins } : { ...margins };
@@ -75,7 +76,9 @@ function createPaginator(options) {
 	* Get X position for a given column index.
 	*/
 	function getColumnX(columnIndex) {
-		return (states.at(-1)?.page.margins.left ?? getPageMargins(1).left) + columnIndex * (columnWidth + columns.gap);
+		let x = states.at(-1)?.page.margins.left ?? getPageMargins(1).left;
+		for (let index = 0; index < columnIndex; index++) x += (columnWidths[index] ?? columnWidths[0] ?? 0) + gapAfterColumn(columns, index);
+		return x;
 	}
 	/**
 	* Create a new page and add it to the list.
@@ -274,7 +277,7 @@ function createPaginator(options) {
 	*/
 	function updateColumns(newColumns) {
 		columns = newColumns;
-		columnWidth = calculateColumnWidth(pageSize.w, margins.left, margins.right, columns);
+		recalculateColumnWidths();
 		const state = getCurrentState();
 		if (columns.count > 1) state.page.columns = { ...columns };
 		else delete state.page.columns;
@@ -290,7 +293,7 @@ function createPaginator(options) {
 		if (newPageSize) pageSize = { ...newPageSize };
 		if (newMargins) margins = { ...newMargins };
 		if (getContentHeight() <= 0) panic("Paginator: section page size and margins yield no content area");
-		recalculateColumnWidth();
+		recalculateColumnWidths();
 		pendingPageSize = void 0;
 		pendingMargins = void 0;
 	}
@@ -312,7 +315,8 @@ function createPaginator(options) {
 		states,
 		/** Column width in pixels (use getColumnWidth() for current value after updates). */
 		get columnWidth() {
-			return columnWidth;
+			const columnIndex = states.at(-1)?.columnIndex ?? 0;
+			return columnWidths[columnIndex] ?? columnWidths[0] ?? getContentWidth();
 		},
 		/** Get current column layout (returns copy to prevent external mutation). */
 		get columns() {

package/dist/layout-engine/tableRowBreak.js

@@ -1,3 +1,4 @@
+import { isFloatingTextBoxBlock } from "./types.js";
 import { measureParagraph } from "./measure/measureParagraph.js";
 import { buildTableCellFloatingZones, getTableCellContentWidth, getTableCellFloatingImages } from "./measure/tableCellFloating.js";
 //#region src/layout-engine/tableRowBreak.ts
@@ -74,6 +75,8 @@ function cellBreakGeometry(cell, measure) {
 			y = blockTop + blockMeasure.totalHeight;
 			paragraphY += blockMeasure.totalHeight;
 		} else if (blockMeasure) {
+			const block = cellBlocks?.[i];
+			if (block?.kind === "textBox" && isFloatingTextBoxBlock(block)) continue;
 			const blockHeight = getAtomicBlockHeight(blockMeasure);
 			if (blockHeight > 0) {
 				const top = y;

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

@@ -846,7 +846,9 @@ type Page = {
 type ColumnLayout = {
   count: number;
   gap: number;
-  equalWidth?: boolean; /** Draw vertical separator line between columns (w:sep). */
+  equalWidth?: boolean; /** Authored widths for unequal-width section columns. */
+  widths?: number[]; /** Authored space after each column except the last. */
+  gaps?: number[]; /** Draw vertical separator line between columns (w:sep). */
   separator?: boolean;
 };
 /**
@@ -904,7 +906,8 @@ type LayoutOptions = {
     w: number;
     h: number;
   }; /** Body-level final section margins. */
-  finalMargins?: PageMargins; /** Column configuration. */
+  finalMargins?: PageMargins; /** Body-level final section column configuration. */
+  finalColumns?: ColumnLayout; /** Column configuration. */
   columns?: ColumnLayout; /** Gap between rendered pages (for UI). */
   pageGap?: number; /** Default line height multiplier. */
   defaultLineHeight?: number; /** Header content heights by variant. */

package/dist/layout-painter/index.js

@@ -1,8 +1,8 @@
 import { FRAGMENT_CLASS_NAMES, renderFragment } from "./renderFragment.js";
 import { IMAGE_CLASS_NAMES, renderImageFragment } from "./renderImage.js";
 import { renderLine, renderParagraphFragment, sliceRunsForLine } from "./renderParagraph.js";
-import { TABLE_CLASS_NAMES, renderTableFragment } from "./renderTable.js";
 import { TEXTBOX_CLASS_NAMES, renderTextBoxFragment } from "./renderTextBox.js";
+import { TABLE_CLASS_NAMES, renderTableFragment } from "./renderTable.js";
 import { renderPage, renderPages } from "./renderPage.js";
 import { prefersReducedMotionBehavior } from "../paged-layout/scrollNavigation.js";
 import { createFeatureRegistry } from "./registry/registry.js";

package/dist/layout-painter/renderPage.js

@@ -8,8 +8,8 @@ import { renderFragment } from "./renderFragment.js";
 import { applyImageVisualAttrs, hasImageVisualAttrs, renderImageFragment } from "./renderImage.js";
 import { emuToPixels } from "./renderUtils.js";
 import { renderParagraphFragment } from "./renderParagraph.js";
-import { renderTableFragment } from "./renderTable.js";
 import { renderTextBoxFragment } from "./renderTextBox.js";
+import { renderTableFragment } from "./renderTable.js";
 import { renderWatermarkLayer } from "./renderWatermark.js";
 import { panic } from "better-result";
 //#region src/layout-painter/renderPage.ts
@@ -560,7 +560,12 @@ function renderHeaderFooterContent(content, context, options, layout) {
 				...block.pmStart !== void 0 ? { pmStart: block.pmStart } : {},
 				...block.pmEnd !== void 0 ? { pmEnd: block.pmEnd } : {}
 			}, block, measure, hfContext, { document: doc });
-			fragEl.style.top = `${cursorY}px`;
+			const textBoxTop = block.position ? resolveHeaderFooterFloatTop({
+				height: measure.height,
+				paragraphY: cursorY,
+				position: block.position
+			}, layout) : cursorY;
+			fragEl.style.top = `${textBoxTop}px`;
 			fragEl.style.left = resolveHeaderFooterFloatLeft(measure.width, block.position?.horizontal, layout);
 			if (block.wrapType === "behind") fragEl.style.zIndex = "-1";
 			containerEl.append(fragEl);