@stll/folio-core 0.33.1 → 0.33.2

package/dist/docx/tableParser.js

@@ -3,7 +3,8 @@ import { appendBookmarkMarkerToLastParagraphInBlocks, appendBookmarkMarkerToLast
 import { parseParagraph } from "./paragraphParser.js";
 import { enrichParagraphTextBoxes } from "./paragraphTextBoxEnrichment.js";
 import { BorderStyleSchema, FloatingTableXSpecSchema, FloatingTableYSpecSchema, ShadingPatternSchema, TableCellTextDirectionSchema, ThemeColorSlotSchema, narrowEnum } from "./parserEnums.js";
-import { findChild, findChildByLocalName, findChildren, getAttribute, getChildElements, getLocalName, mergeXmlnsDeclarations, parseBooleanElement, parseNumericAttribute, parseTableMeasurementValue } from "./xmlParser.js";
+import { captureVerbatimXml } from "./verbatimCapture.js";
+import { cloneElement, findChild, findChildByLocalName, findChildren, getAttribute, getChildElements, getLocalName, mergeXmlnsDeclarations, parseBooleanElement, parseNumericAttribute, parseTableMeasurementValue } from "./xmlParser.js";
 import { normalizeRevisionId } from "@stll/docx-core/model";
 //#region src/docx/tableParser.ts
 /**
@@ -47,8 +48,22 @@ function parseTrackedChangeInfo(node) {
 	};
 	if (date.length > 0) info.date = date;
 	if (initials.length > 0) info.initials = initials;
+	const utcDate = utcDateAttribute(node);
+	if (utcDate) info.utcDate = utcDate;
 	return info;
 }
+/** `w16du:dateUtc` under whatever prefix the document bound it to. */
+const utcDateAttribute = (node) => {
+	for (const [attribute, value] of Object.entries(node.attributes ?? {})) {
+		if (typeof value !== "string" || getLocalName(attribute) !== "dateUtc") continue;
+		const trimmed = value.trim();
+		if (trimmed.length > 0) return {
+			attribute,
+			value: trimmed
+		};
+	}
+	return null;
+};
 function parsePropertyChangeInfo(node) {
 	const base = parseTrackedChangeInfo(node);
 	const rsid = (getAttribute(node, "w", "rsid") ?? "").trim();
@@ -245,6 +260,31 @@ function parseFloatingTableProperties(tblpPrElement) {
 * @param tblPrElement - The w:tblPr element
 * @returns Parsed table formatting
 */
+/**
+* Children of a property element that record a revision rather than a
+* property. They are parsed into records of their own and written back from
+* those, so the capture leaves them out: a capture that kept them would put a
+* resolved revision back into the document after it was accepted.
+*/
+const REVISION_PROPERTY_CHILDREN = /* @__PURE__ */ new Set([
+	"tblPrChange",
+	"trPrChange",
+	"tcPrChange",
+	"ins",
+	"del",
+	"cellIns",
+	"cellDel",
+	"cellMerge"
+]);
+/**
+* The property element a formatting object was parsed from, kept beside the
+* typed values so a save that did not touch them writes the element back
+* exactly as it arrived.
+*/
+const withSourceXml = (formatting, element) => ({
+	...formatting,
+	sourceXml: captureVerbatimXml(cloneElement(element, { elements: (element.elements ?? []).filter((child) => !REVISION_PROPERTY_CHILDREN.has(getLocalName(child.name))) }))
+});
 function parseTableProperties(tblPrElement) {
 	if (!tblPrElement) return;
 	const formatting = {};
@@ -287,7 +327,7 @@ function parseTableProperties(tblPrElement) {
 	const bidiVisual = findChild(tblPrElement, "w", "bidiVisual");
 	if (bidiVisual) formatting.bidi = parseBooleanElement(bidiVisual);
 	if (Object.keys(formatting).length === 0) return;
-	return formatting;
+	return withSourceXml(formatting, tblPrElement);
 }
 function parseTablePropertyChanges(tblPrElement, currentFormatting) {
 	if (!tblPrElement) return;
@@ -415,7 +455,7 @@ function parseTableRowProperties(trPrElement) {
 	const conditionalFormat = parseConditionalFormatStyle(findChild(trPrElement, "w", "cnfStyle"));
 	if (conditionalFormat) formatting.conditionalFormat = conditionalFormat;
 	if (Object.keys(formatting).length === 0) return;
-	return formatting;
+	return withSourceXml(formatting, trPrElement);
 }
 /**
 * Parse conditional format style (for table style conditional formatting)
@@ -505,12 +545,12 @@ function parseTableCellProperties(tcPrElement) {
 	else formatting.vMerge = "continue";
 	if (parseBooleanElement(findChild(tcPrElement, "w", "tcFitText"))) formatting.fitText = true;
 	if (parseBooleanElement(findChild(tcPrElement, "w", "noWrap"))) formatting.noWrap = true;
-	const hideMark = parseBooleanElement(findChild(tcPrElement, "w", "hideMark"));
-	if (hideMark !== void 0) formatting.hideMark = hideMark;
+	const hideMarkElement = findChild(tcPrElement, "w", "hideMark");
+	if (hideMarkElement) formatting.hideMark = parseBooleanElement(hideMarkElement);
 	const conditionalFormat = parseConditionalFormatStyle(findChild(tcPrElement, "w", "cnfStyle"));
 	if (conditionalFormat) formatting.conditionalFormat = conditionalFormat;
 	if (Object.keys(formatting).length === 0) return;
-	return formatting;
+	return withSourceXml(formatting, tcPrElement);
 }
 /**
 * Accumulate a table container's own `xmlns:*` onto the inherited in-scope set,
@@ -731,8 +771,13 @@ function parseTable(tblElement, styles, theme, numbering, rels, media, options)
 	if (formatting) table.formatting = formatting;
 	const tblPropChanges = parseTablePropertyChanges(tblPrElement, formatting);
 	if (tblPropChanges !== void 0) table.propertyChanges = tblPropChanges;
-	const columnWidths = parseTableGrid(findChild(tblElement, "w", "tblGrid"));
+	const gridElement = findChild(tblElement, "w", "tblGrid");
+	const columnWidths = parseTableGrid(gridElement);
 	if (columnWidths) table.columnWidths = columnWidths;
+	if (gridElement) table.formatting = {
+		...table.formatting,
+		gridSourceXml: captureVerbatimXml(gridElement)
+	};
 	const tableOptions = withContainerXmlns(options, tblElement);
 	const rowsWithGridOffsets = /* @__PURE__ */ new Set();
 	const parseTableChild = (child) => {

package/dist/docx/transitionalSpelling.d.ts

@@ -0,0 +1,23 @@
+import { SlotEncoding } from "./strictValueEncodings.gen.js";
+//#region src/docx/transitionalSpelling.d.ts
+/**
+ * The Transitional URI a Strict one stands for, or the URI unchanged.
+ *
+ * Also used when a rebuilt part falls back to a binding its source declared:
+ * declaring a Strict URI on a Transitional root puts every element under that
+ * prefix back into the wrong vocabulary.
+ */
+declare const toTransitionalNamespaceUri: (uri: string) => string;
+/** True for a namespace ECMA-376 Part 4 republished under `purl.oclc.org`. */
+declare const isStrictNamespaceUri: (uri: string) => boolean;
+/** Namespaces ECMA-376 Part 4 republished; nothing else starts with this. */
+declare const STRICT_URI_PREFIX = "http://purl.oclc.org/ooxml/";
+/**
+ * How one slot's Transitional type spells its value as a number.
+ *
+ * `namespaceUri` is the element's, in either conformance class; the lookup
+ * translates it. Omit `attributeLocalName` for element text content.
+ */
+declare const transitionalSlotEncoding: (namespaceUri: string | undefined, elementLocalName: string, attributeLocalName?: string) => SlotEncoding | undefined;
+//#endregion
+export { STRICT_URI_PREFIX, isStrictNamespaceUri, toTransitionalNamespaceUri, transitionalSlotEncoding };

package/dist/docx/transitionalSpelling.js

@@ -0,0 +1,36 @@
+import { TRANSITIONAL_NAMESPACE_BY_STRICT_URI, TRANSITIONAL_SLOT_ENCODINGS } from "./strictValueEncodings.gen.js";
+//#region src/docx/transitionalSpelling.ts
+/**
+* Reading a Strict-spelled value as the Transitional number it stands for.
+*
+* Two places need it: the verbatim-capture conversion, which rewrites a
+* fragment on its way into a rebuilt part, and the typed projection, which has
+* to reach the same number so the model and the markup do not disagree about a
+* width. Both go through {@link transitionalSlotEncoding} rather than deciding
+* for themselves which attributes carry a unit.
+*/
+/**
+* The Transitional URI a Strict one stands for, or the URI unchanged.
+*
+* Also used when a rebuilt part falls back to a binding its source declared:
+* declaring a Strict URI on a Transitional root puts every element under that
+* prefix back into the wrong vocabulary.
+*/
+const toTransitionalNamespaceUri = (uri) => TRANSITIONAL_NAMESPACE_BY_STRICT_URI.get(uri) ?? uri;
+/** True for a namespace ECMA-376 Part 4 republished under `purl.oclc.org`. */
+const isStrictNamespaceUri = (uri) => TRANSITIONAL_NAMESPACE_BY_STRICT_URI.has(uri);
+/** Namespaces ECMA-376 Part 4 republished; nothing else starts with this. */
+const STRICT_URI_PREFIX = "http://purl.oclc.org/ooxml/";
+/**
+* How one slot's Transitional type spells its value as a number.
+*
+* `namespaceUri` is the element's, in either conformance class; the lookup
+* translates it. Omit `attributeLocalName` for element text content.
+*/
+const transitionalSlotEncoding = (namespaceUri, elementLocalName, attributeLocalName) => {
+	if (namespaceUri === void 0) return;
+	const slot = `${toTransitionalNamespaceUri(namespaceUri)} ${elementLocalName}`;
+	return TRANSITIONAL_SLOT_ENCODINGS.get(attributeLocalName === void 0 ? slot : `${slot} @${attributeLocalName}`);
+};
+//#endregion
+export { STRICT_URI_PREFIX, isStrictNamespaceUri, toTransitionalNamespaceUri, transitionalSlotEncoding };

package/dist/docx/universalMeasure.d.ts

@@ -0,0 +1,20 @@
+//#region src/docx/universalMeasure.d.ts
+/**
+ * ECMA-376's unit-carrying length, and the numbers Transitional counts it in.
+ *
+ * `ST_UniversalMeasure` spells a length as a decimal with its unit attached
+ * (`155.85pt`, `2.54cm`). Strict producers write it wherever the type allows;
+ * Transitional attributes are read as plain numbers in a fixed unit, so both
+ * the verbatim-capture conversion and the typed projection have to agree on
+ * what one of those strings is worth. They share this module so they cannot.
+ */
+/** The unit a Transitional attribute's number is counted in. */
+type MeasureUnit = "emu" | "halfPoints" | "hundredthPoints" | "twips";
+/** Round half away from zero, so a negative offset keeps a positive one's magnitude. */
+declare const roundHalfAwayFromZero: (value: number) => number;
+/** The value of a universal measure in points, or `undefined` if it is not one. */
+declare const universalMeasureInPoints: (value: string) => number | undefined;
+/** A universal measure as the whole number a Transitional attribute of `unit` holds. */
+declare const universalMeasureAs: (value: string, unit: MeasureUnit) => number | undefined;
+//#endregion
+export { MeasureUnit, roundHalfAwayFromZero, universalMeasureAs, universalMeasureInPoints };

package/dist/docx/universalMeasure.js

@@ -0,0 +1,32 @@
+//#region src/docx/universalMeasure.ts
+/** `-?123.45pt`: the one shape ECMA-376 gives a length that carries its unit. */
+const UNIVERSAL_MEASURE = /^(-?[0-9]+(?:\.[0-9]+)?)(mm|cm|in|pt|pc|pi)$/u;
+const POINTS_PER_UNIT = {
+	cm: 72 / 2.54,
+	in: 72,
+	mm: 72 / 25.4,
+	pc: 12,
+	pi: 12,
+	pt: 1
+};
+const NUMBERS_PER_POINT = {
+	emu: 12700,
+	halfPoints: 2,
+	hundredthPoints: 100,
+	twips: 20
+};
+/** Round half away from zero, so a negative offset keeps a positive one's magnitude. */
+const roundHalfAwayFromZero = (value) => value < 0 ? -Math.round(-value) : Math.round(value);
+/** The value of a universal measure in points, or `undefined` if it is not one. */
+const universalMeasureInPoints = (value) => {
+	const match = UNIVERSAL_MEASURE.exec(value);
+	if (match === null) return;
+	return Number(match[1]) * POINTS_PER_UNIT[match[2]];
+};
+/** A universal measure as the whole number a Transitional attribute of `unit` holds. */
+const universalMeasureAs = (value, unit) => {
+	const points = universalMeasureInPoints(value);
+	return points === void 0 ? void 0 : roundHalfAwayFromZero(points * NUMBERS_PER_POINT[unit]);
+};
+//#endregion
+export { roundHalfAwayFromZero, universalMeasureAs, universalMeasureInPoints };

package/dist/docx/verbatimCapture.d.ts

@@ -0,0 +1,20 @@
+import { XmlElement } from "./xmlParser.js";
+//#region src/docx/verbatimCapture.d.ts
+declare const UntranslatableStrictNamespaceError_base: import("better-result").TaggedErrorClass<"UntranslatableStrictNamespaceError">;
+/** A Strict fragment uses a namespace that has no Transitional counterpart. */
+declare class UntranslatableStrictNamespaceError extends UntranslatableStrictNamespaceError_base<{
+  message: string;
+  uri: string;
+}> {}
+/**
+ * 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.
+ */
+declare const captureVerbatimXml: (element: XmlElement) => string;
+//#endregion
+export { UntranslatableStrictNamespaceError, captureVerbatimXml };

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.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)
 			};

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/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 };