@stll/folio-core 0.32.2 → 0.33.0

package/dist/headless-layout.js

@@ -0,0 +1,350 @@
+import { parseDocx } from "./docx/parser.js";
+import { buildHeaderFooterFieldValues } from "./fields/resolveFieldValues.js";
+import { extractEmbeddedFonts } from "./fonts/embeddedFonts.js";
+import { buildFontAlternates } from "./fonts/fontAlternates.js";
+import { buildFootnoteContentMap, collectEndnoteRefs, collectFootnoteRefs, computeNoteDisplayNumbers, remapNoteMarkerText } from "./layout-bridge/convert/footnoteLayout.js";
+import { convertHeaderFooterToContent } from "./layout-bridge/convert/headerFooterLayout.js";
+import { toFlowBlocks } from "./layout-bridge/convert/toFlowBlocks.js";
+import { resolveSectionHeaderFooterRefs } from "./layout-engine/headerFooterRefs.js";
+import { layoutDocument } from "./layout-engine/index.js";
+import { measureBlocks } from "./layout-engine/measure/measureBlocks.js";
+import { getMeasureProvider } from "./layout-engine/measure/measureProvider.js";
+import "./layout-engine/types.js";
+import { getMargins, getPageNumbering, getPageSize } from "./paged-layout/sectionGeometry.js";
+import { toProseDoc } from "./prosemirror/conversion/toProseDoc.js";
+import { needsShaping } from "./shaping/placeRun.js";
+import { getShaper } from "./shaping/shaper.js";
+import { toArrayBuffer } from "./utils/docxInput.js";
+import { getDocumentWatermark } from "./watermark/index.js";
+import { Result, TaggedError } from "better-result";
+import { createHash } from "node:crypto";
+//#region src/headless-layout.ts
+/**
+* Lay a `.docx` package out to pages without a browser.
+*
+* The editor reaches `Layout` through `controller/layoutPipeline.ts`, which
+* needs an `EditorState`, a painter and a live DOM. Export, agents and CI need
+* the same pages with none of that, so this module walks the four pure stages
+* directly: parse, project to ProseMirror, flatten to flow blocks, measure and
+* paginate.
+*
+* ## The other stories
+*
+* Headers, footers and footnotes are separate OOXML stories that the editor
+* lays out as their own ProseMirror views, but neither conversion needs a view:
+* `convertHeaderFooterToContent` and `buildFootnoteContentMap` run the same
+* `toFlowBlocks → measureBlocks` chain the body runs. This entry therefore lays
+* them out too and returns them as {@link HeadlessLayoutResult.furniture}, so
+* an export paints the pages the editor paints rather than bare bodies.
+* Endnotes remain unpaginated and say so through
+* {@link HeadlessLayoutResult.unsupported}.
+*
+* What this entry still does not do is push the body down for a header taller
+* than its margin: the editor's margin clearing lives in the controller, and a
+* document whose header overflows its margin will overlap the body here.
+*
+* ## Measurement
+*
+* Layout is only as good as the installed `MeasureProvider`. The caller
+* installs one (`installHeadlessMeasureProvider` for a server, the canvas
+* backend in a browser); this module refuses to guess, because a silently
+* wrong provider produces a plausible layout that is wrong everywhere.
+*/
+var HeadlessLayoutError = class extends TaggedError("HeadlessLayoutError") {};
+/**
+* Stories this entry still does not lay out, keyed by story so the map is total
+* over the union. `satisfies Record<…>` is what makes it total in both
+* directions: a story left unpaginated but unlisted is a compile error rather
+* than content that vanishes without a report, and a story that starts being
+* laid out cannot keep a stale entry, because removing it narrows the union.
+*
+* Endnotes are the only one left. They are collected at the end of the
+* document rather than reserved per page, so nothing in `Layout` and nothing in
+* the painter's render options places them yet; laying them out is a
+* pagination feature, not a conversion this entry could call.
+*/
+const UNPAGINATED_STORIES = { endnote: {
+	story: "endnote",
+	detail: "Endnotes are their own story and are not paginated with the body."
+} };
+const hasStory = (document, story) => {
+	switch (story) {
+		case "endnote": return (document.package.endnotes?.length ?? 0) > 0;
+		default: return false;
+	}
+};
+const readPaintFeatures = (document) => ({
+	pageBorders: (document.package.document.sections ?? []).some((section) => Object.values(section.properties.pageBorders ?? {}).some((border) => border !== void 0)),
+	watermark: getDocumentWatermark(document) !== void 0
+});
+const buildFlowOptions = (document, pageContentHeight) => {
+	const settings = document.package.settings;
+	const options = {
+		pageContentHeight,
+		fontAlternates: buildFontAlternates(document.package.fontTable)
+	};
+	const theme = document.package.theme;
+	if (theme) options.theme = theme;
+	if (settings?.defaultTabStop !== void 0) options.defaultTabStopTwips = settings.defaultTabStop;
+	if (settings?.lineBreakRules) options.lineBreakRules = settings.lineBreakRules;
+	if (settings?.autoHyphenation === true) options.automaticHyphenation = {
+		enabled: true,
+		...settings.doNotHyphenateCaps === void 0 ? {} : { doNotHyphenateCaps: settings.doNotHyphenateCaps },
+		...settings.consecutiveHyphenLimit === void 0 ? {} : { consecutiveLineLimit: settings.consecutiveHyphenLimit },
+		...settings.hyphenationZoneTwips === void 0 ? {} : { hyphenationZoneTwips: settings.hyphenationZoneTwips }
+	};
+	return options;
+};
+/**
+* `w:mirrorMargins` is parsed into `FolioDocumentSettings` but the shared
+* `Document` model types `settings` as the narrower `DocumentSettings`, so the
+* flag is present at runtime and invisible to the type. The React paged editor
+* narrows the same way; both should stop once the model carries the field.
+*/
+const readsMirrorMargins = (settings) => settings !== void 0 && "mirrorMargins" in settings && settings.mirrorMargins === true;
+const buildBlockLookup = (blocks, measures) => new Map(blocks.flatMap((block, index) => {
+	const measure = measures.at(index);
+	return measure === void 0 ? [] : [[String(block.id), {
+		block,
+		measure
+	}]];
+}));
+const buildStoryOptions = (document, flowOptions) => ({
+	...document.package.styles ? { styles: document.package.styles } : {},
+	...flowOptions.theme === void 0 ? {} : { theme: flowOptions.theme },
+	...flowOptions.fontAlternates === void 0 ? {} : { fontAlternates: flowOptions.fontAlternates },
+	...flowOptions.defaultTabStopTwips === void 0 ? {} : { defaultTabStopTwips: flowOptions.defaultTabStopTwips },
+	...flowOptions.lineBreakRules === void 0 ? {} : { lineBreakRules: flowOptions.lineBreakRules },
+	...flowOptions.automaticHyphenation === void 0 ? {} : { automaticHyphenation: flowOptions.automaticHyphenation }
+});
+const convertStories = ({ parts, contentWidth, metrics, storyOptions, pageCount, now }) => {
+	const contentByRId = /* @__PURE__ */ new Map();
+	for (const [rId, part] of parts ?? []) {
+		const content = convertHeaderFooterToContent(part, contentWidth, metrics, {
+			...storyOptions,
+			measureBlocks: (blocks, width) => measureBlocks(blocks, width, void 0, void 0, buildHeaderFooterFieldValues(blocks, pageCount, now)),
+			rId
+		});
+		if (content) contentByRId.set(rId, content);
+	}
+	return contentByRId;
+};
+/**
+* Watermarks by the header part that carries them. Word puts the shape in a
+* header, so a document with `w:titlePg` or even/odd headers can carry a
+* different watermark per page; the per-rId map is what lets the builder pick
+* the right one instead of painting one header's watermark behind every page.
+*/
+const collectWatermarks = (headers) => {
+	const byRId = /* @__PURE__ */ new Map();
+	for (const [rId, header] of headers ?? []) if (header.watermark) byRId.set(rId, header.watermark);
+	return byRId;
+};
+/**
+* A picture watermark's bytes, as a `data:` URL.
+*
+* Resolved through `imageTarget`, the package path the relationship pointed at
+* when the watermark was parsed: relationship ids are scoped per header part
+* and repeat across parts, so the path is the only unambiguous handle. A linked
+* (external) image resolves to nothing, and the builder reports it.
+*/
+const resolveWatermarkImageSrc = (document, watermark) => {
+	if (watermark?.kind !== "picture" || watermark.imageTargetExternal === true) return;
+	const target = watermark.imageTarget;
+	return target === void 0 ? void 0 : document.package.media?.get(target)?.dataUrl;
+};
+/**
+* The scope every extracted face's family carries here.
+*
+* `getEmbeddedFontFaces` defaults it to a fresh random id, which would make two
+* layouts of one package differ in a field the caller compares. Deriving it
+* from the package's own bytes keeps two layouts of one package identical
+* while keeping two *different* packages apart: a DOM backend registers each
+* face under this name, so a fixed scope would let two documents on one page
+* define competing faces under one name and leave which one wins to font
+* matching.
+*/
+const embeddedFontNonce = (source) => createHash("sha256").update(new Uint8Array(source)).digest("hex").slice(0, NONCE_LENGTH);
+/** Enough of the digest to separate packages without bloating every family. */
+const NONCE_LENGTH = 12;
+/** Whether `fontTable.xml` declares any embedded face at all. */
+const declaresEmbeddedFonts = (document) => (document.package.fontTable?.fonts ?? []).some((font) => font.embedRegular !== void 0 || font.embedBold !== void 0 || font.embedItalic !== void 0 || font.embedBoldItalic !== void 0);
+/**
+* Parse and paginate a package. Fails rather than defaulting when no
+* measurement backend is installed: a layout measured by the wrong provider
+* is wrong in a way no downstream check catches.
+*/
+/**
+* Whether any text in the package needs shaping.
+*
+* Every story a page paints, body, headers, footers and notes alike, is built
+* from the same content model, so one walk over the package answers for all of
+* them. The answer decides whether the shaper is fetched at all: a document in
+* Latin, Cyrillic or Greek must not pay for an artifact it has no use for.
+*/
+const packageNeedsShaping = (value) => {
+	if (Array.isArray(value)) return value.some(packageNeedsShaping);
+	if (typeof value !== "object" || value === null) return false;
+	const entries = Object.entries(value);
+	const text = entries.find(([key]) => key === "text")?.[1];
+	if (entries.find(([key]) => key === "type")?.[1] === "text" && typeof text === "string" && needsShaping(text)) return true;
+	return entries.some(([, child]) => packageNeedsShaping(child));
+};
+const layoutDocxHeadless = async (input, options = {}) => {
+	const providerCheck = Result.try(() => getMeasureProvider().getFontMetrics({ fontSize: 11 }));
+	if (providerCheck.isErr()) return Result.err(new HeadlessLayoutError({
+		message: "No MeasureProvider is installed. Install one (installHeadlessMeasureProvider on a server, installCanvasMeasureProvider in a browser) before laying out.",
+		cause: providerCheck.error
+	}));
+	const parsed = await Result.tryPromise({
+		try: () => parseDocx(input, { preloadFonts: false }),
+		catch: (cause) => new HeadlessLayoutError({
+			message: "The package could not be parsed.",
+			cause
+		})
+	});
+	if (parsed.isErr()) return Result.err(parsed.error);
+	const document = parsed.value;
+	const projected = Result.try(() => toProseDoc(document, {
+		...document.package.styles ? { styles: document.package.styles } : {},
+		...document.package.theme ? { theme: document.package.theme } : {}
+	}));
+	if (projected.isErr()) return Result.err(new HeadlessLayoutError({
+		message: "The document could not be projected to the editable model.",
+		cause: projected.error
+	}));
+	if (packageNeedsShaping(document.package)) {
+		const loaded = await Result.tryPromise({
+			try: () => getShaper(),
+			catch: (cause) => new HeadlessLayoutError({
+				message: "The text shaper could not be loaded, and this document needs one.",
+				cause
+			})
+		});
+		if (loaded.isErr()) return Result.err(loaded.error);
+	}
+	const sections = document.package.document.sections ?? [];
+	const firstSection = sections.at(0)?.properties;
+	const finalSection = sections.at(-1)?.properties ?? firstSection;
+	const pageSize = getPageSize(firstSection);
+	const margins = getMargins(firstSection);
+	const contentWidth = pageSize.w - margins.left - margins.right;
+	const pageContentHeight = pageSize.h - margins.top - margins.bottom;
+	const flowOptions = buildFlowOptions(document, pageContentHeight);
+	const storyOptions = buildStoryOptions(document, flowOptions);
+	const laidOut = Result.try(() => {
+		const authored = toFlowBlocks(projected.value, flowOptions);
+		const footnotes = document.package.footnotes ?? [];
+		const endnotes = document.package.endnotes ?? [];
+		const footnoteRefs = collectFootnoteRefs(authored);
+		const blocks = remapNoteMarkerText(authored, {
+			footnoteNumbers: computeNoteDisplayNumbers(footnotes, footnoteRefs.map((ref) => ref.footnoteId)),
+			endnoteNumbers: computeNoteDisplayNumbers(endnotes, collectEndnoteRefs(authored).map((ref) => ref.endnoteId))
+		});
+		const measures = measureBlocks(blocks, contentWidth);
+		const footnoteContentById = footnoteRefs.length === 0 ? void 0 : buildFootnoteContentMap(footnotes, footnoteRefs, contentWidth, {
+			...storyOptions,
+			measureBlocks
+		});
+		const footnoteHeightById = /* @__PURE__ */ new Map();
+		for (const [id, content] of footnoteContentById ?? []) footnoteHeightById.set(id, content.height + 0);
+		const sectionHeaderFooterRefs = resolveSectionHeaderFooterRefs(document);
+		const finalPageSize = getPageSize(finalSection);
+		const finalMargins = getMargins(finalSection);
+		return {
+			layout: layoutDocument(blocks, measures, {
+				pageSize,
+				margins,
+				pageNumbering: getPageNumbering(firstSection),
+				finalPageSize,
+				finalMargins,
+				finalPageNumbering: getPageNumbering(finalSection),
+				pageGap: options.pageGap ?? 0,
+				titlePage: firstSection?.titlePg === true,
+				evenAndOddHeaders: document.package.settings?.evenAndOddHeaders === true,
+				mirrorMargins: readsMirrorMargins(document.package.settings),
+				...footnoteHeightById.size === 0 ? {} : { footnoteHeightById },
+				...sectionHeaderFooterRefs === void 0 ? {} : { sectionHeaderFooterRefs }
+			}),
+			blockLookup: buildBlockLookup(blocks, measures),
+			footnoteContentById
+		};
+	});
+	if (laidOut.isErr()) return Result.err(new HeadlessLayoutError({
+		message: "The document could not be paginated.",
+		cause: laidOut.error
+	}));
+	const { layout, blockLookup, footnoteContentById } = laidOut.value;
+	const stories = Result.try(() => {
+		const pageCount = layout.pages.length;
+		const now = options.now ?? /* @__PURE__ */ new Date();
+		const shared = {
+			contentWidth,
+			storyOptions,
+			pageCount,
+			now
+		};
+		return {
+			headerContentByRId: convertStories({
+				...shared,
+				parts: document.package.headers,
+				metrics: {
+					section: "header",
+					pageSize,
+					margins
+				}
+			}),
+			footerContentByRId: convertStories({
+				...shared,
+				parts: document.package.footers,
+				metrics: {
+					section: "footer",
+					pageSize,
+					margins
+				}
+			})
+		};
+	});
+	if (stories.isErr()) return Result.err(new HeadlessLayoutError({
+		message: "The header and footer stories could not be laid out.",
+		cause: stories.error
+	}));
+	const embeddedFonts = declaresEmbeddedFonts(document) ? await Result.tryPromise({
+		try: async () => {
+			const source = await toArrayBuffer(input);
+			return extractEmbeddedFonts(source, embeddedFontNonce(source));
+		},
+		catch: (cause) => new HeadlessLayoutError({
+			message: "The package's embedded fonts could not be extracted.",
+			cause
+		})
+	}) : Result.ok([]);
+	if (embeddedFonts.isErr()) return Result.err(embeddedFonts.error);
+	const watermark = getDocumentWatermark(document);
+	const watermarksByHeader = collectWatermarks(document.package.headers);
+	const pictureSources = new Set([watermark, ...watermarksByHeader.values()].filter((candidate) => candidate !== void 0).map((candidate) => resolveWatermarkImageSrc(document, candidate)));
+	const watermarkImageSrc = pictureSources.size === 1 ? [...pictureSources].at(0) : void 0;
+	const pageBorders = firstSection?.pageBorders;
+	return Result.ok({
+		layout,
+		blockLookup,
+		document,
+		proseDoc: projected.value,
+		documentFeatures: readPaintFeatures(document),
+		furniture: {
+			...pageBorders === void 0 ? {} : { pageBorders },
+			...document.package.theme === void 0 ? {} : { theme: document.package.theme },
+			...watermark === void 0 ? {} : { watermark },
+			watermarkByHeaderRId: watermarksByHeader,
+			...watermarkImageSrc === void 0 ? {} : { watermarkImageSrc },
+			headerContentByRId: stories.value.headerContentByRId,
+			footerContentByRId: stories.value.footerContentByRId,
+			titlePg: firstSection?.titlePg === true,
+			...footnoteContentById === void 0 ? {} : { footnoteContentById }
+		},
+		embeddedFonts: embeddedFonts.value,
+		unsupported: Object.values(UNPAGINATED_STORIES).filter((gap) => hasStory(document, gap.story))
+	});
+};
+//#endregion
+export { HeadlessLayoutError, layoutDocxHeadless };

