@stll/folio-core 0.4.0 → 0.5.0

package/dist/docx/footnoteParser.js

@@ -205,32 +205,6 @@ function isSeparatorEndnote(endnote) {
 	return endnote.noteType === "separator" || endnote.noteType === "continuationSeparator" || endnote.noteType === "continuationNotice";
 }
 /**
-* Get footnote number for display (excluding separators)
-* @param footnote - The footnote to get the number for
-* @param footnoteMap - The footnote map
-* @param startNumber - Starting number (default 1)
-* @returns The display number, or null for separator footnotes
-*/
-function getFootnoteDisplayNumber(footnote, footnoteMap, startNumber = 1) {
-	if (isSeparatorFootnote(footnote)) return null;
-	const index = footnoteMap.getNormalFootnotes().findIndex((fn) => fn.id === footnote.id);
-	if (index === -1) return null;
-	return startNumber + index;
-}
-/**
-* Get endnote number for display (excluding separators)
-* @param endnote - The endnote to get the number for
-* @param endnoteMap - The endnote map
-* @param startNumber - Starting number (default 1)
-* @returns The display number, or null for separator endnotes
-*/
-function getEndnoteDisplayNumber(endnote, endnoteMap, startNumber = 1) {
-	if (isSeparatorEndnote(endnote)) return null;
-	const index = endnoteMap.getNormalEndnotes().findIndex((en) => en.id === endnote.id);
-	if (index === -1) return null;
-	return startNumber + index;
-}
-/**
 * Create an empty footnote map
 */
 function createEmptyFootnoteMap() {
@@ -267,4 +241,4 @@ function mergeEndnoteMaps(...maps) {
 	return createEndnoteMap(byId, endnotes);
 }
 //#endregion
-export { createEmptyEndnoteMap, createEmptyFootnoteMap, getEndnoteDisplayNumber, getEndnoteText, getFootnoteDisplayNumber, getFootnoteText, isSeparatorEndnote, isSeparatorFootnote, mergeEndnoteMaps, mergeFootnoteMaps, parseEndnoteProperties, parseEndnotes, parseFootnoteProperties, parseFootnotes };
+export { createEmptyEndnoteMap, createEmptyFootnoteMap, getEndnoteText, getFootnoteText, isSeparatorEndnote, isSeparatorFootnote, mergeEndnoteMaps, mergeFootnoteMaps, parseEndnoteProperties, parseEndnotes, parseFootnoteProperties, parseFootnotes };

package/dist/docx/groupDrawingParser.d.ts

@@ -0,0 +1,8 @@
+import { document_d_exports } from "../types/document.js";
+import { XmlElement } from "./xmlParser.js";
+
+//#region src/docx/groupDrawingParser.d.ts
+/** Parse a WordprocessingGroup drawing into a safe SVG-backed image preview. */
+declare const parseGroupDrawing: (drawing: XmlElement) => document_d_exports.Image | null;
+//#endregion
+export { parseGroupDrawing };

package/dist/docx/groupDrawingParser.js

@@ -0,0 +1,131 @@
+import { findAllDeep, findChildByLocalName, findChildrenByLocalName, getAttribute, getLocalName, getTextContent, parseNumericAttribute } from "./xmlParser.js";
+import { emuToPixels } from "../utils/units.js";
+import { parseImage } from "./imageParser.js";
+//#region src/docx/groupDrawingParser.ts
+const HEX_COLOR = /^[0-9A-Fa-f]{6}$/u;
+const DEFAULT_TEXT_COLOR = "000000";
+const DEFAULT_FONT_HALF_POINTS = 22;
+const DEFAULT_LINE_WIDTH_EMU = 9525;
+const HALF_POINT_TO_EMU = 6350;
+const MAX_GROUP_SHAPES = 256;
+const MAX_PATH_COMMANDS = 1e4;
+const MAX_TEXT_CHARACTERS = 2e4;
+const MAX_SVG_CHARACTERS = 1e6;
+const escapeXml = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;").replaceAll("'", "&apos;");
+const numericAttr = (element, name) => {
+	const direct = parseNumericAttribute(element, null, name);
+	if (direct !== void 0) return direct;
+	const wordValue = getAttribute(element, "w", name);
+	if (!wordValue) return 0;
+	const parsed = Number.parseInt(wordValue, 10);
+	return Number.isNaN(parsed) ? 0 : parsed;
+};
+const childTransform = (wsp) => {
+	const xfrm = findChildByLocalName(findChildByLocalName(wsp, "spPr"), "xfrm");
+	const off = findChildByLocalName(xfrm, "off");
+	const ext = findChildByLocalName(xfrm, "ext");
+	return {
+		x: numericAttr(off, "x"),
+		y: numericAttr(off, "y"),
+		width: numericAttr(ext, "cx"),
+		height: numericAttr(ext, "cy")
+	};
+};
+const colorFrom = (parent, fallback) => {
+	if (parent && getLocalName(parent.name ?? "") === "color") {
+		const value = getAttribute(parent, "w", "val");
+		if (value && HEX_COLOR.test(value)) return value.toUpperCase();
+	}
+	const value = getAttribute(findChildByLocalName(findChildByLocalName(parent, "solidFill"), "srgbClr"), null, "val");
+	if (value && HEX_COLOR.test(value)) return value.toUpperCase();
+	return fallback;
+};
+const wrapLine = (line, maxCharacters) => {
+	const words = line.trim().split(/\s+/u);
+	const lines = [];
+	let current = "";
+	for (const word of words) {
+		const candidate = current ? `${current} ${word}` : word;
+		if (current && candidate.length > maxCharacters) {
+			lines.push(current);
+			current = word;
+		} else current = candidate;
+	}
+	if (current) lines.push(current);
+	return lines;
+};
+const pathData = (path) => {
+	const commands = [];
+	for (const command of path.elements ?? []) {
+		if (commands.length >= MAX_PATH_COMMANDS) break;
+		if (command.type !== "element") continue;
+		const point = findChildByLocalName(command, "pt");
+		const x = numericAttr(point, "x");
+		const y = numericAttr(point, "y");
+		const name = command.name?.split(":").at(-1);
+		if (name === "moveTo") commands.push(`M ${x} ${y}`);
+		else if (name === "lnTo") commands.push(`L ${x} ${y}`);
+		else if (name === "quadBezTo") {
+			const points = findChildrenByLocalName(command, "pt");
+			if (points.length >= 2) commands.push(`Q ${numericAttr(points[0] ?? null, "x")} ${numericAttr(points[0] ?? null, "y")} ${numericAttr(points[1] ?? null, "x")} ${numericAttr(points[1] ?? null, "y")}`);
+		} else if (name === "cubicBezTo") {
+			const points = findChildrenByLocalName(command, "pt");
+			if (points.length >= 3) commands.push(`C ${numericAttr(points[0] ?? null, "x")} ${numericAttr(points[0] ?? null, "y")} ${numericAttr(points[1] ?? null, "x")} ${numericAttr(points[1] ?? null, "y")} ${numericAttr(points[2] ?? null, "x")} ${numericAttr(points[2] ?? null, "y")}`);
+		} else if (name === "close") commands.push("Z");
+	}
+	return commands.join(" ");
+};
+const renderGeometry = (wsp) => {
+	const { x, y, width, height } = childTransform(wsp);
+	if (width <= 0 || height <= 0) return "";
+	const spPr = findChildByLocalName(wsp, "spPr");
+	const fill = colorFrom(spPr, "none");
+	const line = findChildByLocalName(spPr, "ln");
+	const stroke = colorFrom(line, "none");
+	const strokeWidth = line ? parseNumericAttribute(line, null, "w") ?? DEFAULT_LINE_WIDTH_EMU : 0;
+	const paths = findAllDeep(findChildByLocalName(spPr, "custGeom"), "a", "path");
+	if (paths.length === 0) return `<rect x="${x}" y="${y}" width="${width}" height="${height}" fill="${fill === "none" ? "none" : `#${fill}`}" stroke="${stroke === "none" ? "none" : `#${stroke}`}" stroke-width="${strokeWidth}"/>`;
+	return paths.map((path) => {
+		const viewWidth = numericAttr(path, "w") || width;
+		const viewHeight = numericAttr(path, "h") || height;
+		const d = pathData(path);
+		if (!d) return "";
+		return `<path d="${d}" transform="translate(${x} ${y}) scale(${width / viewWidth} ${height / viewHeight})" fill="${fill === "none" ? "none" : `#${fill}`}" stroke="${stroke === "none" ? "none" : `#${stroke}`}" stroke-width="${strokeWidth}"/>`;
+	}).join("");
+};
+const renderTextBox = (wsp) => {
+	const { x, y, width, height } = childTransform(wsp);
+	if (width <= 0 || height <= 0) return "";
+	const paragraphs = findAllDeep(wsp, "w", "p");
+	const firstSize = findAllDeep(wsp, "w", "sz").at(0);
+	const halfPoints = numericAttr(firstSize ?? null, "val") || DEFAULT_FONT_HALF_POINTS;
+	const color = colorFrom(findAllDeep(wsp, "w", "color").at(0) ?? null, DEFAULT_TEXT_COLOR);
+	const fontSize = halfPoints * HALF_POINT_TO_EMU;
+	const maxCharacters = Math.max(1, Math.floor(width / (fontSize * .38)));
+	const lines = paragraphs.flatMap((paragraph) => wrapLine(getTextContent(paragraph).slice(0, MAX_TEXT_CHARACTERS), maxCharacters)).map(escapeXml);
+	if (lines.length === 0) return "";
+	const lineHeight = fontSize * 1.15;
+	const svgFontSize = 1e3;
+	const scale = fontSize / svgFontSize;
+	const lineStep = lineHeight / fontSize * svgFontSize;
+	return `<text x="0" y="${svgFontSize}" transform="translate(${x} ${y}) scale(${scale})" font-family="Arial, sans-serif" font-size="${svgFontSize}" fill="#${color}">${lines.map((line, index) => `<tspan x="0" dy="${index === 0 ? 0 : lineStep}">${line}</tspan>`).join("")}</text>`;
+};
+const createSvg = (group, width, height) => {
+	const content = findChildrenByLocalName(group, "wsp").slice(0, MAX_GROUP_SHAPES).map((wsp) => findChildByLocalName(wsp, "txbx") ? renderTextBox(wsp) : renderGeometry(wsp)).join("");
+	return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${width} ${height}" width="${emuToPixels(width)}" height="${emuToPixels(height)}">${content}</svg>`;
+};
+/** Parse a WordprocessingGroup drawing into a safe SVG-backed image preview. */
+const parseGroupDrawing = (drawing) => {
+	const group = findChildByLocalName(findAllDeep(drawing, "a", "graphicData").at(0) ?? null, "wgp");
+	if (!group) return null;
+	const image = parseImage(drawing, void 0, void 0);
+	if (!image || image.size.width <= 0 || image.size.height <= 0) return null;
+	const svg = createSvg(group, image.size.width, image.size.height);
+	if (svg.length > MAX_SVG_CHARACTERS) return null;
+	image.src = `data:image/svg+xml;charset=utf-8,${encodeURIComponent(svg)}`;
+	image.mimeType = "image/svg+xml";
+	image.filename = "wordprocessing-group.svg";
+	return image;
+};
+//#endregion
+export { parseGroupDrawing };

package/dist/docx/numberingParser.d.ts

@@ -39,7 +39,9 @@ declare function createNumberingMap(definitions: document_d_exports.NumberingDef
 declare function computeListRendering(numPr: {
   numId?: number;
   ilvl?: number;
-}, numbering: NumberingMap): document_d_exports.ListRendering | null;
+}, numbering: NumberingMap): (document_d_exports.ListRendering & {
+  levelStarts: number[];
+}) | null;
 /**
  * Format a number according to the specified format
  *

package/dist/docx/numberingParser.js

@@ -581,7 +581,12 @@ function computeListRendering(numPr, numbering) {
 	const level = numbering.getLevel(numId, ilvl);
 	if (!level) return null;
 	const levelNumFmts = [];
-	for (let i = 0; i <= ilvl; i += 1) levelNumFmts.push(level.isLgl ? "decimal" : numbering.getLevel(numId, i)?.numFmt ?? "decimal");
+	const levelStarts = [];
+	for (let i = 0; i <= ilvl; i += 1) {
+		const listLevel = numbering.getLevel(numId, i);
+		levelNumFmts.push(level.isLgl ? "decimal" : listLevel?.numFmt ?? "decimal");
+		levelStarts.push(listLevel?.start ?? 1);
+	}
 	const instance = numbering.getInstance(numId);
 	const overrideForLevel = instance?.levelOverrides?.find((override) => override.ilvl === ilvl);
 	const rendering = {
@@ -590,7 +595,8 @@ function computeListRendering(numPr, numbering) {
 		marker: level.lvlText,
 		isBullet: level.numFmt === "bullet",
 		numFmt: level.isLgl ? "decimal" : level.numFmt,
-		levelNumFmts
+		levelNumFmts,
+		levelStarts
 	};
 	if (level.isLgl) rendering.isLegal = true;
 	if (level.rPr?.hidden) rendering.markerHidden = true;

package/dist/docx/paragraphParser.js

@@ -436,7 +436,7 @@ function paragraphStartsWithRenderedPageBreak(node) {
 		return "continue";
 	};
 	const outcome = visit(node);
-	if (outcome === "forced") return true;
+	if (outcome === "forced") return sawRenderedPageBreak;
 	return outcome === "visible" && sawRenderedPageBreak;
 }
 function replaceLocalName(name, localName) {
@@ -949,13 +949,19 @@ function parseParagraph(node, styles, theme, numbering, rels = null, media = nul
 			const level = numbering.getLevel(numId, ilvl);
 			if (level) {
 				const levelNumFmts = [];
-				for (let levelIndex = 0; levelIndex <= ilvl; levelIndex += 1) levelNumFmts.push(level.isLgl ? "decimal" : numbering.getLevel(numId, levelIndex)?.numFmt ?? "decimal");
+				const levelStarts = [];
+				for (let levelIndex = 0; levelIndex <= ilvl; levelIndex += 1) {
+					const listLevel = numbering.getLevel(numId, levelIndex);
+					levelNumFmts.push(level.isLgl ? "decimal" : listLevel?.numFmt ?? "decimal");
+					levelStarts.push(listLevel?.start ?? 1);
+				}
 				const listRendering = {
 					level: ilvl,
 					numId,
 					marker: level.lvlText,
 					isBullet: level.numFmt === "bullet",
-					levelNumFmts
+					levelNumFmts,
+					levelStarts
 				};
 				const instance = numbering.getInstance(numId);
 				const overrideForLevel = instance?.levelOverrides?.find((override) => override.ilvl === ilvl);

package/dist/docx/runParser.js

@@ -1,6 +1,7 @@
 import { cloneWithXmlnsDeclarations, elementToXml, findChild, findChildren, getAttribute, getChildElements, getTextContent, mergeXmlnsDeclarations, parseBooleanElement, parseNumericAttribute } from "./xmlParser.js";
 import { EmphasisMarkSchema, FontThemeSchema, HighlightColorSchema, ShadingPatternSchema, TextEffectSchema, ThemeColorSlotSchema, UnderlineStyleSchema, narrowEnum } from "./parserEnums.js";
 import { parseImage } from "./imageParser.js";
+import { parseGroupDrawing } from "./groupDrawingParser.js";
 import { parseShapeFromDrawing, shouldPreserveRawShapeDrawing } from "./shapeParser.js";
 import { parseVmlImageContent } from "./vmlImageParser.js";
 import { resolveThemeFontRef } from "./themeParser.js";
@@ -442,6 +443,12 @@ function parseInstrText(element) {
 *   `shapeParser.parseShapeFromDrawing` into a `ShapeContent`.
 */
 function parseDrawingContent(element, rels, media) {
+	const groupImage = parseGroupDrawing(element);
+	if (groupImage) return {
+		type: "drawing",
+		image: groupImage,
+		rawXml: elementToXml(element)
+	};
 	if (shouldPreserveRawShapeDrawing(element)) return {
 		type: "drawing",
 		image: {
@@ -550,7 +557,7 @@ function parseRunContents(runElement, rels, media, rootXmlns = {}) {
 				if (innerName === "drawing") {
 					const innerDrawing = parseDrawingContent(innerChild, rels, media);
 					if (innerDrawing) {
-						if (innerDrawing.type === "drawing" && !innerDrawing.image.src) innerDrawing.rawXml = elementToXml(child);
+						if (innerDrawing.type === "drawing" && (innerDrawing.rawXml !== void 0 || !innerDrawing.image.src)) innerDrawing.rawXml = elementToXml(child);
 						contents.push(innerDrawing);
 					}
 				} else if (innerName === "pict") {

package/dist/docx/selectiveXmlPatch.js

@@ -50,11 +50,8 @@ function findParagraphOffsets(xml, paraId) {
 						start,
 						end: tagEnd + 1
 					};
-					pos = tagEnd + 1;
-				} else {
-					depth++;
-					pos = tagEnd + 1;
-				}
+				} else depth++;
+				pos = tagEnd + 1;
 			} else pos = tagStart + 1;
 		} else if (xml.startsWith("</w:p>", tagStart)) {
 			depth--;
@@ -226,11 +223,8 @@ function scanElementRange(xml, start, openLiteral, closeTag) {
 					start,
 					end: tagEnd + 1
 				};
-				pos = tagEnd + 1;
-			} else {
-				depth++;
-				pos = tagEnd + 1;
-			}
+			} else depth++;
+			pos = tagEnd + 1;
 		} else if (xml.startsWith(closeTag, tagStart)) {
 			depth--;
 			if (depth === 0) return {

package/dist/docx/serializer/numberingSerializer.js

@@ -87,7 +87,9 @@ function serializeNum(instance) {
 * change detection and per-definition splicing, never to overwrite the part.
 */
 function serializeNumberingXml(numbering) {
-	return `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\n<w:numbering xmlns:w="${W_NS}">${numbering.abstractNums.map(serializeAbstractNum).join("")}${numbering.nums.map(serializeNum).join("")}</w:numbering>`;
+	const abstractNums = numbering.abstractNums.map(serializeAbstractNum).join("");
+	const nums = numbering.nums.map(serializeNum).join("");
+	return `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\n<w:numbering xmlns:w="${W_NS}">${abstractNums}${nums}</w:numbering>`;
 }
 //#endregion
 export { serializeNumberingXml };

package/dist/docx/settingsParser.d.ts

@@ -1,8 +1,11 @@
 import { document_d_exports } from "../types/document.js";
 
 //#region src/docx/settingsParser.d.ts
+type FolioDocumentSettings = document_d_exports.DocumentSettings & {
+  /** Swap left/right section margins on even physical pages. */mirrorMargins?: boolean;
+};
 /** OOXML default per §17.6.13 when `w:defaultTabStop` is absent. */
 declare const DEFAULT_TAB_STOP_TWIPS = 720;
-declare function parseSettings(xml: string | null): document_d_exports.DocumentSettings;
-type DocumentSettings = document_d_exports.DocumentSettings;
-export { DEFAULT_TAB_STOP_TWIPS, type DocumentSettings, parseSettings };
+declare function parseSettings(xml: string | null): FolioDocumentSettings;
+//#endregion
+export { DEFAULT_TAB_STOP_TWIPS, FolioDocumentSettings, parseSettings };

package/dist/docx/settingsParser.js

@@ -13,6 +13,8 @@ function parseSettings(xml) {
 	const settings = { defaultTabStop: parseDefaultTabStop(root) };
 	const evenAndOddHeaders = root ? findChild(root, "w", "evenAndOddHeaders") : null;
 	if (evenAndOddHeaders && parseBooleanElement(evenAndOddHeaders)) settings.evenAndOddHeaders = true;
+	const mirrorMargins = root ? findChild(root, "w", "mirrorMargins") : null;
+	if (mirrorMargins && parseBooleanElement(mirrorMargins)) settings.mirrorMargins = true;
 	const themeFontLangEl = root ? findChild(root, "w", "themeFontLang") : null;
 	const eastAsiaLang = themeFontLangEl ? getAttribute(themeFontLangEl, "w", "eastAsia") || void 0 : void 0;
 	const bidiLang = themeFontLangEl ? getAttribute(themeFontLangEl, "w", "bidi") || void 0 : void 0;

package/dist/docx/xmlParser.js

@@ -31,6 +31,7 @@ const fxpParserOptions = {
 	parseAttributeValue: false,
 	ignoreDeclaration: true,
 	ignorePiTags: true,
+	jPath: false,
 	processEntities: true,
 	htmlEntities: true
 };
@@ -65,15 +66,19 @@ function fxpNodeToElement(node) {
 		text: node[TEXT_KEY]
 	};
 	const attrs = node[ATTR_KEY];
-	for (const key of Object.keys(node)) {
+	for (const key in node) {
 		if (key === ATTR_KEY) continue;
 		const children = node[key];
 		const element = {
 			type: "element",
 			name: key
 		};
-		if (attrs && Object.keys(attrs).length > 0) element.attributes = attrs;
-		if (children.length > 0) element.elements = children.map(fxpNodeToElement);
+		if (attrs) element.attributes = attrs;
+		if (children.length > 0) {
+			const elements = [];
+			for (const child of children) elements.push(fxpNodeToElement(child));
+			element.elements = elements;
+		}
 		return element;
 	}
 	return { type: "element" };
@@ -84,7 +89,9 @@ function fxpNodeToElement(node) {
 * `{ elements: [...] }`.
 */
 function fxpToRootElement(nodes) {
-	return { elements: nodes.map(fxpNodeToElement) };
+	const elements = [];
+	for (const node of nodes) elements.push(fxpNodeToElement(node));
+	return { elements };
 }
 /**
 * Convert an XmlElement back into the fast-xml-parser preserveOrder format

package/dist/index.d.ts

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

package/dist/index.js

@@ -1,13 +1,14 @@
+import { deriveBlockId, getFolioParaIdFromBlockId, isFolioBlockId, isSequentialFolioBlockId } from "./types/block-id.js";
+import { createFolioAIEditSnapshot, hashFolioAIBlockText, normalizeFolioAIBlockText } from "./ai-edits/snapshot.js";
+import { diffWordSegments } from "./ai-edits/word-diff.js";
+import { applyFolioAIEditOperations } from "./ai-edits/apply.js";
+import { FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch } from "./document-operations.js";
 import { createEmptyDocument } from "./utils/createDocument.js";
 import { createDocx } from "./docx/rezip.js";
-import { deriveBlockId, getFolioParaIdFromBlockId, isFolioBlockId, isSequentialFolioBlockId } from "./types/block-id.js";
 import { DEFAULT_AI_SUGGESTION_PRESETS } from "./ai-suggestions/types.js";
 import { buildPositionalText } from "./ai-suggestions/text-positions.js";
 import { isSuggestionStale, resolveSuggestionAnchor } from "./ai-suggestions/conflict.js";
 import { applySuggestions } from "./ai-suggestions/apply.js";
-import { createFolioAIEditSnapshot, hashFolioAIBlockText, normalizeFolioAIBlockText } from "./ai-edits/snapshot.js";
-import { diffWordSegments } from "./ai-edits/word-diff.js";
-import { applyFolioAIEditOperations } from "./ai-edits/apply.js";
 import { setAISuggestionsMeta, setFocusedSuggestionMeta } from "./prosemirror/plugins/aiSuggestionDecorations.js";
 import { getGoogleFontsEnabled, setGoogleFontsEnabled } from "./utils/fontResolver.js";
 import { scrollFolioPositionIntoView } from "./paged-layout/scrollToPmPosition.js";
@@ -21,4 +22,4 @@ 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, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applySuggestions, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, deriveBlockId, diffWordSegments, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, isFolioBlockId, isSequentialFolioBlockId, isSuggestionStale, normalizeFolioAIBlockText, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };
+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 };

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

@@ -23,6 +23,42 @@ declare function collectFootnoteRefs(blocks: FlowBlock[]): {
   footnoteId: number;
   pmPos: number;
 }[];
+/**
+ * Scan FlowBlocks for runs with endnoteRefId set, in document order.
+ * Same recursive walk as `collectFootnoteRefs`.
+ */
+declare function collectEndnoteRefs(blocks: FlowBlock[]): {
+  endnoteId: number;
+  pmPos: number;
+}[];
+type NumberableNote = {
+  id: number;
+  noteType?: document_d_exports.Footnote["noteType"];
+};
+/**
+ * Assign sequential display numbers (1, 2, 3, …) to notes in order of first
+ * reference. Word numbers footnotes/endnotes by reference order, not by their
+ * `w:id` values, which may be non-contiguous or out of document order. Only
+ * `normal` notes are numbered; separator/continuation notes and refs to
+ * missing notes consume no number.
+ */
+declare function computeNoteDisplayNumbers(notes: readonly NumberableNote[], refNoteIds: readonly number[]): Map<number, number>;
+type NoteDisplayNumberMaps = {
+  /** footnote `w:id` → sequential display number */footnoteNumbers?: ReadonlyMap<number, number>; /** endnote `w:id` → sequential display number */
+  endnoteNumbers?: ReadonlyMap<number, number>;
+};
+/**
+ * Rewrite body reference-marker run text from the raw `w:id` (which the PM
+ * doc stores as the marker text; the save path serializes from the mark
+ * attrs, never from this text) to the sequential display number, so the
+ * inline marker matches the number rendered in the note area. Must run
+ * before measurement so marker widths match the painted digits. Untouched
+ * blocks/runs are returned by reference so the painter's fingerprinting and
+ * the incremental measure path see them unchanged. Runs keep their PM range,
+ * so click-to-position still resolves into the marker (same contract as the
+ * template preview substitution).
+ */
+declare function remapNoteMarkerText(blocks: FlowBlock[], maps: NoteDisplayNumberMaps): FlowBlock[];
 /**
  * After layout, determine which footnotes appear on which pages.
  * Checks each page's fragments to see if any footnoteRef PM positions fall within.
@@ -54,4 +90,4 @@ declare function calculateFootnoteReservedHeights(pageFootnoteMap: Map<number, n
   height: number;
 }>): Map<number, number>;
 //#endregion
-export { ConvertFootnoteOptions, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, MeasureBlocksFn, applyFootnotePresentation, buildFootnoteContentMap, calculateFootnoteReservedHeights, collectFootnoteRefs, convertFootnoteToContent, mapFootnotesToPages };
+export { ConvertFootnoteOptions, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, MeasureBlocksFn, NoteDisplayNumberMaps, applyFootnotePresentation, buildFootnoteContentMap, calculateFootnoteReservedHeights, collectEndnoteRefs, collectFootnoteRefs, computeNoteDisplayNumbers, convertFootnoteToContent, mapFootnotesToPages, remapNoteMarkerText };