@stll/folio-core 0.6.1 → 0.8.0

package/dist/docx/server/extractDocxText.js

@@ -0,0 +1,154 @@
+import { findAllDeep, findChild, findDeep, getAttributeAnyPrefix, getLocalName, getTextContent, parseXml } from "../xmlParser.js";
+import { loadDocxArchive } from "./boundedArchive.js";
+//#region src/docx/server/extractDocxText.ts
+const HEADER_FOOTER_PATH = /^word\/(?:header|footer)\d+\.xml$/u;
+const childElements = (element) => element.elements?.filter((child) => child.type === "element") ?? [];
+const collectText = (element) => {
+	let text = "";
+	const walk = (node) => {
+		const localName = getLocalName(node.name ?? "");
+		if (localName === "t") {
+			text += getTextContent(node);
+			return;
+		}
+		if (localName === "br") {
+			text += "\n";
+			return;
+		}
+		if (localName === "tab") {
+			text += "	";
+			return;
+		}
+		if (localName === "del" || localName === "delText" || localName === "moveFrom") return;
+		for (const child of childElements(node)) walk(child);
+	};
+	walk(element);
+	return text;
+};
+const readParagraphProperties = (paragraph) => {
+	const properties = findChild(paragraph, "w", "pPr");
+	if (!properties) return {};
+	const result = {};
+	const styleValue = getAttributeAnyPrefix(findChild(properties, "w", "pStyle"), "val");
+	if (styleValue !== null) result.style = styleValue;
+	const alignment = getAttributeAnyPrefix(findChild(properties, "w", "jc"), "val");
+	if (alignment === "left" || alignment === "center" || alignment === "right" || alignment === "both") result.alignment = alignment;
+	return result;
+};
+const readRunMetrics = (paragraph) => {
+	const metrics = [];
+	for (const run of childElements(paragraph)) {
+		if (getLocalName(run.name ?? "") !== "r") continue;
+		const properties = findChild(run, "w", "rPr");
+		const boldProperty = findChild(properties, "w", "b");
+		const boldValue = getAttributeAnyPrefix(boldProperty, "val");
+		const bold = boldProperty !== null && boldValue !== "0" && boldValue !== "false";
+		const sizeValue = getAttributeAnyPrefix(findChild(properties, "w", "sz"), "val");
+		const parsedSize = sizeValue === null ? NaN : Number.parseInt(sizeValue, 10);
+		const fontSize = Number.isFinite(parsedSize) && parsedSize > 0 ? parsedSize : void 0;
+		let chars = 0;
+		for (const textNode of findAllDeep(run, "w", "t")) chars += getTextContent(textNode).length;
+		if (chars === 0) continue;
+		const entry = {
+			bold,
+			chars
+		};
+		if (fontSize !== void 0) entry.fontSize = fontSize;
+		metrics.push(entry);
+	}
+	return metrics;
+};
+const extractContainer = ({ container, source, startIndex }) => {
+	const paragraphs = [];
+	let charCount = 0;
+	for (const [offset, paragraph] of findAllDeep(container, "w", "p").entries()) {
+		const text = collectText(paragraph);
+		const entry = {
+			index: startIndex + offset,
+			text,
+			source
+		};
+		const { style, alignment } = readParagraphProperties(paragraph);
+		if (style !== void 0) entry.style = style;
+		if (alignment !== void 0) entry.alignment = alignment;
+		const runs = readRunMetrics(paragraph);
+		if (runs.length > 0) {
+			const totalChars = runs.reduce((sum, run) => sum + run.chars, 0);
+			if (runs.reduce((sum, run) => sum + (run.bold ? run.chars : 0), 0) > totalChars / 2) entry.bold = true;
+			const firstFontSize = runs.find((run) => run.fontSize !== void 0)?.fontSize;
+			if (firstFontSize !== void 0) entry.fontSize = firstFontSize;
+		}
+		paragraphs.push(entry);
+		charCount += text.length;
+	}
+	return {
+		paragraphs,
+		charCount
+	};
+};
+const extractParts = async ({ archive, source, rootName, startIndex }) => {
+	const paragraphs = [];
+	let charCount = 0;
+	let nextIndex = startIndex;
+	const prefix = `word/${source}`;
+	const paths = archive.entries.filter((path) => HEADER_FOOTER_PATH.test(path) && path.startsWith(prefix)).toSorted();
+	for (const path of paths) {
+		const xml = await archive.readEntryString(path);
+		if (xml === null) continue;
+		const container = findDeep(parseXml(xml), "w", rootName);
+		if (!container) continue;
+		const result = extractContainer({
+			container,
+			source,
+			startIndex: nextIndex
+		});
+		paragraphs.push(...result.paragraphs);
+		charCount += result.charCount;
+		nextIndex += result.paragraphs.length;
+	}
+	return {
+		paragraphs,
+		charCount
+	};
+};
+const createEmptyResult = () => ({
+	paragraphs: [],
+	charCount: 0,
+	view: "accepted"
+});
+/** Extract paragraph text and formatting metadata from a DOCX archive. */
+const extractDocxText = async (bytes) => {
+	const archive = await loadDocxArchive(bytes);
+	const documentXml = await archive.readEntryString("word/document.xml");
+	if (documentXml === null) return createEmptyResult();
+	const body = findDeep(parseXml(documentXml), "w", "body");
+	if (!body) return createEmptyResult();
+	const headers = await extractParts({
+		archive,
+		source: "header",
+		rootName: "hdr",
+		startIndex: 0
+	});
+	const bodyResult = extractContainer({
+		container: body,
+		source: "body",
+		startIndex: headers.paragraphs.length
+	});
+	const footers = await extractParts({
+		archive,
+		source: "footer",
+		rootName: "ftr",
+		startIndex: headers.paragraphs.length + bodyResult.paragraphs.length
+	});
+	return {
+		paragraphs: [
+			...headers.paragraphs,
+			...bodyResult.paragraphs,
+			...footers.paragraphs
+		],
+		charCount: headers.charCount + bodyResult.charCount + footers.charCount,
+		view: "accepted"
+	};
+};
+//#endregion
+export { extractDocxText };

