@stll/folio-core 0.7.0 → 0.9.0

package/dist/ai-edits/snapshot.js

@@ -22,12 +22,28 @@ const createFolioAIEditSnapshot = (doc) => {
 	const draftBlocks = [];
 	const hashCounts = /* @__PURE__ */ new Map();
 	const usedBlockIds = /* @__PURE__ */ new Set();
+	const emptyAnchorState = {
+		candidate: null,
+		textblockCount: 0
+	};
 	let blockIndex = 0;
-	doc.descendants((node, pos) => {
+	doc.descendants((node, pos, parent) => {
 		if (!node.isTextblock) return;
 		const { text } = buildCleanBlockText(node, pos);
 		const normalizedText = normalizeFolioAIBlockText(text);
-		if (normalizedText.length === 0) return;
+		if (normalizedText.length === 0) {
+			if (parent?.type !== doc.type) return;
+			emptyAnchorState.textblockCount++;
+			if (emptyAnchorState.candidate === null) {
+				const paraIdAttr = node.attrs["paraId"];
+				emptyAnchorState.candidate = {
+					from: pos,
+					to: pos + node.nodeSize,
+					paraId: typeof paraIdAttr === "string" && paraIdAttr.length > 0 ? paraIdAttr : null
+				};
+			}
+			return;
+		}
 		const textHash = hashFolioAIBlockText(normalizedText);
 		hashCounts.set(textHash, (hashCounts.get(textHash) ?? 0) + 1);
 		blockIndex++;
@@ -38,7 +54,8 @@ const createFolioAIEditSnapshot = (doc) => {
 			taken: usedBlockIds
 		});
 		usedBlockIds.add(id);
-		const kind = getBlockKind(node);
+		const headingLevel = getHeadingLevel(node);
+		const kind = getBlockKind(node, headingLevel);
 		const displayLabel = getDisplayLabel(node);
 		const styleId = getStyleId(node);
 		const previewRuns = getPreviewRuns(node);
@@ -47,6 +64,7 @@ const createFolioAIEditSnapshot = (doc) => {
 				id,
 				kind,
 				text,
+				...headingLevel !== void 0 && { headingLevel },
 				...displayLabel !== void 0 && { displayLabel },
 				...styleId !== void 0 && { styleId },
 				...previewRuns !== void 0 && { previewRuns }
@@ -70,19 +88,47 @@ const createFolioAIEditSnapshot = (doc) => {
 			hashOccurrenceCount: hashCounts.get(draft.anchor.textHash) ?? 0
 		};
 	}
-	return {
+	const emptyAnchorCandidate = emptyAnchorState.candidate;
+	if (blocks.length > 0 || emptyAnchorCandidate === null) return {
 		blocks,
 		anchors
 	};
+	const emptyDocumentAnchorId = deriveBlockId({
+		paraId: emptyAnchorCandidate.paraId,
+		index: 1,
+		taken: usedBlockIds
+	});
+	const normalizedText = "";
+	anchors[emptyDocumentAnchorId] = {
+		id: emptyDocumentAnchorId,
+		from: emptyAnchorCandidate.from,
+		to: emptyAnchorCandidate.to,
+		text: "",
+		normalizedText,
+		textHash: hashFolioAIBlockText(normalizedText),
+		hashOccurrenceCount: emptyAnchorState.textblockCount
+	};
+	return {
+		blocks,
+		anchors,
+		emptyDocumentAnchorId
+	};
 };
-const getBlockKind = (node) => {
+const getBlockKind = (node, headingLevel) => {
 	const listMarker = node.attrs["listMarker"];
 	const numPr = node.attrs["numPr"];
 	if (typeof listMarker === "string" && listMarker.trim().length > 0 || numPr !== void 0 && numPr !== null) return "listItem";
-	const outlineLevel = node.attrs["outlineLevel"];
-	if (typeof outlineLevel === "number" && outlineLevel >= 0) return "heading";
+	if (headingLevel !== void 0) return "heading";
 	return "paragraph";
 };
+const getHeadingLevel = (node) => {
+	const outlineLevel = node.attrs["outlineLevel"];
+	if (typeof outlineLevel === "number" && Number.isInteger(outlineLevel) && outlineLevel >= 0 && outlineLevel <= 8) return outlineLevel + 1;
+	const styleId = node.attrs["styleId"];
+	if (typeof styleId !== "string") return;
+	const level = /^heading(?<level>[1-9])$/iu.exec(styleId)?.groups?.["level"];
+	return level === void 0 ? void 0 : Number.parseInt(level, 10);
+};
 const getDisplayLabel = (node) => {
 	const listMarker = node.attrs["listMarker"];
 	if (typeof listMarker === "string" && listMarker.trim().length > 0) return listMarker.trim();

package/dist/ai-edits/types.d.ts

@@ -13,14 +13,16 @@ type FolioAIBlockPreviewRun = {
 type FolioAIBlock = {
   id: string;
   kind: FolioAIBlockKind;
-  text: string;
+  text: string; /** One-based heading depth when the block has outline semantics. */
+  headingLevel?: number;
   displayLabel?: string;
   styleId?: string;
   previewRuns?: FolioAIBlockPreviewRun[];
 };
 type FolioAIEditSnapshot = {
   blocks: FolioAIBlock[];
-  anchors: Record<string, FolioAIBlockAnchor>;
+  anchors: Record<string, FolioAIBlockAnchor>; /** Hidden empty paragraph used to anchor insertions when `blocks` is empty. */
+  emptyDocumentAnchorId?: string;
 };
 type FolioAIBlockAnchor = {
   id: string;
@@ -61,6 +63,47 @@ type FolioAITextRangeHandle = {
   endOffset: number;
   selectedTextHash: string;
 };
+/**
+ * Stable handle for the logical document section introduced by one heading.
+ * The section runs until the next heading at the same or a higher level.
+ * `headingTextHash` makes a renamed heading fail stale instead of silently
+ * resolving to content whose meaning may have changed.
+ */
+type FolioDocumentSectionHandle = {
+  type: "headingSection";
+  story: "main";
+  headingBlockId: string;
+  headingTextHash: string; /** One-based depth used to detect structural section-boundary changes. */
+  headingLevel: number;
+};
+type FolioDocumentOutlineEntry = {
+  handle: FolioDocumentSectionHandle;
+  headingBlockId: string;
+  text: string; /** One-based heading depth. */
+  level: number;
+  parentHandle?: FolioDocumentSectionHandle;
+};
+type FolioDocumentOutline = {
+  sections: FolioDocumentOutlineEntry[];
+};
+type FolioDocumentSection = {
+  handle: FolioDocumentSectionHandle;
+  heading: FolioDocumentOutlineEntry; /** Heading block followed by every block in its logical section. */
+  blocks: FolioAIBlock[];
+};
+type FolioDocumentSectionReadResult = {
+  status: "found";
+  section: FolioDocumentSection;
+} | {
+  status: "missing";
+} | {
+  status: "stale";
+};
+type FolioDocumentNavigationTarget = {
+  type: "block";
+  story: "main";
+  blockId: string;
+} | FolioAITextRangeHandle;
 type FolioAIInlineFormatting = {
   bold?: boolean;
   italic?: boolean;
@@ -192,4 +235,4 @@ type FolioAIEditApplyResult = {
   skipped: FolioAIEditSkippedOperation[];
 };
 //#endregion
-export { FolioAIBlock, FolioAIBlockAnchor, FolioAIBlockKind, FolioAIBlockPreviewRun, FolioAIComment, FolioAIEditAppliedOperation, FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditOperation, FolioAIEditPrecondition, FolioAIEditReviewMeta, FolioAIEditSeverity, FolioAIEditSkipReason, FolioAIEditSkippedOperation, FolioAIEditSnapshot, FolioAIInlineFormatting, FolioAISignatureParty, FolioAITextRangeHandle };
+export { FolioAIBlock, FolioAIBlockAnchor, FolioAIBlockKind, FolioAIBlockPreviewRun, FolioAIComment, FolioAIEditAppliedOperation, FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditOperation, FolioAIEditPrecondition, FolioAIEditReviewMeta, FolioAIEditSeverity, FolioAIEditSkipReason, FolioAIEditSkippedOperation, FolioAIEditSnapshot, FolioAIInlineFormatting, FolioAISignatureParty, FolioAITextRangeHandle, FolioDocumentNavigationTarget, FolioDocumentOutline, FolioDocumentOutlineEntry, FolioDocumentSection, FolioDocumentSectionHandle, FolioDocumentSectionReadResult };

package/dist/compat/eigenpal.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, FolioDocumentOperationUndoFailureReason, FolioDocumentOperationUndoHandle, FolioDocumentOperationUndoResult, 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, FolioDocumentOperationStory, 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";
@@ -9,9 +9,12 @@ import { AIBarStatus, AIChatMode, AICitation, AICitationSource, AIGenerateInput,
 import { ApplyResult, applySuggestions } from "../ai-suggestions/apply.js";
 import { ResolvedAnchor, isSuggestionStale, resolveSuggestionAnchor } from "../ai-suggestions/conflict.js";
 import { PositionalText, buildPositionalText } from "../ai-suggestions/text-positions.js";
+import { DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DocumentPreset, DocumentStyleSet } from "../style-sets/types.js";
 import { CreateEmptyDocumentOptions, createEmptyDocument } from "../utils/createDocument.js";
+import { DocumentStyleCatalog, DocumentStyleCatalogEntry, ExtractDocumentStyleSetOptions, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, inspectDocumentStyles, inspectDocumentStylesFromDocx } from "../style-sets/extract.js";
+import { STELLA_STYLE_SET_NAME, createStellaStyleDocumentPreset, createStellaStyleSet } from "../style-sets/stellaStyle.js";
 import { createDocx } from "../docx/rezip.js";
-import { DocxCompatibility } from "../docx/compatibility.js";
+import { DocxCompatibility, DocxCompatibilityContext, DocxCompatibilityIssue, DocxCompatibilityLocation, DocxCompatibilityPart, FolioDocxCompatibilityHost, FolioDocxCompatibilityProfile, InspectDocxCompatibilityOptions, inspectDocxCompatibility } from "../docx/compatibility.js";
 import { setAISuggestionsMeta, setFocusedSuggestionMeta } from "../prosemirror/plugins/aiSuggestionDecorations.js";
 import { scrollFolioPositionIntoView } from "../paged-layout/scrollToPmPosition.js";
 import { getFolioCaretViewportRect, getFolioSelectionViewportRect } from "../paged-layout/selectionViewportRect.js";
@@ -26,5 +29,7 @@ import { fromMarkdown } from "../markdown/fromMarkdown.js";
 import { toMarkdown, toMarkdownResult } from "../markdown/index.js";
 import { EmbeddedFont, EmbeddedFontParts, extractEmbeddedFonts, getEmbeddedFontFaces } from "../fonts/embeddedFonts.js";
 import { getGoogleFontsEnabled, setGoogleFontsEnabled } from "../utils/fontResolver.js";
+import { DOCX_CONFORMANCE_CLASSES } from "../index.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 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 };
+type DocxConformanceClass = document_d_exports.DocxConformanceClass;
+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, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DOCX_CONFORMANCE_CLASSES, type DeriveBlockIdInput, type DirectiveKind, type DirectiveRange, type Document, type DocumentPreset, type DocumentStyleCatalog, type DocumentStyleCatalogEntry, type DocumentStyleSet, type DocxCompatibility, type DocxCompatibilityContext, type DocxCompatibilityIssue, type DocxCompatibilityLocation, type DocxCompatibilityPart, type DocxConformanceClass, type EmbeddedFont, type EmbeddedFontParts, type ExtractDocumentStyleSetOptions, 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 FolioDocumentOperationStory, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type FolioDocxCompatibilityHost, type FolioDocxCompatibilityProfile, type ImageMeta, type ImageRef, type InspectDocxCompatibilityOptions, InvalidFolioDocumentOperationBatchError, type MarkdownOptions, type MarkdownResult, type PositionalText, type ResolvedAnchor, STELLA_STYLE_SET_NAME, 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, createStellaStyleDocumentPreset, createStellaStyleSet, deriveBlockId, diffWordSegments, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxCompatibility, 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/compat/eigenpal.js

@@ -3,14 +3,18 @@ import { createFolioAIEditSnapshot, hashFolioAIBlockText, normalizeFolioAIBlockT
 import { diffWordSegments } from "../ai-edits/word-diff.js";
 import { applyFolioAIEditOperations } from "../ai-edits/apply.js";
 import { 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, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch } from "../document-operations.js";
+import { DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION } from "../style-sets/types.js";
 import { createEmptyDocument } from "../utils/createDocument.js";
+import { extractDocumentStyleSet, extractDocumentStyleSetFromDocx, inspectDocumentStyles, inspectDocumentStylesFromDocx } from "../style-sets/extract.js";
+import { STELLA_STYLE_SET_NAME, createStellaStyleDocumentPreset, createStellaStyleSet } from "../style-sets/stellaStyle.js";
 import { createDocx } from "../docx/rezip.js";
+import { inspectDocxCompatibility } from "../docx/compatibility.js";
 import { DEFAULT_AI_SUGGESTION_PRESETS } from "../ai-suggestions/types.js";
 import { buildPositionalText } from "../ai-suggestions/text-positions.js";
 import { isSuggestionStale, resolveSuggestionAnchor } from "../ai-suggestions/conflict.js";
 import { applySuggestions } from "../ai-suggestions/apply.js";
-import { setAISuggestionsMeta, setFocusedSuggestionMeta } from "../prosemirror/plugins/aiSuggestionDecorations.js";
 import { getGoogleFontsEnabled, setGoogleFontsEnabled } from "../utils/fontResolver.js";
+import { setAISuggestionsMeta, setFocusedSuggestionMeta } from "../prosemirror/plugins/aiSuggestionDecorations.js";
 import { scrollFolioPositionIntoView } from "../paged-layout/scrollToPmPosition.js";
 import { getFolioCaretViewportRect, getFolioSelectionViewportRect } from "../paged-layout/selectionViewportRect.js";
 import { createAICitationDecorationsPlugin, setAICitationsMeta, setActiveCitationMeta } from "../prosemirror/plugins/aiCitationDecorations.js";
@@ -22,4 +26,5 @@ import { DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, acceptAutocompleteSuggestion, acc
 import { fromMarkdown } from "../markdown/fromMarkdown.js";
 import { toMarkdown, toMarkdownResult } from "../markdown/index.js";
 import { extractEmbeddedFonts, getEmbeddedFontFaces } from "../fonts/embeddedFonts.js";
-export { DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, 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, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, 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 };
+import { DOCX_CONFORMANCE_CLASSES } from "../index.js";
+export { DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DOCX_CONFORMANCE_CLASSES, 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, InvalidFolioDocumentOperationBatchError, STELLA_STYLE_SET_NAME, UnsupportedFolioDocumentOperationVersionError, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, createStellaStyleDocumentPreset, createStellaStyleSet, deriveBlockId, diffWordSegments, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxCompatibility, 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/controller/fontReadiness.d.ts

@@ -0,0 +1,29 @@
+import { document_d_exports } from "../types/document.js";
+import { EditorState } from "prosemirror-state";
+
+//#region src/controller/fontReadiness.d.ts
+declare function getDocumentFontSet(): FontFaceSet | null;
+declare function documentFontsAreLoaded(): boolean;
+declare const LAYOUT_FONT_DESCRIPTORS: readonly [{
+  readonly style: "normal";
+  readonly weight: 400;
+}, {
+  readonly style: "italic";
+  readonly weight: 400;
+}, {
+  readonly style: "normal";
+  readonly weight: 700;
+}, {
+  readonly style: "italic";
+  readonly weight: 700;
+}];
+type LayoutFontFace = {
+  family: string;
+  style: (typeof LAYOUT_FONT_DESCRIPTORS)[number]["style"];
+  weight: (typeof LAYOUT_FONT_DESCRIPTORS)[number]["weight"];
+};
+declare function waitForInitialLayoutFonts(documentModel: document_d_exports.Document | null, pmDoc: EditorState["doc"]): Promise<boolean>;
+declare function collectInitialLayoutFontFamilies(documentModel: document_d_exports.Document | null, pmDoc: EditorState["doc"]): Set<string>;
+declare function collectInitialLayoutFontFaces(documentModel: document_d_exports.Document | null, pmDoc: EditorState["doc"]): LayoutFontFace[];
+//#endregion
+export { LayoutFontFace, collectInitialLayoutFontFaces, collectInitialLayoutFontFamilies, documentFontsAreLoaded, getDocumentFontSet, waitForInitialLayoutFonts };

package/dist/controller/fontReadiness.js

@@ -0,0 +1,139 @@
+import { expectFontFamilyMarkAttrs } from "../prosemirror/attrs/index.js";
+//#region src/controller/fontReadiness.ts
+function getDocumentFontSet() {
+	if (typeof document === "undefined" || !("fonts" in document)) return null;
+	return document.fonts;
+}
+function documentFontsAreLoaded() {
+	const fontSet = getDocumentFontSet();
+	return !fontSet || fontSet.status === "loaded";
+}
+const INITIAL_LAYOUT_FONT_TIMEOUT_MS = 2e3;
+const DEFAULT_LAYOUT_FONT_FAMILY = "Calibri";
+const OFFICE_FONT_FAMILY_MAP = {
+	Arial: "Arimo",
+	Calibri: "Carlito",
+	Cambria: "Caladea",
+	"Times New Roman": "Tinos",
+	"Courier New": "Cousine"
+};
+const CSS_GENERIC_FONT_FAMILIES = /* @__PURE__ */ new Set([
+	"serif",
+	"sans-serif",
+	"monospace",
+	"cursive",
+	"fantasy",
+	"system-ui"
+]);
+const REGULAR_LAYOUT_FONT_DESCRIPTOR = [
+	{
+		style: "normal",
+		weight: 400
+	},
+	{
+		style: "italic",
+		weight: 400
+	},
+	{
+		style: "normal",
+		weight: 700
+	},
+	{
+		style: "italic",
+		weight: 700
+	}
+][0];
+function waitForInitialLayoutFonts(documentModel, pmDoc) {
+	const fontSet = getDocumentFontSet();
+	if (!fontSet) return Promise.resolve(true);
+	const loadChecks = [];
+	for (const face of collectInitialLayoutFontFaces(documentModel, pmDoc)) loadChecks.push(`${face.style} ${face.weight} 16px "${escapeCssFontFamily(face.family)}"`);
+	const loadFonts = Promise.allSettled(loadChecks.map((check) => fontSet.load(check))).then(() => fontSet.ready).then(() => true);
+	return Promise.race([loadFonts, new Promise((resolve) => {
+		globalThis.setTimeout(() => resolve(false), INITIAL_LAYOUT_FONT_TIMEOUT_MS);
+	})]);
+}
+function collectInitialLayoutFontFamilies(documentModel, pmDoc) {
+	return new Set(collectInitialLayoutFontFaces(documentModel, pmDoc).map(({ family }) => family));
+}
+function collectInitialLayoutFontFaces(documentModel, pmDoc) {
+	const faces = /* @__PURE__ */ new Map();
+	addLayoutFontFamilyFace(faces, DEFAULT_LAYOUT_FONT_FAMILY, REGULAR_LAYOUT_FONT_DESCRIPTOR);
+	for (const family of documentModel?.requiredFonts ?? []) addLayoutFontFamilyFace(faces, family, REGULAR_LAYOUT_FONT_DESCRIPTOR);
+	addLayoutFontFamilyFace(faces, documentModel?.package.theme?.fontScheme?.majorFont?.latin, REGULAR_LAYOUT_FONT_DESCRIPTOR);
+	addLayoutFontFamilyFace(faces, documentModel?.package.theme?.fontScheme?.minorFont?.latin, REGULAR_LAYOUT_FONT_DESCRIPTOR);
+	addTextFormattingFontFaces(faces, documentModel?.package.styles?.docDefaults?.rPr);
+	for (const style of documentModel?.package.styles?.styles ?? []) addTextFormattingFontFaces(faces, style.rPr);
+	collectProseMirrorFontFaces(faces, pmDoc, void 0);
+	return Array.from(faces.values());
+}
+function addTextFormattingFontFaces(faces, formatting) {
+	addLayoutFontFamilyFace(faces, formatting?.fontFamily, layoutDescriptorFromFormatting(formatting));
+}
+function collectProseMirrorFontFaces(faces, node, inheritedTextFormatting) {
+	const paragraphDefaults = readParagraphDefaultTextFormatting(node);
+	const textFormatting = paragraphDefaults ?? inheritedTextFormatting;
+	if (paragraphDefaults) addTextFormattingFontFaces(faces, paragraphDefaults);
+	if (node.attrs["listMarkerFontFamily"]) addLayoutFontFamilyFace(faces, node.attrs["listMarkerFontFamily"], REGULAR_LAYOUT_FONT_DESCRIPTOR);
+	if (node.isText) {
+		const descriptor = layoutDescriptorFromFormattingAndMarks(textFormatting, node.marks);
+		addLayoutFontFamilyFace(faces, readFontFamilyMarkAttrs(node.marks) ?? textFormatting?.fontFamily ?? DEFAULT_LAYOUT_FONT_FAMILY, descriptor);
+	}
+	node.forEach((child) => {
+		collectProseMirrorFontFaces(faces, child, textFormatting);
+	});
+}
+function readParagraphDefaultTextFormatting(node) {
+	const value = node.attrs["defaultTextFormatting"];
+	if (!value || typeof value !== "object") return;
+	return value;
+}
+function readFontFamilyMarkAttrs(marks) {
+	for (const mark of marks) if (mark.type.name === "fontFamily") return expectFontFamilyMarkAttrs(mark);
+}
+function layoutDescriptorFromFormatting(formatting) {
+	return {
+		style: formatting?.italic ? "italic" : "normal",
+		weight: formatting?.bold ? 700 : 400
+	};
+}
+function layoutDescriptorFromFormattingAndMarks(formatting, marks) {
+	let bold = formatting?.bold === true;
+	let italic = formatting?.italic === true;
+	for (const mark of marks) {
+		if (mark.type.name === "bold") bold = true;
+		if (mark.type.name === "italic") italic = true;
+	}
+	return {
+		style: italic ? "italic" : "normal",
+		weight: bold ? 700 : 400
+	};
+}
+function addLayoutFontFamilyFace(faces, value, descriptor) {
+	if (typeof value === "string") {
+		addLayoutFontFamilyNameFace(faces, value, descriptor);
+		return;
+	}
+	if (!value || typeof value !== "object") return;
+	const fontFamily = value;
+	addLayoutFontFamilyFace(faces, fontFamily.ascii, descriptor);
+	addLayoutFontFamilyFace(faces, fontFamily.hAnsi, descriptor);
+}
+function addLayoutFontFamilyNameFace(faces, family, descriptor) {
+	const normalized = family.trim();
+	if (!normalized || CSS_GENERIC_FONT_FAMILIES.has(normalized)) return;
+	addLayoutFontFace(faces, normalized, descriptor);
+	const mappedFamily = OFFICE_FONT_FAMILY_MAP[normalized];
+	if (mappedFamily) addLayoutFontFace(faces, mappedFamily, descriptor);
+}
+function addLayoutFontFace(faces, family, descriptor) {
+	faces.set(`${family}|${descriptor.style}|${descriptor.weight}`, {
+		family,
+		...descriptor
+	});
+}
+function escapeCssFontFamily(family) {
+	return family.replace(/\\/gu, "\\\\").replace(/"/gu, "\\\"");
+}
+//#endregion
+export { collectInitialLayoutFontFaces, collectInitialLayoutFontFamilies, documentFontsAreLoaded, getDocumentFontSet, waitForInitialLayoutFonts };

package/dist/controller/latestRequestGate.d.ts

@@ -0,0 +1,13 @@
+//#region src/controller/latestRequestGate.d.ts
+/**
+ * Coordinates async work where only the most recently started request may
+ * commit a result. Each guard closes over an opaque identity, so callers
+ * cannot accidentally make an older request current again.
+ */
+type LatestRequestGate = {
+  /** Start a request and return a guard that remains true while it is latest. */begin: () => () => boolean; /** Supersede the current request without starting another one. */
+  invalidate: () => void;
+};
+declare const createLatestRequestGate: () => LatestRequestGate;
+//#endregion
+export { LatestRequestGate, createLatestRequestGate };

package/dist/controller/latestRequestGate.js

@@ -0,0 +1,16 @@
+//#region src/controller/latestRequestGate.ts
+const createLatestRequestGate = () => {
+	let current = Symbol();
+	return {
+		begin: () => {
+			const request = Symbol();
+			current = request;
+			return () => current === request;
+		},
+		invalidate: () => {
+			current = Symbol();
+		}
+	};
+};
+//#endregion
+export { createLatestRequestGate };

package/dist/controller/layoutPipeline.js

@@ -19,15 +19,42 @@ import { tryBuildIncrementalMeasures } from "../paged-layout/incrementalMeasure.
 import { computePerBlockMeasureInputs } from "../paged-layout/sectionBlockWidths.js";
 import { getDocumentWatermark } from "../watermark/index.js";
 //#region src/controller/layoutPipeline.ts
-function bodyMarginsBelowHeader(authoredMargins, preparedHeader) {
-	if (!preparedHeader) return authoredMargins;
-	const headerBottom = (authoredMargins.header ?? 0) + (preparedHeader.marginPushBottom ?? preparedHeader.height);
-	if (headerBottom <= authoredMargins.top) return authoredMargins;
+function bodyMarginsClearHeaderFooter({ authoredMargins, preparedHeader, preparedFooter }) {
+	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 bottom = Math.max(authoredMargins.bottom, footerClearance);
+	if (top === authoredMargins.top && bottom === authoredMargins.bottom) return authoredMargins;
 	return {
 		...authoredMargins,
-		top: headerBottom
+		top,
+		bottom
 	};
 }
+function bodyBlocksClearSectionHeaderFooter(blocks, { authoredMargins, sectionHeaderFooterRefs, headerContentByRId, footerContentByRId }) {
+	if (!sectionHeaderFooterRefs || !headerContentByRId && !footerContentByRId) return blocks;
+	let sectionIndex = 0;
+	let currentAuthoredMargins = authoredMargins;
+	let changed = false;
+	const nextBlocks = blocks.map((block) => {
+		if (block.kind !== "sectionBreak") return block;
+		currentAuthoredMargins = block.margins ?? currentAuthoredMargins;
+		const refs = sectionHeaderFooterRefs[sectionIndex];
+		sectionIndex += 1;
+		const effectiveMargins = bodyMarginsClearHeaderFooter({
+			authoredMargins: currentAuthoredMargins,
+			preparedHeader: refs?.headerDefault ? headerContentByRId?.get(refs.headerDefault) : void 0,
+			preparedFooter: refs?.footerDefault ? footerContentByRId?.get(refs.footerDefault) : void 0
+		});
+		if (effectiveMargins === currentAuthoredMargins && block.margins === currentAuthoredMargins) return block;
+		changed = true;
+		return {
+			...block,
+			margins: effectiveMargins
+		};
+	});
+	return changed ? nextBlocks : blocks;
+}
 function runLayoutPipeline(deps, state, options = {}) {
 	const { contentWidth, columns, pageSize, margins, pageGap, syncCoordinator, headerContent, footerContent, firstPageHeaderContent, firstPageFooterContent, headerContentRId, footerContentRId, firstPageHeaderContentRId, firstPageFooterContentRId, sectionHeaderFooterRefs, theme: _theme, sectionProperties, document, defaultTabStop, mirrorMargins, styles, layout, hfPMs, painter, pagesContainer, session, renderHfFromContentOrPm, renderHeaderFooterContentByRId, documentFontsAreLoaded, buildFootnoteRenderItems, describeInvalidHighlightMarks, emptyTemplatePreviewEntries: EMPTY_TEMPLATE_PREVIEW_ENTRIES } = deps;
 	let outcome = {};
@@ -46,6 +73,13 @@ function runLayoutPipeline(deps, state, options = {}) {
 		const flowOpts = { pageContentHeight: pageSize.h - margins.top - margins.bottom };
 		if (_theme !== void 0) flowOpts.theme = _theme;
 		if (defaultTabStop !== void 0) flowOpts.defaultTabStopTwips = defaultTabStop;
+		if (document?.package.settings?.lineBreakRules) flowOpts.lineBreakRules = document.package.settings.lineBreakRules;
+		const documentSettings = document?.package.settings;
+		if (documentSettings?.autoHyphenation === true) flowOpts.automaticHyphenation = {
+			enabled: true,
+			...documentSettings.doNotHyphenateCaps !== void 0 ? { doNotHyphenateCaps: documentSettings.doNotHyphenateCaps } : {},
+			...documentSettings.consecutiveHyphenLimit !== void 0 ? { consecutiveLineLimit: documentSettings.consecutiveHyphenLimit } : {}
+		};
 		let newBlocks = toFlowBlocks(state.doc, flowOpts);
 		const previewState = templatePreviewValuesKey.getState(state);
 		const previewEntries = previewState?.entries ?? EMPTY_TEMPLATE_PREVIEW_ENTRIES;
@@ -90,7 +124,9 @@ function runLayoutPipeline(deps, state, options = {}) {
 				...styles ? { styles } : {},
 				..._theme !== void 0 ? { theme: _theme } : {},
 				measureBlocks: hfMeasureBlocks,
-				...defaultTabStop !== void 0 ? { defaultTabStopTwips: defaultTabStop } : {}
+				...defaultTabStop !== void 0 ? { defaultTabStopTwips: defaultTabStop } : {},
+				...flowOpts.lineBreakRules ? { lineBreakRules: flowOpts.lineBreakRules } : {},
+				...flowOpts.automaticHyphenation ? { automaticHyphenation: flowOpts.automaticHyphenation } : {}
 			};
 		};
 		const hfOptions = buildHfOptions(hfPageCountEstimate);
@@ -101,7 +137,28 @@ function runLayoutPipeline(deps, state, options = {}) {
 		let firstPageFooterForRender = hasTitlePg ? renderHfFromContentOrPm(firstPageFooterContent, firstPageFooterContentRId, hfPMs, contentWidth, hfMetricsFooter, hfOptions) : void 0;
 		let headerContentByRId = renderHeaderFooterContentByRId(document?.package.headers, hfPMs, contentWidth, hfMetricsHeader, hfOptions);
 		let footerContentByRId = renderHeaderFooterContentByRId(document?.package.footers, hfPMs, contentWidth, hfMetricsFooter, hfOptions);
-		const initialBodyMargins = bodyMarginsBelowHeader(margins, headerContentForRender);
+		const sectionPropertiesForMargins = document?.package.document.sections?.map((section) => section.properties) ?? (sectionProperties ? [sectionProperties] : []);
+		const sectionEvenPageMargins = sectionHeaderFooterRefs?.map((refs, index) => {
+			if (refs.evenAndOddHeaders !== true) return;
+			const properties = sectionPropertiesForMargins[index];
+			return bodyMarginsClearHeaderFooter({
+				authoredMargins: properties ? getMargins(properties) : margins,
+				preparedHeader: refs.headerEven ? headerContentByRId?.get(refs.headerEven) : void 0,
+				preparedFooter: refs.footerEven ? footerContentByRId?.get(refs.footerEven) : void 0
+			});
+		});
+		newBlocks = bodyBlocksClearSectionHeaderFooter(newBlocks, {
+			authoredMargins: margins,
+			sectionHeaderFooterRefs,
+			headerContentByRId,
+			footerContentByRId
+		});
+		outcome.blocks = newBlocks;
+		const initialBodyMargins = bodyMarginsClearHeaderFooter({
+			authoredMargins: margins,
+			preparedHeader: headerContentForRender,
+			preparedFooter: footerContentForRender
+		});
 		recordPhaseDuration("header-footer", phaseStartedAt);
 		phaseStartedAt = performance.now();
 		const bodyLayoutConfig = {
@@ -114,9 +171,17 @@ function runLayoutPipeline(deps, state, options = {}) {
 		let finalHeaderForLayout = headerContentForRender;
 		if (finalHeaderRId) finalHeaderForLayout = headerContentByRId?.get(finalHeaderRId);
 		else if (sectionHeaderFooterRefs !== void 0) finalHeaderForLayout = void 0;
+		const finalFooterRId = sectionHeaderFooterRefs?.at(-1)?.footerDefault;
+		let finalFooterForLayout = footerContentForRender;
+		if (finalFooterRId) finalFooterForLayout = footerContentByRId?.get(finalFooterRId);
+		else if (sectionHeaderFooterRefs !== void 0) finalFooterForLayout = void 0;
 		const finalLayoutConfig = finalSectionProperties ? {
 			pageSize: getPageSize(finalSectionProperties),
-			margins: bodyMarginsBelowHeader(getMargins(finalSectionProperties), finalHeaderForLayout)
+			margins: bodyMarginsClearHeaderFooter({
+				authoredMargins: getMargins(finalSectionProperties),
+				preparedHeader: finalHeaderForLayout,
+				preparedFooter: finalFooterForLayout
+			})
 		} : bodyLayoutConfig;
 		const finalColumns = getColumns(finalSectionProperties);
 		if (finalColumns !== void 0) finalLayoutConfig.columns = finalColumns;
@@ -137,7 +202,10 @@ function runLayoutPipeline(deps, state, options = {}) {
 			measureBlock: measureSingleBlockWithoutFloatingZones
 		}) : null;
 		let newMeasures = incrementalResult?.measures ?? measureBlocks(newBlocks, blockWidths, blockMeasureInputs.marginTops, {
+			pageWidth: blockMeasureInputs.pageWidths,
 			pageHeight: blockMeasureInputs.pageHeights,
+			marginLeft: blockMeasureInputs.marginLefts,
+			marginRight: blockMeasureInputs.marginRights,
 			marginBottom: blockMeasureInputs.marginBottoms
 		});
 		pendingArtifacts = {
@@ -151,7 +219,7 @@ function runLayoutPipeline(deps, state, options = {}) {
 		let newLayout;
 		let pageFootnoteMap = /* @__PURE__ */ new Map();
 		let footnoteContentMap = /* @__PURE__ */ new Map();
-		const bodyBreakType = sectionProperties?.sectionStart;
+		const bodyBreakType = finalSectionProperties?.sectionStart;
 		const buildLayoutOpts = () => {
 			const nextLayoutOpts = {
 				pageSize,
@@ -159,7 +227,11 @@ function runLayoutPipeline(deps, state, options = {}) {
 				pageGap,
 				mirrorMargins
 			};
-			if (hasTitlePg) nextLayoutOpts.firstPageMargins = bodyMarginsBelowHeader(margins, firstPageHeaderForRender);
+			if (hasTitlePg) nextLayoutOpts.firstPageMargins = bodyMarginsClearHeaderFooter({
+				authoredMargins: margins,
+				preparedHeader: firstPageHeaderForRender,
+				preparedFooter: firstPageFooterForRender
+			});
 			if (finalSectionProperties) {
 				nextLayoutOpts.finalPageSize = finalLayoutConfig.pageSize;
 				nextLayoutOpts.finalMargins = finalLayoutConfig.margins;
@@ -171,6 +243,7 @@ function runLayoutPipeline(deps, state, options = {}) {
 			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;
 		};
 		const layoutOpts = buildLayoutOpts();
@@ -181,6 +254,8 @@ function runLayoutPipeline(deps, state, options = {}) {
 				if (styles) footnoteOptions.styles = styles;
 				if (_theme !== void 0) footnoteOptions.theme = _theme;
 				if (defaultTabStop !== void 0) footnoteOptions.defaultTabStopTwips = defaultTabStop;
+				if (flowOpts.lineBreakRules) footnoteOptions.lineBreakRules = flowOpts.lineBreakRules;
+				if (flowOpts.automaticHyphenation) footnoteOptions.automaticHyphenation = flowOpts.automaticHyphenation;
 				return footnoteOptions;
 			})());
 			const footnoteHeightById = /* @__PURE__ */ new Map();
@@ -237,7 +312,10 @@ function runLayoutPipeline(deps, state, options = {}) {
 				previousFieldValues = values;
 				stabilizedFieldValues = values;
 				newMeasures = measureBlocks(newBlocks, blockWidths, blockMeasureInputs.marginTops, {
+					pageWidth: blockMeasureInputs.pageWidths,
 					pageHeight: blockMeasureInputs.pageHeights,
+					marginLeft: blockMeasureInputs.marginLefts,
+					marginRight: blockMeasureInputs.marginRights,
 					marginBottom: blockMeasureInputs.marginBottoms
 				}, values);
 				relayoutWithCurrentMeasures(layoutOptsUsed);