@stll/folio-core 0.33.1 → 0.34.0

package/dist/docx/verbatimCapture.js

@@ -0,0 +1,131 @@
+import { TRANSITIONAL_NAMESPACE_BY_STRICT_URI } from "./strictValueEncodings.gen.js";
+import { isStrictNamespaceUri, toTransitionalNamespaceUri, transitionalSlotEncoding } from "./transitionalSpelling.js";
+import { roundHalfAwayFromZero, universalMeasureAs } from "./universalMeasure.js";
+import { elementToXml, getLocalName } from "./xmlParser.js";
+import { TaggedError } from "better-result";
+//#region src/docx/verbatimCapture.ts
+/**
+* The one way to turn parsed markup into a string a rebuilt part replays.
+*
+* folio parses Strict and Transitional packages and rebuilds every package as
+* Transitional. Modeled properties are re-serialized, so they come out
+* Transitional whatever the source was; content the parser keeps verbatim —
+* raw property XML, drawing and shape bodies, text-box markup, unmodeled
+* extensions — does not, and a Strict fragment copied under a Transitional root
+* changes meaning: the namespaces it declares stay Strict while the root is
+* not, and its values are spelled the way Strict spells them (`155.85pt`,
+* `20%`) where the Transitional attribute is a number.
+*
+* A fragment is therefore converted here, at capture, where its own namespace
+* scope still says which conformance class produced it. Nothing downstream has
+* to know: {@link captureVerbatimXml} is the only producer of replayed markup,
+* and a fragment that carries no Strict namespace passes through byte for byte.
+*/
+/** A Strict fragment uses a namespace that has no Transitional counterpart. */
+var UntranslatableStrictNamespaceError = class extends TaggedError("UntranslatableStrictNamespaceError") {};
+const TRANSITIONAL_URIS = new Set(TRANSITIONAL_NAMESPACE_BY_STRICT_URI.values());
+/**
+* Drawing extensions the repository has no schema for.
+*
+* `wp14:pctWidth` and its siblings are Microsoft vocabularies, but they are
+* DrawingML by construction and DrawingML has one integer encoding for a
+* percentage, so a Strict producer's `20%` there converts like `a:alpha`'s.
+* Lengths are left alone: only an attribute's own type says what unit its
+* number counts, and guessing one would corrupt the value silently.
+*/
+const DRAWING_EXTENSION_MARKERS = [
+	"/wordprocessingCanvas",
+	"/wordprocessingDrawing",
+	"/wordprocessingGroup",
+	"/wordprocessingInk",
+	"/wordprocessingShape"
+];
+const isUnschemadDrawingNamespace = (uri) => !TRANSITIONAL_URIS.has(uri) && DRAWING_EXTENSION_MARKERS.some((marker) => uri.includes(marker));
+/** `-?12.5%`: the one shape ECMA-376 gives a percentage that carries its unit. */
+const PERCENTAGE = /^(-?[0-9]+(?:\.[0-9]+)?)%$/u;
+const NUMBERS_PER_PERCENT = {
+	fiftiethPercent: 50,
+	thousandthPercent: 1e3,
+	wholePercent: 1
+};
+/** The Transitional spelling of one Strict-produced value, or the value unchanged. */
+const transitionalValue = (value, namespaceUri, encoding) => {
+	const measureUnit = encoding?.measure;
+	if (measureUnit !== void 0) {
+		const measure = universalMeasureAs(value, measureUnit);
+		if (measure !== void 0) return String(measure);
+	}
+	const percentage = PERCENTAGE.exec(value);
+	if (percentage === null) return value;
+	const percentUnit = encoding?.percent ?? (isUnschemadDrawingNamespace(namespaceUri) ? "thousandthPercent" : void 0);
+	if (percentUnit === void 0) return value;
+	return String(roundHalfAwayFromZero(Number(percentage[1]) * NUMBERS_PER_PERCENT[percentUnit]));
+};
+const originOf = (element, inherited) => {
+	const uri = element.namespaceUri;
+	if (uri === void 0) return inherited;
+	if (isStrictNamespaceUri(uri)) return "strict";
+	if (uri.startsWith("http://purl.oclc.org/ooxml/")) throw new UntranslatableStrictNamespaceError({
+		message: `Strict namespace ${uri} has no Transitional counterpart; folio will not replay it under a Transitional root.`,
+		uri
+	});
+	return TRANSITIONAL_URIS.has(uri) ? "transitional" : inherited;
+};
+const convertAttributes = (element, namespaceUri, localName) => {
+	const attributes = element.attributes ?? {};
+	let converted;
+	for (const [name, raw] of Object.entries(attributes)) {
+		if (typeof raw !== "string") continue;
+		const next = name === "xmlns" || name.startsWith("xmlns:") ? toTransitionalNamespaceUri(raw) : transitionalValue(raw, namespaceUri, transitionalSlotEncoding(element.namespaceUri, localName, getLocalName(name)));
+		if (next === raw) continue;
+		converted ??= { ...attributes };
+		converted[name] = next;
+	}
+	return converted;
+};
+const childWithValue = (child, text) => text === child.text ? child : {
+	...child,
+	text
+};
+const toTransitional = (element, inherited) => {
+	if (element.type === "text") return element;
+	const origin = originOf(element, inherited);
+	const namespaceUri = element.namespaceUri === void 0 ? "" : toTransitionalNamespaceUri(element.namespaceUri);
+	const localName = getLocalName(element.name);
+	const textEncoding = transitionalSlotEncoding(element.namespaceUri, localName);
+	const attributes = origin === "strict" && element.attributes ? convertAttributes(element, namespaceUri, localName) : void 0;
+	let elements;
+	for (const [index, child] of (element.elements ?? []).entries()) {
+		const next = origin === "strict" && child.type === "text" && typeof child.text === "string" ? childWithValue(child, transitionalValue(child.text, namespaceUri, textEncoding)) : toTransitional(child, origin);
+		if (next === child) continue;
+		elements ??= [...element.elements ?? []];
+		elements[index] = next;
+	}
+	if (attributes === void 0 && elements === void 0) return element;
+	return {
+		...element,
+		...attributes === void 0 ? {} : { attributes },
+		...elements === void 0 ? {} : { elements }
+	};
+};
+/** True when any binding in scope, including inherited ones, is a Strict namespace. */
+const scopeDeclaresStrict = (scope) => {
+	for (let current = scope; current; current = current.parent) for (const uri of current.bindings.values()) if (uri.startsWith("http://purl.oclc.org/ooxml/")) return true;
+	return false;
+};
+/**
+* Serialize parsed markup for replay inside a rebuilt Transitional part.
+*
+* Every verbatim capture goes through here — a lint rule keeps
+* {@link elementToXml} out of reach of the parsers — so a replay path added
+* later cannot skip the conversion. Markup that binds no Strict namespace,
+* anywhere in scope or in the fragment itself, is serialized once and returned
+* unchanged.
+*/
+const captureVerbatimXml = (element) => {
+	const xml = elementToXml(element);
+	if (!xml.includes("http://purl.oclc.org/ooxml/") && !scopeDeclaresStrict(element.namespaceScope)) return xml;
+	return elementToXml(toTransitional(element, "transitional"));
+};
+//#endregion
+export { UntranslatableStrictNamespaceError, captureVerbatimXml };