package/dist/docx/tableParser.js

@@ -353,6 +353,14 @@ function parseTableCellStructuralChange(tcPrElement) {
 function parseTableRowProperties(trPrElement) {
 	if (!trPrElement) return;
 	const formatting = {};
+	const gridBefore = parseNumericAttribute(findChild(trPrElement, "w", "gridBefore"), "w", "val");
+	if (gridBefore !== void 0 && gridBefore > 0) formatting.gridBefore = gridBefore;
+	const widthBefore = parseTableMeasurement(findChild(trPrElement, "w", "wBefore"));
+	if (widthBefore) formatting.widthBefore = widthBefore;
+	const gridAfter = parseNumericAttribute(findChild(trPrElement, "w", "gridAfter"), "w", "val");
+	if (gridAfter !== void 0 && gridAfter > 0) formatting.gridAfter = gridAfter;
+	const widthAfter = parseTableMeasurement(findChild(trPrElement, "w", "wAfter"));
+	if (widthAfter) formatting.widthAfter = widthAfter;
 	const heightElement = findChild(trPrElement, "w", "trHeight");
 	if (heightElement) {
 		const heightVal = parseNumericAttribute(heightElement, "w", "val");

package/dist/docx/textBoxParser.js

@@ -1,4 +1,4 @@
-import { findByFullName, findChildrenByLocalName, getAttribute, getChildElements, parseNumericAttribute } from "./xmlParser.js";
+import { findByFullName, findChildByLocalName, findChildrenByLocalName, getAttribute, getChildElements, parseNumericAttribute } from "./xmlParser.js";
 import { emuToPixels } from "../utils/units.js";
 import { parseAnchorPosition, parseAnchorWrap, parseFill, parseOutline, resolveColorValueToHex } from "./drawingUtils.js";
 //#region src/docx/textBoxParser.ts
@@ -11,6 +11,9 @@ const DEFAULT_MARGIN_EMU = 91440;
 function parseBodyProperties(bodyPr) {
 	if (!bodyPr) return {};
 	const result = {};
+	if (findChildByLocalName(bodyPr, "spAutoFit")) result.autoFit = "shape";
+	else if (findChildByLocalName(bodyPr, "normAutofit")) result.autoFit = "normal";
+	else if (findChildByLocalName(bodyPr, "noAutofit")) result.autoFit = "none";
 	const lIns = parseNumericAttribute(bodyPr, null, "lIns");
 	const rIns = parseNumericAttribute(bodyPr, null, "rIns");
 	const tIns = parseNumericAttribute(bodyPr, null, "tIns");
@@ -121,6 +124,7 @@ function parseTextBox(drawingEl) {
 	if (fill) textBox.fill = fill;
 	if (outline) textBox.outline = outline;
 	if (bodyProps.margins) textBox.margins = bodyProps.margins;
+	if (bodyProps.autoFit) textBox.autoFit = bodyProps.autoFit;
 	if (isAnchor) {
 		const position = parseAnchorPosition(container);
 		if (position) textBox.position = position;
@@ -162,6 +166,7 @@ function parseTextBoxFromShape(wsp, size, position, wrap) {
 	if (fill) textBox.fill = fill;
 	if (outline) textBox.outline = outline;
 	if (bodyProps.margins) textBox.margins = bodyProps.margins;
+	if (bodyProps.autoFit) textBox.autoFit = bodyProps.autoFit;
 	if (position) textBox.position = position;
 	if (wrap) textBox.wrap = wrap;
 	return textBox;

package/dist/docx/vmlImageParser.js

@@ -1,8 +1,30 @@
-import { cloneWithXmlnsDeclarations, elementToXml, findAllDeep, findChild, getAttribute } from "./xmlParser.js";
+import { cloneWithXmlnsDeclarations, elementToXml, findAllDeep, findChild, getAttribute, getChildElements, getLocalName } from "./xmlParser.js";
 import { pixelsToEmu } from "../utils/units.js";
 import { resolveImageData } from "./imageParser.js";
 import { isWatermarkShape } from "./watermarkParser.js";
 //#region src/docx/vmlImageParser.ts
+const MAX_VML_PREVIEW_SHAPES = 256;
+const MAX_VML_PREVIEW_DIMENSION_PX = 2e4;
+const MAX_VML_SVG_CHARACTERS = 1e6;
+const SAFE_VML_COLORS = /* @__PURE__ */ new Set([
+	"black",
+	"white",
+	"red",
+	"green",
+	"blue",
+	"yellow",
+	"gray",
+	"grey",
+	"silver",
+	"maroon",
+	"purple",
+	"fuchsia",
+	"lime",
+	"olive",
+	"navy",
+	"teal",
+	"aqua"
+]);
 /**
 * Convert a CSS length (pt/in/px/cm/mm/pc, default px) to pixels. Units are
 * matched case-insensitively (`2IN`, `2Pt` are valid VML). The numeric part
@@ -40,6 +62,116 @@ function parseStyleAttr(style) {
 	}
 	return out;
 }
+const finiteNumber = (raw) => {
+	if (!raw || !/^-?(?:\d+(?:\.\d+)?|\.\d+)$/u.test(raw.trim())) return;
+	const value = Number.parseFloat(raw);
+	return Number.isFinite(value) ? value : void 0;
+};
+const coordinatePair = (raw) => {
+	const [firstRaw, secondRaw, extra] = raw?.split(",").map((part) => part.trim()) ?? [];
+	if (extra !== void 0) return;
+	const first = finiteNumber(firstRaw);
+	const second = finiteNumber(secondRaw);
+	return first === void 0 || second === void 0 ? void 0 : {
+		first,
+		second
+	};
+};
+const safeColor = (raw, fallback) => {
+	const normalized = raw?.trim().toLowerCase();
+	if (!normalized) return fallback;
+	if (SAFE_VML_COLORS.has(normalized)) return normalized;
+	if (/^#[0-9a-f]{3}(?:[0-9a-f]{3})?$/u.test(normalized)) return normalized;
+	return /^[0-9a-f]{6}$/u.test(normalized) ? `#${normalized}` : fallback;
+};
+const validPreviewDimension = (value) => value !== void 0 && value > 0 && value <= MAX_VML_PREVIEW_DIMENSION_PX;
+const svgDataUrl = (svg) => svg.length <= MAX_VML_SVG_CHARACTERS ? `data:image/svg+xml;charset=utf-8,${encodeURIComponent(svg)}` : void 0;
+const vmlShapeSvg = (shape, width, height, x = 0, y = 0) => {
+	const fill = safeColor(getAttribute(shape, null, "fillcolor"), "white");
+	const stroke = getAttribute(shape, null, "stroked")?.toLowerCase() !== "f" ? safeColor(getAttribute(shape, null, "strokecolor"), "black") : "none";
+	const localName = getLocalName(shape.name ?? "");
+	if (localName === "oval") return `<ellipse cx="${x + width / 2}" cy="${y + height / 2}" rx="${width / 2}" ry="${height / 2}" fill="${fill}" stroke="${stroke}"/>`;
+	return `<rect x="${x}" y="${y}" width="${width}" height="${height}" rx="${localName === "roundrect" ? Math.min(width, height) * .1 : 0}" fill="${fill}" stroke="${stroke}"/>`;
+};
+const previewImage = (pictElement, svg, widthPx, heightPx, style, rootXmlns) => {
+	const src = svgDataUrl(svg);
+	if (!src) return null;
+	const leftPx = cssLengthToPx(style["margin-left"] ?? style["left"]) ?? 0;
+	const topPx = cssLengthToPx(style["margin-top"] ?? style["top"]) ?? 0;
+	const horizontalRelative = style["mso-position-horizontal-relative"] === "page";
+	const verticalRelative = style["mso-position-vertical-relative"] === "page";
+	const zIndex = finiteNumber(style["z-index"]);
+	return {
+		type: "drawing",
+		image: {
+			type: "image",
+			rId: "",
+			src,
+			mimeType: "image/svg+xml",
+			filename: "vml-shape-preview.svg",
+			size: {
+				width: pixelsToEmu(widthPx),
+				height: pixelsToEmu(heightPx)
+			},
+			wrap: { type: zIndex !== void 0 && zIndex >= 0 ? "inFront" : "behind" },
+			position: {
+				horizontal: {
+					relativeTo: horizontalRelative ? "page" : "character",
+					posOffset: pixelsToEmu(leftPx)
+				},
+				vertical: {
+					relativeTo: verticalRelative ? "page" : "paragraph",
+					posOffset: pixelsToEmu(topPx)
+				}
+			}
+		},
+		rawXml: elementToXml(cloneWithXmlnsDeclarations(pictElement, rootXmlns))
+	};
+};
+const parseStandaloneShapePreview = (pictElement, shape, rootXmlns) => {
+	const style = parseStyleAttr(getAttribute(shape, null, "style"));
+	const widthPx = cssLengthToPx(style["width"]);
+	const heightPx = cssLengthToPx(style["height"]);
+	if (!validPreviewDimension(widthPx) || !validPreviewDimension(heightPx)) return null;
+	const svg = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${widthPx} ${heightPx}" width="${widthPx}" height="${heightPx}">${vmlShapeSvg(shape, widthPx, heightPx)}</svg>`;
+	return previewImage(pictElement, svg, widthPx, heightPx, style, rootXmlns);
+};
+const parseGroupPreview = (pictElement, group, rootXmlns) => {
+	const style = parseStyleAttr(getAttribute(group, null, "style"));
+	const widthPx = cssLengthToPx(style["width"]);
+	const heightPx = cssLengthToPx(style["height"]);
+	if (!validPreviewDimension(widthPx) || !validPreviewDimension(heightPx)) return null;
+	const origin = coordinatePair(getAttribute(group, null, "coordorigin")) ?? {
+		first: 0,
+		second: 0
+	};
+	const size = coordinatePair(getAttribute(group, null, "coordsize")) ?? {
+		first: widthPx,
+		second: heightPx
+	};
+	if (size.first <= 0 || size.second <= 0) return null;
+	const content = getChildElements(group).slice(0, MAX_VML_PREVIEW_SHAPES).map((child) => {
+		const localName = getLocalName(child.name ?? "");
+		if (localName === "line") {
+			const from = coordinatePair(getAttribute(child, null, "from"));
+			const to = coordinatePair(getAttribute(child, null, "to"));
+			if (!from || !to) return "";
+			const stroke = safeColor(getAttribute(child, null, "strokecolor"), "black");
+			return `<line x1="${from.first}" y1="${from.second}" x2="${to.first}" y2="${to.second}" stroke="${stroke}"/>`;
+		}
+		if (localName !== "rect" && localName !== "roundrect" && localName !== "oval") return "";
+		const childStyle = parseStyleAttr(getAttribute(child, null, "style"));
+		const x = finiteNumber(childStyle["left"]);
+		const y = finiteNumber(childStyle["top"]);
+		const width = finiteNumber(childStyle["width"]);
+		const height = finiteNumber(childStyle["height"]);
+		if (x === void 0 || y === void 0 || width === void 0 || height === void 0) return "";
+		return vmlShapeSvg(child, width, height, x, y);
+	}).join("");
+	if (!content) return null;
+	const svg = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="${origin.first} ${origin.second} ${size.first} ${size.second}" width="${widthPx}" height="${heightPx}">${content}</svg>`;
+	return previewImage(pictElement, svg, widthPx, heightPx, style, rootXmlns);
+};
 /**
 * Read the relationship id off a `v:imagedata` element. Word writes `r:id`;
 * some legacy / third-party generators use `r:embed` or the office-namespace
@@ -94,6 +226,18 @@ function parseVmlImageContent(pictElement, rels, media, rootXmlns = {}) {
 			rawXml: elementToXml(cloneWithXmlnsDeclarations(pictElement, rootXmlns))
 		};
 	}
+	for (const child of getChildElements(pictElement)) {
+		const localName = getLocalName(child.name ?? "");
+		if (localName === "group") {
+			const preview = parseGroupPreview(pictElement, child, rootXmlns);
+			if (preview) return preview;
+			continue;
+		}
+		if (localName === "rect" || localName === "roundrect" || localName === "oval") {
+			const preview = parseStandaloneShapePreview(pictElement, child, rootXmlns);
+			if (preview) return preview;
+		}
+	}
 	return null;
 }
 //#endregion

package/dist/index.d.ts

@@ -11,7 +11,8 @@ import { ResolvedAnchor, isSuggestionStale, resolveSuggestionAnchor } from "./ai
 import { PositionalText, buildPositionalText } from "./ai-suggestions/text-positions.js";
 import { CreateEmptyDocumentOptions, createEmptyDocument } from "./utils/createDocument.js";
 import { createDocx } from "./docx/rezip.js";
-import { DocxCompatibility } from "./docx/compatibility.js";
+import { FOLIO_DOCX_CAPABILITY_HOSTS, FOLIO_DOCX_CAPABILITY_IDS, FOLIO_DOCX_CAPABILITY_MANIFEST, FOLIO_DOCX_CAPABILITY_MANIFEST_VERSION, FOLIO_DOCX_CAPABILITY_OPERATIONS, FOLIO_DOCX_COMPATIBILITY_HOSTS, FOLIO_DOCX_COMPATIBILITY_PROFILES, FOLIO_DOCX_PROFILES, FOLIO_DOCX_SUPPORT_STATES, FolioDocxCapabilityHost, FolioDocxCapabilityId, FolioDocxCapabilityManifest, FolioDocxCapabilityOperation, FolioDocxCompatibilityHost, FolioDocxCompatibilityProfile, FolioDocxFeatureCapability, FolioDocxProfile, FolioDocxSupportState, InvalidFolioDocxCapabilityIdError, getFolioDocxCapability, isFolioDocxCapabilityId } from "./docx/capabilities.js";
+import { DocxCompatibility, DocxCompatibilityContext, DocxCompatibilityIssue, DocxCompatibilityLocation, DocxCompatibilityPart, 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 +27,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 "@stll/docx-core/model";
 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, DOCX_CONFORMANCE_CLASSES, type DeriveBlockIdInput, type DirectiveKind, type DirectiveRange, type Document, type DocxCompatibility, type DocxCompatibilityContext, type DocxCompatibilityIssue, type DocxCompatibilityLocation, type DocxCompatibilityPart, type DocxConformanceClass, 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, FOLIO_DOCX_CAPABILITY_HOSTS, FOLIO_DOCX_CAPABILITY_IDS, FOLIO_DOCX_CAPABILITY_MANIFEST, FOLIO_DOCX_CAPABILITY_MANIFEST_VERSION, FOLIO_DOCX_CAPABILITY_OPERATIONS, FOLIO_DOCX_COMPATIBILITY_HOSTS, FOLIO_DOCX_COMPATIBILITY_PROFILES, FOLIO_DOCX_PROFILES, FOLIO_DOCX_SUPPORT_STATES, 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 FolioDocxCapabilityHost, type FolioDocxCapabilityId, type FolioDocxCapabilityManifest, type FolioDocxCapabilityOperation, type FolioDocxCompatibilityHost, type FolioDocxCompatibilityProfile, type FolioDocxFeatureCapability, type FolioDocxProfile, type FolioDocxSupportState, type ImageMeta, type ImageRef, type InspectDocxCompatibilityOptions, InvalidFolioDocumentOperationBatchError, InvalidFolioDocxCapabilityIdError, 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, getFolioDocxCapability, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, inspectDocxCompatibility, isFolioBlockId, isFolioDocumentOperationModeSupported, isFolioDocxCapabilityId, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };

package/dist/index.js

@@ -5,6 +5,8 @@ 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 { createEmptyDocument } from "./utils/createDocument.js";
 import { createDocx } from "./docx/rezip.js";
+import { FOLIO_DOCX_CAPABILITY_HOSTS, FOLIO_DOCX_CAPABILITY_IDS, FOLIO_DOCX_CAPABILITY_MANIFEST, FOLIO_DOCX_CAPABILITY_MANIFEST_VERSION, FOLIO_DOCX_CAPABILITY_OPERATIONS, FOLIO_DOCX_COMPATIBILITY_HOSTS, FOLIO_DOCX_COMPATIBILITY_PROFILES, FOLIO_DOCX_PROFILES, FOLIO_DOCX_SUPPORT_STATES, InvalidFolioDocxCapabilityIdError, getFolioDocxCapability, isFolioDocxCapabilityId } from "./docx/capabilities.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";
@@ -22,4 +24,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 "@stll/docx-core/model";
+export { DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, 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, FOLIO_DOCX_CAPABILITY_HOSTS, FOLIO_DOCX_CAPABILITY_IDS, FOLIO_DOCX_CAPABILITY_MANIFEST, FOLIO_DOCX_CAPABILITY_MANIFEST_VERSION, FOLIO_DOCX_CAPABILITY_OPERATIONS, FOLIO_DOCX_COMPATIBILITY_HOSTS, FOLIO_DOCX_COMPATIBILITY_PROFILES, FOLIO_DOCX_PROFILES, FOLIO_DOCX_SUPPORT_STATES, InvalidFolioDocumentOperationBatchError, InvalidFolioDocxCapabilityIdError, 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, getFolioDocxCapability, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, inspectDocxCompatibility, isFolioBlockId, isFolioDocumentOperationModeSupported, isFolioDocxCapabilityId, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };

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

@@ -16,6 +16,10 @@ function hasAuthoredVisualContent(block) {
 	if (attrs.spacingExplicit?.before || attrs.spacingExplicit?.after) return true;
 	return false;
 }
+function preservesInheritedSpacing(block) {
+	if (!isVisuallyEmptyParagraph(block)) return false;
+	return block.attrs?.styleId !== void 0 || block.attrs?.hasDirectParagraphFormatting === true || block.attrs?.hasDirectParagraphMarkFormatting === true;
+}
 function normalizeHeaderFooterMeasureBlocks(blocks, section = "header") {
 	return normalizeFlowBlockArray(blocks, { suppressTrailingEmptyAfterTable: section === "header" });
 }
@@ -33,8 +37,9 @@ function normalizeFlowBlockArray(blocks, normalization) {
 		const explicit = block.attrs?.spacingExplicit;
 		const hasResolvedBefore = block.attrs?.spacing?.before != null;
 		const hasResolvedAfter = block.attrs?.spacing?.after != null;
-		const beforeIsInherited = hasResolvedBefore && !explicit?.before;
-		const afterIsInherited = hasResolvedAfter && !explicit?.after;
+		const preserveInherited = preservesInheritedSpacing(block);
+		const beforeIsInherited = hasResolvedBefore && !explicit?.before && !preserveInherited;
+		const afterIsInherited = hasResolvedAfter && !explicit?.after && !preserveInherited;
 		const stripsSpacing = beforeIsInherited || afterIsInherited;
 		const stripsImages = block.runs.some(isAnchoredImageRun);
 		if (!stripsSpacing && !stripsImages && !isTrailingEmpty) return block;
@@ -79,6 +84,10 @@ function isVisuallyEmptyParagraph(block) {
 	if (block.kind !== "paragraph") return false;
 	return block.runs.every((run) => run.kind === "text" && run.text.trim().length === 0);
 }
+function isPaintlessParagraph(block) {
+	if (block.kind !== "paragraph") return false;
+	return block.runs.every((run) => run.kind === "text" && run.text.trim().length === 0 || run.kind === "tab" || run.kind === "lineBreak");
+}
 function normalizeTableBlock(block) {
 	const blockState = { changed: false };
 	const rows = block.rows.map((row) => {
@@ -232,6 +241,10 @@ function calculateHeaderFooterVisualBounds(blocks, measures, flowHeight, metrics
 * these bounds separately describe the in-flow portion for API consumers.
 */
 function calculateHeaderFooterMarginPushBounds(blocks, measures, flowHeight, metrics) {
+	if (blocks.length > 0 && blocks.every((block) => isPaintlessParagraph(block) && !hasAuthoredVisualContent(block))) return {
+		top: 0,
+		bottom: 0
+	};
 	let top = 0;
 	let bottom = 0;
 	let cursorY = 0;
@@ -422,6 +435,7 @@ function serializeParagraphAttrs(attrs) {
 		"listMarker",
 		"listIsBullet",
 		"listMarkerHidden",
+		"listMarkerAlignment",
 		"listMarkerSuffix",
 		"tabs"
 	];

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

@@ -0,0 +1,7 @@
+import { BlockId, FlowBlock } from "../../layout-engine/types.js";
+
+//#region src/layout-bridge/convert/paragraphFrames.d.ts
+type BlockIdFactory = () => BlockId;
+declare function groupParagraphFrames(blocks: FlowBlock[], nextBlockId: BlockIdFactory): FlowBlock[];
+//#endregion
+export { groupParagraphFrames };

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

@@ -0,0 +1,136 @@
+import { pixelsToEmu } from "../../utils/units.js";
+import { setTextBoxGroupId } from "../../layout-engine/textBoxGroup.js";
+import { getParagraphFrame, markParagraphFrameTextBox } from "../../layout-engine/paragraphFrame.js";
+//#region src/layout-bridge/convert/paragraphFrames.ts
+const FRAME_PROPERTIES = [
+	"width",
+	"height",
+	"hSpace",
+	"vSpace",
+	"hAnchor",
+	"vAnchor",
+	"x",
+	"y",
+	"xAlign",
+	"yAlign",
+	"wrap"
+];
+function framesEqual(left, right) {
+	return FRAME_PROPERTIES.every((property) => left[property] === right[property]);
+}
+function horizontalRelativeTo(anchor) {
+	if (anchor === "page" || anchor === "margin") return anchor;
+	return "column";
+}
+function verticalRelativeTo(anchor) {
+	if (anchor === "page" || anchor === "margin") return anchor;
+	return "paragraph";
+}
+function framePosition(frame) {
+	const horizontal = frame.x !== void 0 || frame.xAlign !== void 0 || frame.hAnchor !== void 0 ? {
+		relativeTo: horizontalRelativeTo(frame.hAnchor),
+		...frame.x !== void 0 ? { posOffset: pixelsToEmu(frame.x) } : {},
+		...frame.xAlign !== void 0 ? { align: frame.xAlign } : {}
+	} : void 0;
+	const verticalAlign = frame.yAlign === "inline" ? void 0 : frame.yAlign;
+	const vertical = frame.y !== void 0 || verticalAlign !== void 0 || frame.vAnchor !== void 0 ? {
+		relativeTo: verticalRelativeTo(frame.vAnchor),
+		...frame.y !== void 0 ? { posOffset: pixelsToEmu(frame.y) } : {},
+		...verticalAlign !== void 0 ? { align: verticalAlign } : {}
+	} : void 0;
+	if (horizontal === void 0 && vertical === void 0) return;
+	return {
+		...horizontal !== void 0 ? { horizontal } : {},
+		...vertical !== void 0 ? { vertical } : {}
+	};
+}
+function frameWrapType(frame) {
+	switch (frame.wrap) {
+		case "notBeside": return "topAndBottom";
+		case "none": return "inFront";
+		case "through": return "through";
+		case "tight": return "tight";
+		case "around":
+		case "auto":
+		case void 0: return "square";
+		default:
+			frame.wrap;
+			return "square";
+	}
+}
+function toFrameTextBox(content, frame, nextBlockId) {
+	const first = content.at(0);
+	const last = content.at(-1);
+	const textBox = {
+		kind: "textBox",
+		id: nextBlockId(),
+		width: frame.width ?? 200,
+		margins: {
+			top: 0,
+			right: 0,
+			bottom: 0,
+			left: 0
+		},
+		content,
+		displayMode: "float",
+		wrapType: frameWrapType(frame),
+		wrapText: "bothSides",
+		distTop: frame.vSpace ?? 0,
+		distBottom: frame.vSpace ?? 0,
+		distLeft: frame.hSpace ?? 0,
+		distRight: frame.hSpace ?? 0,
+		...first?.pmStart !== void 0 ? { pmStart: first.pmStart } : {},
+		...last?.pmEnd !== void 0 ? { pmEnd: last.pmEnd } : {}
+	};
+	if (frame.height !== void 0) textBox.height = frame.height;
+	const position = framePosition(frame);
+	if (position !== void 0) textBox.position = position;
+	markParagraphFrameTextBox(textBox);
+	return textBox;
+}
+function groupParagraphFrames(blocks, nextBlockId) {
+	const grouped = [];
+	let index = 0;
+	let activeFrameSetId;
+	while (index < blocks.length) {
+		const block = blocks[index];
+		if (block?.kind !== "paragraph") {
+			if (block) grouped.push(block);
+			activeFrameSetId = void 0;
+			index += 1;
+			continue;
+		}
+		const frame = getParagraphFrame(block);
+		if (frame === void 0) {
+			grouped.push(block);
+			if (block.runs.length > 0 || activeFrameSetId === void 0 || !hasFollowingParagraphFrame(blocks, index + 1)) activeFrameSetId = void 0;
+			index += 1;
+			continue;
+		}
+		activeFrameSetId ??= `paragraph-frame-${block.pmStart ?? block.id}`;
+		const content = [];
+		while (index < blocks.length) {
+			const paragraph = blocks[index];
+			if (paragraph?.kind !== "paragraph") break;
+			const paragraphFrame = getParagraphFrame(paragraph);
+			if (paragraphFrame === void 0 || !framesEqual(frame, paragraphFrame)) break;
+			content.push(paragraph);
+			index += 1;
+		}
+		const textBox = toFrameTextBox(content, frame, nextBlockId);
+		setTextBoxGroupId(textBox, activeFrameSetId);
+		grouped.push(textBox);
+	}
+	return grouped;
+}
+function hasFollowingParagraphFrame(blocks, startIndex) {
+	for (let index = startIndex; index < blocks.length; index++) {
+		const block = blocks[index];
+		if (block?.kind !== "paragraph") return false;
+		if (getParagraphFrame(block) !== void 0) return true;
+		if (block.runs.length > 0) return false;
+	}
+	return false;
+}
+//#endregion
+export { groupParagraphFrames };