package/dist/index.d.ts

@@ -1,15 +1,18 @@
-import { FolioAIBlock, FolioAIBlockAnchor, FolioAIBlockKind, FolioAIBlockPreviewRun, FolioAIComment, FolioAIEditAppliedOperation, FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditNormalization, FolioAIEditNormalizationCode, FolioAIEditOperation, FolioAIEditPrecondition, FolioAIEditReviewMeta, FolioAIEditSeverity, FolioAIEditSkipReason, FolioAIEditSkippedOperation, FolioAIEditSnapshot, FolioAISignatureParty } from "./ai-edits/types.js";
-import { applyFolioAIEditOperations } from "./ai-edits/apply.js";
+import { FolioAIBlock, FolioAIBlockAnchor, FolioAIBlockKind, FolioAIBlockPreviewRun, FolioAIBlockTableLocation, FolioAIComment, FolioAIEditAppliedOperation, FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditNormalization, FolioAIEditNormalizationCode, FolioAIEditOperation, FolioAIEditPrecondition, FolioAIEditReviewMeta, FolioAIEditSeverity, FolioAIEditSkipReason, FolioAIEditSkippedOperation, FolioAIEditSnapshot, FolioAISignatureParty } from "./ai-edits/types.js";
+import { WORD_DIFF_GRANULARITIES, WordDiffGranularity, WordDiffNormalization, WordDiffOptions, WordDiffSegment, diffWordSegments } from "./ai-edits/word-diff.js";
+import { FolioAIEditApplyOutcome, FolioRevisionStamp, FolioWordDiffOptions, 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, 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 { 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, FolioDocumentOperationResultBase, FolioDocumentOperationStatus, FolioDocumentOperationStory, FolioDocumentOperationType, FolioDocumentOperationUndoFailureReason, FolioDocumentOperationUndoHandle, FolioDocumentOperationUndoResult, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch } from "./document-operations.js";
+import { createFolioAIEditSnapshot, hashFolioAIBlockText, isFolioAIContentBlock, 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";
 import "./ai-edits/index.js";
 import { AIBarStatus, AIChatMode, AICitation, AICitationSource, AIGenerateInput, AISuggestion, AISuggestionApplyMode, AISuggestionPreset, AISuggestionSeverity, AISuggestionStatus, DEFAULT_AI_SUGGESTION_PRESETS } from "./ai-suggestions/types.js";
 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 { COMPARE_VERIFICATION_CAUSES, COMPARE_VERIFICATION_INVARIANTS, CompareVerification, CompareVerificationCause, CompareVerificationFailure, CompareVerificationInvariant } from "./compare/verification.js";
+import { COMPARE_UNSUPPORTED_REASONS, CompareChange, CompareChangeLocation, CompareDocxApplyError, CompareDocxError, CompareDocxOperationLimitError, CompareDocxOptions, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, CompareFormatRange, CompareResult, CompareUnsupportedPart, CompareUnsupportedReason, InvalidCompareDocxOptionsError } from "./compare/types.js";
+import { MAX_COMPARE_OPERATIONS, compareDocx } from "./compare/compare.js";
 import { DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DocumentPreset, DocumentStyleSet } from "./style-sets/types.js";
 import { CreateEmptyDocumentOptions, createEmptyDocument } from "./utils/createDocument.js";
 import { mergeDocumentContent } from "./utils/mergeDocumentContent.js";
@@ -35,4 +38,4 @@ import { getGoogleFontsEnabled, setEmbeddedFontFamilyMap, setGoogleFontsEnabled
 import { DOCX_CONFORMANCE_CLASSES } from "@stll/docx-core/model";
 type Document = document_d_exports.Document;
 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 BlockRect, 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 FolioAIEditNormalization, type FolioAIEditNormalizationCode, 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, buildEmbeddedFontFamilyMap, 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, mergeDocumentContent, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scopeEmbeddedFontFamily, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setEmbeddedFontFamilyMap, 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 BlockRect, COMPARE_UNSUPPORTED_REASONS, COMPARE_VERIFICATION_CAUSES, COMPARE_VERIFICATION_INVARIANTS, type CompareChange, type CompareChangeLocation, CompareDocxApplyError, type CompareDocxError, CompareDocxOperationLimitError, type CompareDocxOptions, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, type CompareFormatRange, type CompareResult, type CompareUnsupportedPart, type CompareUnsupportedReason, type CompareVerification, type CompareVerificationCause, type CompareVerificationFailure, type CompareVerificationInvariant, 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 FolioAIBlockTableLocation, type FolioAIComment, type FolioAIEditAppliedOperation, type FolioAIEditApplyMode, type FolioAIEditApplyOutcome, type FolioAIEditApplyResult, type FolioAIEditNormalization, type FolioAIEditNormalizationCode, 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 FolioDocumentOperationResultBase, type FolioDocumentOperationStatus, type FolioDocumentOperationStory, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type FolioDocxCompatibilityHost, type FolioDocxCompatibilityProfile, type FolioRevisionStamp, type FolioWordDiffOptions, type ImageMeta, type ImageRef, type InspectDocxCompatibilityOptions, InvalidCompareDocxOptionsError, InvalidFolioDocumentOperationBatchError, MAX_COMPARE_OPERATIONS, type MarkdownOptions, type MarkdownResult, type PositionalText, type ResolvedAnchor, STELLA_STYLE_SET_NAME, type TemplatePreviewSpan, type TemplatePreviewValue, type TemplatePreviewValues, type TemplateSlashMenuKeyAction, type TemplateSlashMenuState, UnsupportedFolioDocumentOperationVersionError, WORD_DIFF_GRANULARITIES, type WordDiffGranularity, type WordDiffNormalization, type WordDiffOptions, type WordDiffSegment, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildEmbeddedFontFamilyMap, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, compareDocx, 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, isFolioAIContentBlock, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, mergeDocumentContent, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scopeEmbeddedFontFamily, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setEmbeddedFontFamilyMap, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };

package/dist/index.js

@@ -1,10 +1,13 @@
 import { applyFolioAIEditOperations } from "./ai-edits/apply.js";
-import { createFolioAIEditSnapshot, hashFolioAIBlockText, normalizeFolioAIBlockText } from "./ai-edits/snapshot.js";
-import { diffWordSegments } from "./ai-edits/word-diff.js";
+import { createFolioAIEditSnapshot, hashFolioAIBlockText, isFolioAIContentBlock, normalizeFolioAIBlockText } from "./ai-edits/snapshot.js";
+import { WORD_DIFF_GRANULARITIES, diffWordSegments } from "./ai-edits/word-diff.js";
 import { applySuggestions } from "./ai-suggestions/apply.js";
 import { isSuggestionStale, resolveSuggestionAnchor } from "./ai-suggestions/conflict.js";
 import { buildPositionalText } from "./ai-suggestions/text-positions.js";
 import { DEFAULT_AI_SUGGESTION_PRESETS } from "./ai-suggestions/types.js";
+import { MAX_COMPARE_OPERATIONS, compareDocx } from "./compare/compare.js";
+import { COMPARE_UNSUPPORTED_REASONS, CompareDocxApplyError, CompareDocxOperationLimitError, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, InvalidCompareDocxOptionsError } from "./compare/types.js";
+import { COMPARE_VERIFICATION_CAUSES, COMPARE_VERIFICATION_INVARIANTS } from "./compare/verification.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 { inspectDocxCompatibility } from "./docx/compatibility.js";
 import { createDocx } from "./docx/rezip.js";
@@ -28,4 +31,4 @@ import { createEmptyDocument } from "./utils/createDocument.js";
 import { getGoogleFontsEnabled, setEmbeddedFontFamilyMap, setGoogleFontsEnabled } from "./utils/fontResolver.js";
 import { mergeDocumentContent } from "./utils/mergeDocumentContent.js";
 import { DOCX_CONFORMANCE_CLASSES } from "@stll/docx-core/model";
-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, buildEmbeddedFontFamilyMap, 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, mergeDocumentContent, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scopeEmbeddedFontFamily, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setEmbeddedFontFamilyMap, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };
+export { COMPARE_UNSUPPORTED_REASONS, COMPARE_VERIFICATION_CAUSES, COMPARE_VERIFICATION_INVARIANTS, CompareDocxApplyError, CompareDocxOperationLimitError, CompareDocxParseError, CompareDocxRoundTripError, CompareDocxSerializeError, 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, InvalidCompareDocxOptionsError, InvalidFolioDocumentOperationBatchError, MAX_COMPARE_OPERATIONS, STELLA_STYLE_SET_NAME, UnsupportedFolioDocumentOperationVersionError, WORD_DIFF_GRANULARITIES, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildEmbeddedFontFamilyMap, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, compareDocx, 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, isFolioAIContentBlock, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, mergeDocumentContent, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scopeEmbeddedFontFamily, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setEmbeddedFontFamilyMap, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };

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

@@ -12,6 +12,7 @@ type ConvertFootnoteOptions = {
   defaultTabStopTwips?: number;
   lineBreakRules?: ToFlowBlocksOptions["lineBreakRules"];
   justificationCompatibility?: ToFlowBlocksOptions["justificationCompatibility"];
+  tableIndentCompatibility?: ToFlowBlocksOptions["tableIndentCompatibility"];
   automaticHyphenation?: ToFlowBlocksOptions["automaticHyphenation"];
 };
 /**

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

@@ -200,6 +200,7 @@ function convertFootnoteToContent(footnote, displayNumber, contentWidth, options
 	if (options.defaultTabStopTwips !== void 0) flowOptions.defaultTabStopTwips = options.defaultTabStopTwips;
 	if (options.lineBreakRules) flowOptions.lineBreakRules = options.lineBreakRules;
 	if (options.justificationCompatibility) flowOptions.justificationCompatibility = options.justificationCompatibility;
+	if (options.tableIndentCompatibility) flowOptions.tableIndentCompatibility = options.tableIndentCompatibility;
 	if (options.automaticHyphenation) flowOptions.automaticHyphenation = options.automaticHyphenation;
 	const blocks = applyFootnotePresentation(toFlowBlocks(pmDoc, flowOptions), displayNumber);
 	const measures = options.measureBlocks ? options.measureBlocks(blocks, contentWidth) : measureFootnoteBlocks(blocks, contentWidth);

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

@@ -47,6 +47,7 @@ type ConvertHeaderFooterOptions = {
   defaultTabStopTwips?: number;
   lineBreakRules?: ToFlowBlocksOptions["lineBreakRules"];
   justificationCompatibility?: ToFlowBlocksOptions["justificationCompatibility"];
+  tableIndentCompatibility?: ToFlowBlocksOptions["tableIndentCompatibility"];
   automaticHyphenation?: ToFlowBlocksOptions["automaticHyphenation"];
   /**
    * Relationship id of the source HF part. Stamped onto the returned

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

@@ -337,6 +337,7 @@ function convertHeaderFooterToContent(headerFooter, contentWidth, metrics, optio
 	if (options.defaultTabStopTwips !== void 0) flowOptions.defaultTabStopTwips = options.defaultTabStopTwips;
 	if (options.lineBreakRules) flowOptions.lineBreakRules = options.lineBreakRules;
 	if (options.justificationCompatibility) flowOptions.justificationCompatibility = options.justificationCompatibility;
+	if (options.tableIndentCompatibility) flowOptions.tableIndentCompatibility = options.tableIndentCompatibility;
 	if (options.automaticHyphenation) flowOptions.automaticHyphenation = options.automaticHyphenation;
 	return finalizeHeaderFooterContent(toFlowBlocks(pmDoc, flowOptions), contentWidth, metrics, options);
 }
@@ -359,6 +360,7 @@ function convertHeaderFooterPmDocToContent(pmDoc, contentWidth, metrics, options
 	if (options.defaultTabStopTwips !== void 0) flowOptions.defaultTabStopTwips = options.defaultTabStopTwips;
 	if (options.lineBreakRules) flowOptions.lineBreakRules = options.lineBreakRules;
 	if (options.justificationCompatibility) flowOptions.justificationCompatibility = options.justificationCompatibility;
+	if (options.tableIndentCompatibility) flowOptions.tableIndentCompatibility = options.tableIndentCompatibility;
 	if (options.automaticHyphenation) flowOptions.automaticHyphenation = options.automaticHyphenation;
 	return finalizeHeaderFooterContent(toFlowBlocks(pmDoc, flowOptions), contentWidth, metrics, options);
 }

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

@@ -1,5 +1,5 @@
 import { document_d_exports } from "../../types/document.js";
-import { BorderStyle, FlowBlock, ParagraphAttrs } from "../../layout-engine/types.js";
+import { BorderStyle, FlowBlock, ParagraphAttrs, TableBlock } from "../../layout-engine/types.js";
 import { FontAlternates } from "../../fonts/fontAlternates.js";
 import { formatCounter, resolveListTemplate } from "../../prosemirror/listMarker.js";
 import { Node } from "prosemirror-model";
@@ -58,6 +58,8 @@ type ToFlowBlocksOptions = {
   };
   /** Document-generation policy for justified line fitting. */
   justificationCompatibility?: NonNullable<ParagraphAttrs["justificationCompatibility"]>;
+  /** Document-generation policy for where `w:tblInd` is measured from. */
+  tableIndentCompatibility?: NonNullable<TableBlock["indentCompatibility"]>;
   /** Document-wide automatic hyphenation policy. */
   automaticHyphenation?: NonNullable<ParagraphAttrs["automaticHyphenation"]>;
   /** Line pitch for the final body section, whose properties live outside the PM body. */

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

@@ -1148,6 +1148,7 @@ function convertTable(node, startPos, options) {
 	const originalFormatting = attrs._originalFormatting;
 	const effectiveIndent = attrs._resolvedIndent ?? originalFormatting?.indent;
 	const indentPx = effectiveIndent?.value !== void 0 && effectiveIndent?.type === "dxa" ? twipsToPixels(effectiveIndent.value) : void 0;
+	const dropsAuthoredIndent = effectiveIndent?.value !== void 0 && indentPx === void 0;
 	const floating = attrs.floating;
 	let floatingPx;
 	if (floating) {
@@ -1177,6 +1178,7 @@ function convertTable(node, startPos, options) {
 	if (originalFormatting?.layout !== void 0) tableBlock.layout = originalFormatting.layout;
 	if (justification) tableBlock.justification = justification;
 	if (indentPx !== void 0) tableBlock.indent = indentPx;
+	if (options.tableIndentCompatibility && !dropsAuthoredIndent) tableBlock.indentCompatibility = options.tableIndentCompatibility;
 	if (floatingPx) tableBlock.floating = floatingPx;
 	if (attrs._resolvedBidi ?? originalFormatting?.bidi) tableBlock.bidi = true;
 	return tableBlock;

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

@@ -0,0 +1,62 @@
+import { FontMetrics, FontStyle, RunMeasurement } from "./measureTypes.js";
+import { ScriptClass } from "../../utils/scriptSegments.js";
+//#region src/layout-engine/measure/advanceComposition.d.ts
+/**
+ * Raw advance of `text` in `style`, with no letter spacing, no horizontal
+ * scale and no text transform applied: those are this module's job.
+ */
+type GlyphAdvanceFn = (text: string, style: FontStyle) => number;
+/**
+ * Advances for a whole string, one per code point, from a backend that shapes.
+ *
+ * Separate from {@link GlyphAdvanceFn} because a shaped run has no per-code-point
+ * width to ask for: two letters that ligate have one advance between them, and
+ * a letter's width depends on the neighbours it joins to. A backend that can
+ * answer for the string as a whole supplies this; one that cannot leaves it out
+ * and every code point is measured alone.
+ */
+type GlyphAdvancesFn = (text: string, style: FontStyle) => readonly number[];
+declare const applyMeasurementTextTransform: (text: string, style: FontStyle) => string;
+/** Resolve the independent font/style slot a script segment selects. */
+declare const scriptStyle: (style: FontStyle, script: ScriptClass) => FontStyle;
+/**
+ * Keep only the properties that change a glyph's advance, so a per-script
+ * segment takes the single-font path: letter spacing and horizontal scale are
+ * applied once over the whole string, never per segment.
+ */
+declare const glyphAdvanceStyle: (style: FontStyle) => FontStyle;
+type ComposeTextWidthOptions = {
+  readonly text: string;
+  readonly style: FontStyle;
+  readonly advanceOf: GlyphAdvanceFn;
+};
+/**
+ * Width of a string: the advance width used for line breaking, never the
+ * painted (ink) extent, which includes overhang a break decision must ignore.
+ */
+declare const composeTextWidth: ({ text, style: source, advanceOf }: ComposeTextWidthOptions) => number;
+type ComposeRunMeasurementOptions = {
+  readonly text: string;
+  readonly style: FontStyle;
+  readonly metrics: FontMetrics;
+  readonly advanceOf: GlyphAdvanceFn;
+  /**
+   * Used for the stretches of text whose glyphs shaping chooses. Absent when
+   * the backend has no shaper, which leaves those stretches measured one code
+   * point at a time: visibly wrong for the script, and the reason a document
+   * that contains one resolves a shaper before it is laid out.
+   */
+  readonly advancesOf?: GlyphAdvancesFn | undefined;
+};
+/**
+ * Per-code-point advances for click positioning.
+ *
+ * Iterates whole code points so an astral ideograph takes the East-Asian font
+ * and gets a real width, while `charWidths` stays one entry per UTF-16 unit
+ * (the trailing unit of a surrogate pair carries 0) so it keeps aligning with
+ * ProseMirror offsets. The total differs from {@link composeTextWidth} for a
+ * kerned or ligature-forming run, because each code point is measured alone.
+ */
+declare const composeRunMeasurement: ({ text, style: source, metrics, advanceOf, advancesOf }: ComposeRunMeasurementOptions) => RunMeasurement;
+//#endregion
+export { GlyphAdvanceFn, GlyphAdvancesFn, applyMeasurementTextTransform, composeRunMeasurement, composeTextWidth, glyphAdvanceStyle, scriptStyle };