package/dist/docx/vmlImageParser.js

@@ -1,9 +1,10 @@
 import { sanitizeImageSrc } from "../utils/sanitizeImageSrc.js";
 import { pixelsToEmu } from "../utils/units.js";
 import { resolveImageData } from "./imageParser.js";
+import { captureVerbatimXml } from "./verbatimCapture.js";
 import { isValidVmlPreviewDimension, parseVmlNumber, parseVmlStyle, renderStandaloneVmlPreview, renderVmlGroupPreview, vmlCssLengthToPx, vmlSvgDataUrl } from "./vmlPreview.js";
 import { isWatermarkShape } from "./watermarkParser.js";
-import { cloneWithXmlnsDeclarations, elementToXml, findAllDeep, findChild, getAttribute, getChildElements, getLocalName } from "./xmlParser.js";
+import { cloneWithXmlnsDeclarations, findAllDeep, findChild, getAttribute, getChildElements, getLocalName } from "./xmlParser.js";
 //#region src/docx/vmlImageParser.ts
 const VML_POSITION_ABSOLUTE = "absolute";
 const IMAGE_WRAP_INLINE = "inline";
@@ -90,7 +91,7 @@ const previewImage = (pictElement, svg, widthPx, heightPx, style, rootXmlns) =>
 				}
 			}
 		},
-		rawXml: elementToXml(cloneWithXmlnsDeclarations(pictElement, rootXmlns))
+		rawXml: captureVerbatimXml(cloneWithXmlnsDeclarations(pictElement, rootXmlns))
 	};
 };
 const previewDrawing = (pictElement, preview, rootXmlns) => {
@@ -154,7 +155,7 @@ function parseVmlImageContent(pictElement, rels, media, rootXmlns = {}) {
 		return {
 			type: "drawing",
 			image,
-			rawXml: elementToXml(cloneWithXmlnsDeclarations(pictElement, rootXmlns))
+			rawXml: captureVerbatimXml(cloneWithXmlnsDeclarations(pictElement, rootXmlns))
 		};
 	}
 	for (const child of getChildElements(pictElement)) {

package/dist/docx/watermarkParser.d.ts

@@ -14,10 +14,8 @@ type ParsedWatermark = {
   hostingParagraph: XmlElement;
   /**
    * Index where the watermark paragraph sat among block-level siblings
-   * (`w:p` / `w:tbl`) in the source header. After the host paragraph is
-   * filtered out of `content`, the serializer inserts the watermark
-   * back at this index so a header that originally placed the
-   * watermark after visible text rounds-trips with the same flow.
+   * (`w:p` / `w:tbl` / `w:sdt`) in the source header. The serializer uses
+   * this index to replace the retained host paragraph with watermark XML.
    */
   blockIndex: number;
 };

package/dist/docx/watermarkParser.js

@@ -1,4 +1,5 @@
-import { cloneWithXmlnsDeclarations, collectXmlnsDeclarations, elementToXml, findChild, findChildren, findDeep, getAttribute, getLocalName, getTextContent } from "./xmlParser.js";
+import { captureVerbatimXml } from "./verbatimCapture.js";
+import { cloneWithXmlnsDeclarations, collectXmlnsDeclarations, findChild, findChildren, findDeep, getAttribute, getLocalName, getTextContent } from "./xmlParser.js";
 //#region src/docx/watermarkParser.ts
 const VML_TEXT_WATERMARK_SHAPETYPE = "#_x0000_t136";
 /**
@@ -38,7 +39,7 @@ function parseWatermark(header) {
 			const hosting = findEnclosingParagraph(header, shape);
 			if (hosting) return {
 				watermark,
-				rawParagraphXml: elementToXml(cloneWithXmlnsDeclarations(hosting, headerXmlns)),
+				rawParagraphXml: captureVerbatimXml(cloneWithXmlnsDeclarations(hosting, headerXmlns)),
 				hostingParagraph: hosting,
 				blockIndex: blockIndexOf(header, hosting)
 			};
@@ -50,7 +51,7 @@ function parseWatermark(header) {
 			const hosting = findEnclosingParagraph(header, anchor);
 			if (hosting) return {
 				watermark,
-				rawParagraphXml: elementToXml(cloneWithXmlnsDeclarations(hosting, headerXmlns)),
+				rawParagraphXml: captureVerbatimXml(cloneWithXmlnsDeclarations(hosting, headerXmlns)),
 				hostingParagraph: hosting,
 				blockIndex: blockIndexOf(header, hosting)
 			};
@@ -58,11 +59,9 @@ function parseWatermark(header) {
 	}
 }
 /**
-* Index of `target` among block-level children of `header` (only
-* `w:p` and `w:tbl` count as blocks). Since the hosting paragraph
-* is filtered out of `content` after parse, this is the index the
-* serializer needs to splice the watermark XML back into so the
-* header rounds-trips with the same flow as the source.
+* Index of `target` among block-level children of `header`. Keep this list
+* aligned with `parseBlockContent`, which emits paragraphs, tables, and
+* block-level content controls as one content item each.
 */
 function blockIndexOf(header, target) {
 	let blockIdx = 0;
@@ -70,7 +69,7 @@ function blockIndexOf(header, target) {
 		if (child === target) return blockIdx;
 		if (child.type !== "element") continue;
 		const local = getLocalName(child.name ?? "");
-		if (local === "p" || local === "tbl") blockIdx++;
+		if (local === "p" || local === "tbl" || local === "sdt") blockIdx++;
 	}
 	return 0;
 }

package/dist/docx/xmlParser.d.ts

@@ -77,7 +77,18 @@ declare const NAMESPACES: {
  * @param xml - XML string to parse
  * @returns Parsed element tree
  */
-declare function parseXml(xml: string): XmlElement;
+/**
+ * The prefix bindings a WordprocessingML part declares on its root.
+ *
+ * A property element captured out of a document carries no `xmlns` of its
+ * own, so parsing it on its own resolves no prefix and every lookup by
+ * namespace URI misses. Parsing it under this scope puts it back in the
+ * context it was written in. A part that binds `w` to something else — or
+ * binds it to a prefix this map does not know — simply fails to match, and
+ * the caller falls back to whatever it does without the capture.
+ */
+declare const OOXML_NAMESPACE_SCOPE: XmlNamespaceScope;
+declare function parseXml(xml: string, inheritedNamespaceScope?: XmlNamespaceScope): XmlElement;
 /**
  * Serialize an XmlElement back to an XML string
  */
@@ -345,5 +356,15 @@ declare function mergeXmlnsDeclarations(inherited: Record<string, string>, eleme
  * canonical binding so the detached subtree is valid on its first replay.
  */
 declare function cloneWithXmlnsDeclarations(element: XmlElement, xmlnsDecls: Record<string, string>): XmlElement;
+/**
+ * Shallow clone of an element that keeps its resolved namespace metadata.
+ *
+ * `namespaceUri` and `namespaceScope` are non-enumerable so structural
+ * comparisons stay stable, which also means a plain spread drops them and
+ * every namespace-URI lookup on the copy misses. Re-attaching over the
+ * original's scope leaves resolution unchanged whether or not the clone
+ * carries `xmlns` attributes of its own.
+ */
+declare function cloneElement(element: XmlElement, overrides: Partial<XmlElement>): XmlElement;
 //#endregion
-export { NAMESPACES, WORDPROCESSINGML_NAMESPACE_URIS, XmlAttributeMatch, XmlElement, XmlNamespaceScope, attachXmlNamespaceContext, cloneWithXmlnsDeclarations, collectXmlnsDeclarations, elementToXml, findAllDeep, findAttributeByNamespaceUri, findByFullName, findChild, findChildByLocalName, findChildByNamespaceUri, findChildren, findChildrenByLocalName, findDeep, getAttribute, getAttributeAny, getAttributeAnyPrefix, getAttributeByNamespaceUri, getAttributes, getChildElements, getLocalName, getNamespacePrefix, getNamespaceUri, getTextContent, hasChild, hasFlag, matchesName, mergeXmlnsDeclarations, parseBooleanElement, parseColorElement, parseNumberingLevelAttribute, parseNumericAttribute, parseOnOffValue, parseTableMeasurementValue, parseXml, parseXmlDocument };
+export { NAMESPACES, OOXML_NAMESPACE_SCOPE, WORDPROCESSINGML_NAMESPACE_URIS, XmlAttributeMatch, XmlElement, XmlNamespaceScope, attachXmlNamespaceContext, cloneElement, cloneWithXmlnsDeclarations, collectXmlnsDeclarations, elementToXml, findAllDeep, findAttributeByNamespaceUri, findByFullName, findChild, findChildByLocalName, findChildByNamespaceUri, findChildren, findChildrenByLocalName, findDeep, getAttribute, getAttributeAny, getAttributeAnyPrefix, getAttributeByNamespaceUri, getAttributes, getChildElements, getLocalName, getNamespacePrefix, getNamespaceUri, getTextContent, hasChild, hasFlag, matchesName, mergeXmlnsDeclarations, parseBooleanElement, parseColorElement, parseNumberingLevelAttribute, parseNumericAttribute, parseOnOffValue, parseTableMeasurementValue, parseXml, parseXmlDocument };

package/dist/docx/xmlParser.js

@@ -1,3 +1,5 @@
+import { transitionalSlotEncoding } from "./transitionalSpelling.js";
+import { universalMeasureAs } from "./universalMeasure.js";
 import { XMLBuilder, XMLParser } from "fast-xml-parser";
 import { OOXML_NS } from "@stll/docx-utils";
 //#region src/docx/xmlParser.ts
@@ -130,8 +132,8 @@ function fxpNodeToElement(node, inheritedNamespaceScope = EMPTY_NAMESPACE_SCOPE)
 * XmlElement that matches xml-js's non-compact root structure:
 * `{ elements: [...] }`.
 */
-function fxpToRootElement(nodes) {
-	for (let index = 0; index < nodes.length; index += 1) nodes[index] = fxpNodeToElement(nodes[index]);
+function fxpToRootElement(nodes, inheritedNamespaceScope = EMPTY_NAMESPACE_SCOPE) {
+	for (let index = 0; index < nodes.length; index += 1) nodes[index] = fxpNodeToElement(nodes[index], inheritedNamespaceScope);
 	return { elements: nodes };
 }
 /**
@@ -156,8 +158,19 @@ const NAMESPACES = OOXML_NS;
 * @param xml - XML string to parse
 * @returns Parsed element tree
 */
-function parseXml(xml) {
-	return fxpToRootElement((xml.includes("binData") ? fxpParserWithStopNodes : fxpParser).parse(xml));
+/**
+* The prefix bindings a WordprocessingML part declares on its root.
+*
+* A property element captured out of a document carries no `xmlns` of its
+* own, so parsing it on its own resolves no prefix and every lookup by
+* namespace URI misses. Parsing it under this scope puts it back in the
+* context it was written in. A part that binds `w` to something else — or
+* binds it to a prefix this map does not know — simply fails to match, and
+* the caller falls back to whatever it does without the capture.
+*/
+const OOXML_NAMESPACE_SCOPE = { bindings: new Map(Object.entries(OOXML_NS)) };
+function parseXml(xml, inheritedNamespaceScope = EMPTY_NAMESPACE_SCOPE) {
+	return fxpToRootElement((xml.includes("binData") ? fxpParserWithStopNodes : fxpParser).parse(xml), inheritedNamespaceScope);
 }
 /**
 * Serialize an XmlElement back to an XML string
@@ -495,6 +508,9 @@ function parseColorElement(element) {
 function parseNumericAttribute(element, namespace, name, scale = 1) {
 	const value = getAttribute(element, namespace, name);
 	if (value === null) return;
+	const unit = transitionalSlotEncoding(element?.namespaceUri, getLocalName(element?.name), name)?.measure;
+	const measure = unit === void 0 ? void 0 : universalMeasureAs(value, unit);
+	if (measure !== void 0) return measure * scale;
 	const num = Number.parseInt(value, 10);
 	if (Number.isNaN(num)) return;
 	return num * scale;
@@ -523,6 +539,8 @@ function parseTableMeasurementValue(element, widthType) {
 		const pct = Number.parseFloat(trimmed.slice(0, -1));
 		if (!Number.isNaN(pct)) return Math.round(pct * 50);
 	}
+	const measure = universalMeasureAs(trimmed, "twips");
+	if (measure !== void 0) return measure;
 	const num = Number.parseInt(trimmed, 10);
 	return Number.isNaN(num) ? void 0 : num;
 }
@@ -741,14 +759,28 @@ function cloneWithXmlnsDeclarations(element, xmlnsDecls) {
 		if (!prefix || attributes[name] !== void 0 || additions[name] !== void 0 || !isCanonicalNamespacePrefix(prefix)) continue;
 		additions[name] = NAMESPACES[prefix];
 	}
-	for (const _key in additions) return {
+	for (const _key in additions) return cloneElement(element, { attributes: {
+		...attributes,
+		...additions
+	} });
+	return element;
+}
+/**
+* Shallow clone of an element that keeps its resolved namespace metadata.
+*
+* `namespaceUri` and `namespaceScope` are non-enumerable so structural
+* comparisons stay stable, which also means a plain spread drops them and
+* every namespace-URI lookup on the copy misses. Re-attaching over the
+* original's scope leaves resolution unchanged whether or not the clone
+* carries `xmlns` attributes of its own.
+*/
+function cloneElement(element, overrides) {
+	const clone = {
 		...element,
-		attributes: {
-			...attributes,
-			...additions
-		}
+		...overrides
 	};
-	return element;
+	attachXmlNamespaceContext(clone, element.namespaceScope);
+	return clone;
 }
 //#endregion
-export { NAMESPACES, WORDPROCESSINGML_NAMESPACE_URIS, attachXmlNamespaceContext, cloneWithXmlnsDeclarations, collectXmlnsDeclarations, elementToXml, findAllDeep, findAttributeByNamespaceUri, findByFullName, findChild, findChildByLocalName, findChildByNamespaceUri, findChildren, findChildrenByLocalName, findDeep, getAttribute, getAttributeAny, getAttributeAnyPrefix, getAttributeByNamespaceUri, getAttributes, getChildElements, getLocalName, getNamespacePrefix, getNamespaceUri, getTextContent, hasChild, hasFlag, matchesName, mergeXmlnsDeclarations, parseBooleanElement, parseColorElement, parseNumberingLevelAttribute, parseNumericAttribute, parseOnOffValue, parseTableMeasurementValue, parseXml, parseXmlDocument };
+export { NAMESPACES, OOXML_NAMESPACE_SCOPE, WORDPROCESSINGML_NAMESPACE_URIS, attachXmlNamespaceContext, cloneElement, cloneWithXmlnsDeclarations, collectXmlnsDeclarations, elementToXml, findAllDeep, findAttributeByNamespaceUri, findByFullName, findChild, findChildByLocalName, findChildByNamespaceUri, findChildren, findChildrenByLocalName, findDeep, getAttribute, getAttributeAny, getAttributeAnyPrefix, getAttributeByNamespaceUri, getAttributes, getChildElements, getLocalName, getNamespacePrefix, getNamespaceUri, getTextContent, hasChild, hasFlag, matchesName, mergeXmlnsDeclarations, parseBooleanElement, parseColorElement, parseNumberingLevelAttribute, parseNumericAttribute, parseOnOffValue, parseTableMeasurementValue, parseXml, parseXmlDocument };

package/dist/headless-layout.js

@@ -1,3 +1,5 @@
+import { resolveDocumentGridLinePitch } from "./docx/documentGrid.js";
+import { formatOoxmlCounter } from "./docx/ooxmlCounterFormatter.js";
 import { parseDocx } from "./docx/parser.js";
 import { buildHeaderFooterFieldValues } from "./fields/resolveFieldValues.js";
 import { extractEmbeddedFonts } from "./fonts/embeddedFonts.js";
@@ -50,6 +52,11 @@ import { createHash } from "node:crypto";
 * backend in a browser); this module refuses to guess, because a silently
 * wrong provider produces a plausible layout that is wrong everywhere.
 */
+const formatEndnoteTexts = (numbers, formatNumber) => {
+	const texts = /* @__PURE__ */ new Map();
+	for (const [id, displayNumber] of numbers) texts.set(id, formatNumber(displayNumber));
+	return texts;
+};
 var HeadlessLayoutError = class extends TaggedError("HeadlessLayoutError") {};
 /**
 * Stories this entry still does not lay out, keyed by story so the map is total
@@ -93,6 +100,8 @@ const buildFlowOptions = (document, pageContentHeight) => {
 		...settings.consecutiveHyphenLimit === void 0 ? {} : { consecutiveLineLimit: settings.consecutiveHyphenLimit },
 		...settings.hyphenationZoneTwips === void 0 ? {} : { hyphenationZoneTwips: settings.hyphenationZoneTwips }
 	};
+	const finalSectionDocumentGridLinePitchTwips = resolveDocumentGridLinePitch(document.package.document.sections?.at(-1)?.properties.docGrid);
+	if (finalSectionDocumentGridLinePitchTwips !== void 0) options.finalSectionDocumentGridLinePitchTwips = finalSectionDocumentGridLinePitchTwips;
 	return options;
 };
 /**
@@ -237,9 +246,12 @@ const layoutDocxHeadless = async (input, options = {}) => {
 		const footnotes = document.package.footnotes ?? [];
 		const endnotes = document.package.endnotes ?? [];
 		const footnoteRefs = collectFootnoteRefs(authored);
+		const footnoteNumbers = computeNoteDisplayNumbers(footnotes, footnoteRefs.map((ref) => ref.footnoteId));
+		const endnoteNumbers = computeNoteDisplayNumbers(endnotes, collectEndnoteRefs(authored).map((ref) => ref.endnoteId));
+		const endnoteNumberFormat = finalSection?.endnotePr?.numFmt ?? "lowerRoman";
 		const blocks = remapNoteMarkerText(authored, {
-			footnoteNumbers: computeNoteDisplayNumbers(footnotes, footnoteRefs.map((ref) => ref.footnoteId)),
-			endnoteNumbers: computeNoteDisplayNumbers(endnotes, collectEndnoteRefs(authored).map((ref) => ref.endnoteId))
+			footnoteNumbers,
+			endnoteTexts: formatEndnoteTexts(endnoteNumbers, (displayNumber) => formatOoxmlCounter(displayNumber, endnoteNumberFormat))
 		});
 		const measures = measureBlocks(blocks, contentWidth);
 		const footnoteContentById = footnoteRefs.length === 0 ? void 0 : buildFootnoteContentMap(footnotes, footnoteRefs, contentWidth, {

package/dist/index.d.ts

@@ -1,16 +1,16 @@
+import { document_d_exports } from "./types/document.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, 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 { DeriveBlockIdInput, FolioBlockId, currentFolioBlockId, deriveBlockId, getFolioParaIdFromBlockId, isFolioBlockId, isSequentialFolioBlockId } from "./types/block-id.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, FinalParagraphMarkDeletion } from "./compare/verification.js";
+import { COMPARE_VERIFICATION_CAUSES, COMPARE_VERIFICATION_INVARIANTS, CompareVerification, CompareVerificationCause, CompareVerificationFailure, CompareVerificationInvariant, FinalParagraphMarkRevision } from "./compare/verification.js";
 import { COMPARE_UNSUPPORTED_REASONS, CompareChange, CompareChangeLocation, CompareDocxApplyError, CompareDocxError, CompareDocxFinalParagraphMarkError, 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";
@@ -38,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, COMPARE_UNSUPPORTED_REASONS, COMPARE_VERIFICATION_CAUSES, COMPARE_VERIFICATION_INVARIANTS, type CompareChange, type CompareChangeLocation, CompareDocxApplyError, type CompareDocxError, CompareDocxFinalParagraphMarkError, 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 FinalParagraphMarkDeletion, 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 };
+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, CompareDocxFinalParagraphMarkError, 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 FinalParagraphMarkRevision, 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, currentFolioBlockId, 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

@@ -26,9 +26,9 @@ import { clearTemplateSlashMenu, consumeTemplateSlashQuery, getTemplateSlashMenu
 import { extractDocumentStyleSet, extractDocumentStyleSetFromDocx, inspectDocumentStyles, inspectDocumentStylesFromDocx } from "./style-sets/extract.js";
 import { STELLA_STYLE_SET_NAME, createStellaStyleDocumentPreset, createStellaStyleSet } from "./style-sets/stellaStyle.js";
 import { DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION } from "./style-sets/types.js";
-import { deriveBlockId, getFolioParaIdFromBlockId, isFolioBlockId, isSequentialFolioBlockId } from "./types/block-id.js";
+import { currentFolioBlockId, deriveBlockId, getFolioParaIdFromBlockId, isFolioBlockId, isSequentialFolioBlockId } from "./types/block-id.js";
 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 { COMPARE_UNSUPPORTED_REASONS, COMPARE_VERIFICATION_CAUSES, COMPARE_VERIFICATION_INVARIANTS, CompareDocxApplyError, CompareDocxFinalParagraphMarkError, 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 };
+export { COMPARE_UNSUPPORTED_REASONS, COMPARE_VERIFICATION_CAUSES, COMPARE_VERIFICATION_INVARIANTS, CompareDocxApplyError, CompareDocxFinalParagraphMarkError, 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, currentFolioBlockId, 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

@@ -52,8 +52,8 @@ declare function computeNoteDisplayNumbers(notes: readonly NumberableNote[], ref
 type NoteDisplayNumberMaps = {
   /** footnote `w:id` → sequential display number */
   footnoteNumbers?: ReadonlyMap<number, number>;
-  /** endnote `w:id` → sequential display number */
-  endnoteNumbers?: ReadonlyMap<number, number>;
+  /** endnote `w:id` → formatted display text */
+  endnoteTexts?: ReadonlyMap<number, string>;
 };
 /**
  * Rewrite body reference-marker run text from the raw `w:id` (which the PM

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

@@ -80,7 +80,7 @@ function computeNoteDisplayNumbers(notes, refNoteIds) {
 * template preview substitution).
 */
 function remapNoteMarkerText(blocks, maps) {
-	if ((maps.footnoteNumbers?.size ?? 0) === 0 && (maps.endnoteNumbers?.size ?? 0) === 0) return blocks;
+	if ((maps.footnoteNumbers?.size ?? 0) === 0 && (maps.endnoteTexts?.size ?? 0) === 0) return blocks;
 	let changed = false;
 	const next = blocks.map((block) => {
 		const remapped = remapNoteMarkerBlock(block, maps);
@@ -147,17 +147,19 @@ function remapNoteMarkerParagraph(block, maps) {
 }
 function remapNoteMarkerRun(run, maps) {
 	if (run.kind !== "text") return run;
-	const displayNumber = getRunDisplayNumber(run, maps);
-	if (displayNumber === void 0) return run;
-	const text = String(displayNumber);
-	return run.text === text ? run : {
+	const displayText = getRunDisplayText(run, maps);
+	if (displayText === void 0) return run;
+	return run.text === displayText ? run : {
 		...run,
-		text
+		text: displayText
 	};
 }
-function getRunDisplayNumber(run, maps) {
-	if (run.footnoteRefId !== void 0) return maps.footnoteNumbers?.get(run.footnoteRefId);
-	if (run.endnoteRefId !== void 0) return maps.endnoteNumbers?.get(run.endnoteRefId);
+function getRunDisplayText(run, maps) {
+	if (run.footnoteRefId !== void 0) {
+		const displayNumber = maps.footnoteNumbers?.get(run.footnoteRefId);
+		return displayNumber === void 0 ? void 0 : String(displayNumber);
+	}
+	if (run.endnoteRefId !== void 0) return maps.endnoteTexts?.get(run.endnoteRefId);
 }
 /**
 * After layout, determine which footnotes appear on which pages.
@@ -202,7 +204,7 @@ function convertFootnoteToContent(footnote, displayNumber, contentWidth, options
 	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 blocks = applyFootnotePresentation(preserveAuthoredFootnoteTerminalParagraph(toFlowBlocks(pmDoc, flowOptions)), displayNumber);
 	const measures = options.measureBlocks ? options.measureBlocks(blocks, contentWidth) : measureFootnoteBlocks(blocks, contentWidth);
 	let totalHeight = 0;
 	for (const measure of measures) if (measure.kind === "paragraph") totalHeight += measure.totalHeight;
@@ -216,6 +218,17 @@ function convertFootnoteToContent(footnote, displayNumber, contentWidth, options
 		height: totalHeight
 	};
 }
+/** Restore an authored footnote line that the body-only terminal-table policy collapsed. */
+function preserveAuthoredFootnoteTerminalParagraph(blocks) {
+	const finalBlock = blocks.at(-1);
+	if (blocks.at(-2)?.kind !== "table" || finalBlock?.kind !== "paragraph" || finalBlock.attrs?.suppressEmptyParagraphHeight !== true) return blocks;
+	const attrs = { ...finalBlock.attrs };
+	delete attrs.suppressEmptyParagraphHeight;
+	return [...blocks.slice(0, -1), {
+		...finalBlock,
+		attrs
+	}];
+}
 function measureFootnoteBlocks(blocks, contentWidth) {
 	return blocks.map((block) => measureFootnoteBlock(block, contentWidth));
 }

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

@@ -3,6 +3,16 @@ import { headerFooterToProseDoc } from "../../prosemirror/conversion/toProseDoc.
 import { emuToPixels } from "../../utils/units.js";
 import { toFlowBlocks } from "./toFlowBlocks.js";
 //#region src/layout-bridge/convert/headerFooterLayout.ts
+const DETACHED_WATERMARK_HOST = Symbol.for("stll.detachedWatermarkHost");
+const headerFooterToProseDocWithDetachedWatermarkHost = (headerFooter, options) => {
+	return headerFooterToProseDoc(headerFooter.content.map((block, blockIndex) => {
+		if (blockIndex !== headerFooter.watermarkBlockIndex || block.type !== "paragraph") return block;
+		return {
+			...block,
+			[DETACHED_WATERMARK_HOST]: true
+		};
+	}), options);
+};
 function isAnchoredImageRun(run) {
 	if (run.kind !== "image") return false;
 	if (run.position) return true;
@@ -241,7 +251,7 @@ 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 {
+	if (blocks.length > 0 && blocks.every((block) => block.kind === "paragraph" && isPaintlessParagraph(block) && !hasAuthoredVisualContent(block) && block.attrs?.suppressEmptyParagraphHeight !== false && !preservesInheritedSpacing(block))) return {
 		top: 0,
 		bottom: 0
 	};
@@ -330,7 +340,7 @@ function convertHeaderFooterToContent(headerFooter, contentWidth, metrics, optio
 	const proseDocOptions = {};
 	if (options.styles) proseDocOptions.styles = options.styles;
 	if (options.theme !== void 0) proseDocOptions.theme = options.theme;
-	const pmDoc = headerFooterToProseDoc(headerFooter.content, proseDocOptions);
+	const pmDoc = headerFooter.watermarkBlockIndex === void 0 ? headerFooterToProseDoc(headerFooter.content, proseDocOptions) : headerFooterToProseDocWithDetachedWatermarkHost(headerFooter, proseDocOptions);
 	const flowOptions = {};
 	if (options.theme !== void 0) flowOptions.theme = options.theme;
 	if (options.fontAlternates !== void 0) flowOptions.fontAlternates = options.fontAlternates;
@@ -458,6 +468,7 @@ function serializeParagraphAttrs(attrs) {
 	const keys = [
 		"alignment",
 		"bidi",
+		"suppressEmptyParagraphHeight",
 		"indent",
 		"spacing",
 		"styleId",