@stll/folio-core 0.47.7 → 0.49.0

package/dist/docx/paragraphParser.js

@@ -1,10 +1,10 @@
 import { isValidHexId } from "../utils/hexId.js";
 import { attributeRemainder } from "./attributeRemainder.js";
 import { parseBookmarkEnd as parseBookmarkEnd$1, parseBookmarkStart as parseBookmarkStart$1 } from "./bookmarkParser.js";
-import { CAPTURE, dispatchChildren, ownedElsewhere, transitionalNamespaceOf, withPreservedChildren } from "./containerChildren.js";
+import { CAPTURE, dispatchChildrenWithContext, ownedElsewhere, transitionalNamespaceOf, withPreservedChildren } from "./containerChildren.js";
 import { parseFieldType } from "./fieldParser.js";
 import { fieldStateOf, parseFieldState } from "./fieldState.js";
-import { hyperlinkChildHandlers, parseHyperlink as parseHyperlink$1 } from "./hyperlinkParser.js";
+import { HYPERLINK_CHILD_HANDLERS, parseHyperlink as parseHyperlink$1, parseHyperlinkShell } from "./hyperlinkParser.js";
 import { isHyperlinkContent, isInlineSdtContent, isTrackedChangeWrapperChild } from "./inlineWrapperContent.js";
 import { inlineWrapperOf } from "./inlineWrapperParser.js";
 import { parseMarkupRangeMarker, parseMoveBookmarkMarker } from "./markupRangeMarker.js";
@@ -15,6 +15,7 @@ import { paraIdInRange } from "./paraIdRangeNormalization.js";
 import { parseParagraphProperties } from "./paragraphProperties.js";
 import { assignParagraphPropertySource } from "./paragraphPropertySource.js";
 import { preserveInlineChild, preserveRunChild, preservedInlineCapture } from "./preservedRunContent.js";
+import { standalonePreviewLedger } from "./previewBudget.js";
 import { consolidateParagraphContent } from "./runConsolidator.js";
 import { parseRun } from "./runParser.js";
 import { runHoldsPayload } from "./runPayload.js";
@@ -303,8 +304,8 @@ function pushInlineSdtSegments({ contents, properties, parsedContent }) {
 *
 * Delegates to hyperlinkParser module which resolves URLs via relationships.
 */
-function parseHyperlink(node, rels, styles, theme, media, rootXmlns = {}) {
-	return parseHyperlink$1(node, rels, styles, theme, media, rootXmlns);
+function parseHyperlink(node, rels, styles, theme, media, rootXmlns, previews) {
+	return parseHyperlink$1(node, rels, styles, theme, media, rootXmlns, previews);
 }
 /**
 * The four `CT_RunTrackChange` wrappers a `w:hyperlink` may hold.
@@ -342,6 +343,39 @@ const mathContentOf = (child) => {
 	if (plainText) equation.plainText = plainText;
 	return equation;
 };
+const hoistRevision = (wrapper) => (child, { styles, theme, rels, media, previews, inScopeXmlns, items, linkOver }) => {
+	const wrapped = parseParagraphContents(child, styles, theme, null, rels, media, previews, wrapper === "deletion" || wrapper === "moveFrom" ? "deletion" : "default", inScopeXmlns);
+	const content = [];
+	let linked = [];
+	const flushLinked = () => {
+		if (linked.length > 0) {
+			content.push(linkOver(linked));
+			linked = [];
+		}
+	};
+	for (const item of wrapped) {
+		if (isHyperlinkContent(item)) {
+			linked.push(item);
+			continue;
+		}
+		flushLinked();
+		if (isTrackedChangeWrapperChild(item)) content.push(item);
+	}
+	flushLinked();
+	items.push({
+		type: "hoistedRevision",
+		wrapper,
+		info: parseTrackedChangeInfo(child),
+		content
+	});
+};
+const HYPERLINK_REVISION_HOISTING_HANDLERS = {
+	...HYPERLINK_CHILD_HANDLERS,
+	ins: hoistRevision("insertion"),
+	del: hoistRevision("deletion"),
+	moveFrom: hoistRevision("moveFrom"),
+	moveTo: hoistRevision("moveTo")
+};
 /**
 * A `w:hyperlink` as paragraph content, with any revision wrapper it holds
 * hoisted around it.
@@ -351,60 +385,32 @@ const mathContentOf = (child) => {
 * reads and a link that is half deleted is two links to it. This is the exact
 * inverse of what the serializer writes, so a package survives the round trip.
 */
-function parseHyperlinkParagraphContents(node, rels, styles, theme, media, rootXmlns) {
-	if (!getChildElements(node).some((child) => HYPERLINK_REVISION_WRAPPERS.has(getLocalName(child.name)))) return [parseHyperlink(node, rels, styles, theme, media, rootXmlns)];
+function parseHyperlinkParagraphContents(node, rels, styles, theme, media, rootXmlns, previews) {
+	if (!getChildElements(node).some((child) => HYPERLINK_REVISION_WRAPPERS.has(getLocalName(child.name)))) return [parseHyperlink(node, rels, styles, theme, media, rootXmlns, previews)];
 	const inScopeXmlns = mergeXmlnsDeclarations(rootXmlns, node);
-	const shell = parseHyperlink(node, rels, styles, theme, media, rootXmlns);
+	const shell = parseHyperlinkShell(node, rels);
 	const linkOver = (linkChildren) => ({
 		...shell,
 		children: [...linkChildren]
 	});
 	const items = [];
-	const hoistRevision = (wrapper) => (child) => {
-		const wrapped = parseParagraphContents(child, styles, theme, null, rels, media, wrapper === "deletion" || wrapper === "moveFrom" ? "deletion" : "default", inScopeXmlns);
-		const content = [];
-		let linked = [];
-		const flushLinked = () => {
-			if (linked.length > 0) {
-				content.push(linkOver(linked));
-				linked = [];
-			}
-		};
-		for (const item of wrapped) {
-			if (isHyperlinkContent(item)) {
-				linked.push(item);
-				continue;
-			}
-			flushLinked();
-			if (isTrackedChangeWrapperChild(item)) content.push(item);
-		}
-		flushLinked();
-		items.push({
-			type: "hoistedRevision",
-			wrapper,
-			info: parseTrackedChangeInfo(child),
-			content
-		});
-	};
-	const preserved = dispatchChildren({
+	const preserved = dispatchChildrenWithContext({
 		element: node,
 		container: "w:hyperlink",
 		capturePosition: () => items.length,
-		handlers: {
-			...hyperlinkChildHandlers({
-				push: (child) => {
-					items.push(child);
-				},
-				styles,
-				theme,
-				rels,
-				media,
-				inScopeXmlns
-			}),
-			ins: hoistRevision("insertion"),
-			del: hoistRevision("deletion"),
-			moveFrom: hoistRevision("moveFrom"),
-			moveTo: hoistRevision("moveTo")
+		handlers: HYPERLINK_REVISION_HOISTING_HANDLERS,
+		context: {
+			push: (child) => {
+				items.push(child);
+			},
+			styles,
+			theme,
+			rels,
+			media,
+			previews,
+			inScopeXmlns,
+			items,
+			linkOver
 		}
 	});
 	const contents = [];
@@ -449,7 +455,7 @@ function parseBookmarkEnd(node) {
 /**
 * Parse simple field (w:fldSimple)
 */
-function parseSimpleField(node, styles, theme, rels, media, rootXmlns = {}) {
+function parseSimpleField(node, styles, theme, rels, media, rootXmlns, previews) {
 	const instruction = getAttribute(node, "w", "instr") ?? "";
 	const field = {
 		type: "simpleField",
@@ -460,11 +466,12 @@ function parseSimpleField(node, styles, theme, rels, media, rootXmlns = {}) {
 	};
 	const inScopeXmlns = mergeXmlnsDeclarations(rootXmlns, node);
 	const content = [];
-	field.content = withPreservedChildren(content, dispatchChildren({
+	field.content = withPreservedChildren(content, dispatchChildrenWithContext({
 		element: node,
 		container: "w:fldSimple",
 		capturePosition: () => content.length,
-		handlers: simpleFieldChildHandlers({
+		handlers: SIMPLE_FIELD_CHILD_HANDLERS,
+		context: {
 			push: (child) => {
 				content.push(child);
 			},
@@ -472,11 +479,16 @@ function parseSimpleField(node, styles, theme, rels, media, rootXmlns = {}) {
 			theme,
 			rels,
 			media,
+			previews,
 			inScopeXmlns
-		})
+		}
 	}), preservedInlineCapture);
 	return field;
 }
+/** A transparent wrapper the field holds, read as the wrapper it is. */
+const fieldInlineWrapper = (element) => (child, context) => {
+	context.push(parseFieldInlineWrapper(element, child, context));
+};
 /**
 * What a `w:fldSimple` does with every child its content model declares.
 *
@@ -485,52 +497,46 @@ function parseSimpleField(node, styles, theme, rels, media, rootXmlns = {}) {
 * `CT_BdoContentRun` and its three siblings are the same `EG_PContent` the
 * field is, so the decision per child is the field's own.
 */
-const simpleFieldChildHandlers = (context) => {
-	const { push, styles, theme, rels, media, inScopeXmlns } = context;
-	const wrapper = (element) => (child) => {
-		push(parseFieldInlineWrapper(element, child, context));
-	};
-	return {
-		r: (child) => {
-			push(parseRun(child, styles, theme, rels, media, inScopeXmlns));
-		},
-		hyperlink: (child) => {
-			push(parseHyperlink(child, rels, styles, theme, media, inScopeXmlns));
-		},
-		bdo: wrapper("bdo"),
-		dir: wrapper("dir"),
-		customXml: wrapper("customXml"),
-		smartTag: wrapper("smartTag"),
-		bookmarkEnd: CAPTURE,
-		bookmarkStart: CAPTURE,
-		commentRangeEnd: CAPTURE,
-		commentRangeStart: CAPTURE,
-		customXmlDelRangeEnd: CAPTURE,
-		customXmlDelRangeStart: CAPTURE,
-		customXmlInsRangeEnd: CAPTURE,
-		customXmlInsRangeStart: CAPTURE,
-		customXmlMoveFromRangeEnd: CAPTURE,
-		customXmlMoveFromRangeStart: CAPTURE,
-		customXmlMoveToRangeEnd: CAPTURE,
-		customXmlMoveToRangeStart: CAPTURE,
-		del: CAPTURE,
-		fldData: CAPTURE,
-		fldSimple: (child) => {
-			push(preserveInlineChild(child));
-		},
-		ins: CAPTURE,
-		moveFrom: CAPTURE,
-		moveFromRangeEnd: CAPTURE,
-		moveFromRangeStart: CAPTURE,
-		moveTo: CAPTURE,
-		moveToRangeEnd: CAPTURE,
-		moveToRangeStart: CAPTURE,
-		permEnd: CAPTURE,
-		permStart: CAPTURE,
-		proofErr: CAPTURE,
-		sdt: CAPTURE,
-		subDoc: CAPTURE
-	};
+const SIMPLE_FIELD_CHILD_HANDLERS = {
+	r: (child, { push, styles, theme, rels, media, previews, inScopeXmlns }) => {
+		push(parseRun(child, styles, theme, rels, media, inScopeXmlns, previews));
+	},
+	hyperlink: (child, { push, styles, theme, rels, media, previews, inScopeXmlns }) => {
+		push(parseHyperlink(child, rels, styles, theme, media, inScopeXmlns, previews));
+	},
+	bdo: fieldInlineWrapper("bdo"),
+	dir: fieldInlineWrapper("dir"),
+	customXml: fieldInlineWrapper("customXml"),
+	smartTag: fieldInlineWrapper("smartTag"),
+	bookmarkEnd: CAPTURE,
+	bookmarkStart: CAPTURE,
+	commentRangeEnd: CAPTURE,
+	commentRangeStart: CAPTURE,
+	customXmlDelRangeEnd: CAPTURE,
+	customXmlDelRangeStart: CAPTURE,
+	customXmlInsRangeEnd: CAPTURE,
+	customXmlInsRangeStart: CAPTURE,
+	customXmlMoveFromRangeEnd: CAPTURE,
+	customXmlMoveFromRangeStart: CAPTURE,
+	customXmlMoveToRangeEnd: CAPTURE,
+	customXmlMoveToRangeStart: CAPTURE,
+	del: CAPTURE,
+	fldData: CAPTURE,
+	fldSimple: (child, { push }) => {
+		push(preserveInlineChild(child));
+	},
+	ins: CAPTURE,
+	moveFrom: CAPTURE,
+	moveFromRangeEnd: CAPTURE,
+	moveFromRangeStart: CAPTURE,
+	moveTo: CAPTURE,
+	moveToRangeEnd: CAPTURE,
+	moveToRangeStart: CAPTURE,
+	permEnd: CAPTURE,
+	permStart: CAPTURE,
+	proofErr: CAPTURE,
+	sdt: CAPTURE,
+	subDoc: CAPTURE
 };
 /**
 * A transparent wrapper a simple field holds, with the content the field holds.
@@ -543,21 +549,17 @@ const simpleFieldChildHandlers = (context) => {
 const parseFieldInlineWrapper = (element, node, context) => {
 	const inScopeXmlns = mergeXmlnsDeclarations(context.inScopeXmlns, node);
 	const content = [];
-	return inlineWrapperOf(element, node, withPreservedChildren(content, dispatchChildren({
+	return inlineWrapperOf(element, node, withPreservedChildren(content, dispatchChildrenWithContext({
 		element: node,
 		container: "run-level-content",
 		capturePosition: () => content.length,
-		handlers: {
-			...simpleFieldChildHandlers({
-				...context,
-				inScopeXmlns,
-				push: (child) => {
-					content.push(child);
-				}
-			}),
-			customXmlPr: CUSTOM_XML_PROPERTIES_OWNER,
-			smartTagPr: SMART_TAG_PROPERTIES_OWNER,
-			pPr: CAPTURE
+		handlers: FIELD_INLINE_WRAPPER_HANDLERS,
+		context: {
+			...context,
+			inScopeXmlns,
+			push: (child) => {
+				content.push(child);
+			}
 		}
 	}), preservedInlineCapture));
 };
@@ -666,267 +668,368 @@ const CUSTOM_XML_PROPERTIES_OWNER = ownedElsewhere({
 	child: "customXmlPr",
 	reader: "inlineWrapperParser#inlineWrapperOf"
 });
+/** The field's own map over a transparent wrapper it holds; see `parseFieldInlineWrapper`. */
+const FIELD_INLINE_WRAPPER_HANDLERS = {
+	...SIMPLE_FIELD_CHILD_HANDLERS,
+	customXmlPr: CUSTOM_XML_PROPERTIES_OWNER,
+	smartTagPr: SMART_TAG_PROPERTIES_OWNER,
+	pPr: CAPTURE
+};
+/**
+* The container children a complex field's result may hold and still be
+* assembled into a `ComplexField`: its runs and the zero-width markers read
+* beside them. Any other child is inline content (a hyperlink, a simple field,
+* a content control, a revision, a wrapper, an equation) that `fieldResult`
+* has no place for.
+*/
+const FIELD_TRANSPARENT_CHILDREN = /* @__PURE__ */ new Set([
+	"r",
+	"pPr",
+	"smartTagPr",
+	"customXmlPr",
+	"bookmarkStart",
+	"bookmarkEnd",
+	"commentRangeStart",
+	"commentRangeEnd",
+	"moveFromRangeStart",
+	"moveFromRangeEnd",
+	"moveToRangeStart",
+	"moveToRangeEnd",
+	"proofErr",
+	"permStart",
+	"permEnd",
+	"customXmlDelRangeStart",
+	"customXmlDelRangeEnd",
+	"customXmlInsRangeStart",
+	"customXmlInsRangeEnd",
+	"customXmlMoveFromRangeStart",
+	"customXmlMoveFromRangeEnd",
+	"customXmlMoveToRangeStart",
+	"customXmlMoveToRangeEnd"
+]);
+const isWordprocessingChild = (child) => {
+	const namespace = getNamespaceUri(child);
+	return namespace === void 0 || WORDPROCESSINGML_NAMESPACE_URIS.has(namespace);
+};
+/**
+* The `w:r` children whose `begin` opens a complex field that this container's
+* walk closes.
+*
+* A field is assembled from the runs between its `begin` and its `end`, so it
+* exists only when both are runs of this container with nothing between them
+* that a `ComplexField` cannot hold. A TOC opened here and closed in a later
+* paragraph, a field whose result holds a `w:hyperlink` (a TOC's `\h` entries),
+* and an outer field whose result holds a nested field are none of these; their
+* runs are ordinary content, read in source order alongside the siblings
+* between them. Mirrors the `w:r` handler run by run: a run with a `begin`
+* opens a field, and a run with an `end` closes the one open.
+*/
+const assembledFieldBeginsOf = (container) => {
+	const assembled = /* @__PURE__ */ new Set();
+	let open;
+	for (const child of getChildElements(container)) {
+		const wordprocessing = isWordprocessingChild(child);
+		const localName = getLocalName(child.name);
+		if (!wordprocessing || localName !== "r") {
+			if (!wordprocessing || !FIELD_TRANSPARENT_CHILDREN.has(localName)) open = void 0;
+			continue;
+		}
+		let hasBegin = false;
+		let hasEnd = false;
+		for (const runChild of getChildElements(child)) {
+			if (getLocalName(runChild.name) !== "fldChar" || !isWordprocessingChild(runChild)) continue;
+			const charType = getAttribute(runChild, "w", "fldCharType");
+			if (charType === "end") hasEnd = true;
+			else if (charType !== "separate") hasBegin = true;
+		}
+		if (hasBegin) open = child;
+		if (hasEnd && open !== void 0) {
+			assembled.add(open);
+			open = void 0;
+		}
+	}
+	return assembled;
+};
+/**
+* A transparent wrapper at paragraph level. All four hold ordinary inline
+* content and say something about it rather than about the text, so the
+* recursion is this same walk and `inlineWrapperOf` reads what the element
+* adds.
+*/
+const paragraphInlineWrapper = (element) => (child, { styles, theme, rels, media, previews, trackedContext, inScopeXmlns, contents }) => {
+	contents.push(inlineWrapperOf(element, child, parseParagraphContents(child, styles, theme, null, rels, media, previews, trackedContext, mergeXmlnsDeclarations(inScopeXmlns, child))));
+};
+const PARAGRAPH_CONTENT_UNDECLARED = { AlternateContent: (child, { contents, styles, theme, rels, media, previews, trackedContext, inScopeXmlns }) => {
+	const selectedBranch = selectAlternateContentBranch(child);
+	if (selectedBranch) contents.push(...parseParagraphContents(selectedBranch, styles, theme, null, rels, media, previews, trackedContext, mergeXmlnsDeclarations(inScopeXmlns, child)));
+} };
+const PARAGRAPH_CONTENT_UNDECLARED_NAMESPACES = { [OMML_NAMESPACE]: (child, { contents }) => {
+	const equation = mathContentOf(child);
+	if (equation !== void 0) contents.push(equation);
+} };
+const PARAGRAPH_CONTENT_HANDLERS = {
+	r: (child, { contents, styles, theme, rels, media, previews, trackedContext, inScopeXmlns, scan }) => {
+		const runElement = trackedContext === "deletion" ? normalizeDeletionContentElement(child) : child;
+		const run = parseRun(runElement, styles, theme, rels, media, inScopeXmlns, previews);
+		const commentReferenceId = getCommentReferenceId(runElement);
+		let hasFieldBegin = false;
+		let beginFieldState = {};
+		const beginFallbackDisplay = getLegacyFormCheckboxDisplay(runElement);
+		let hasFieldSeparate = false;
+		let hasFieldEnd = false;
+		let endOriginalValue;
+		let instrText = "";
+		for (const content of run.content) if (content.type === "fieldChar") if (content.charType === "begin") {
+			hasFieldBegin = true;
+			beginFieldState = fieldStateOf(content);
+		} else if (content.charType === "separate") hasFieldSeparate = true;
+		else {
+			hasFieldEnd = true;
+			if (content.originalValue !== void 0) endOriginalValue = content.originalValue;
+		}
+		else if (content.type === "instrText") instrText += content.text;
+		if (hasFieldBegin) {
+			scan.assembledFieldBegins ??= assembledFieldBeginsOf(scan.container);
+			if (!scan.assembledFieldBegins.has(child)) hasFieldBegin = false;
+		}
+		if (hasFieldBegin) {
+			if (scan.inComplexField) {
+				contents.push(...scan.complexFieldOpenRuns);
+				scan.inComplexField = false;
+			}
+			scan.inComplexField = true;
+			scan.afterSeparator = false;
+			scan.complexFieldInstr = "";
+			scan.complexFieldCodeRuns = [];
+			scan.complexFieldResultRuns = [];
+			scan.complexFieldOpenRuns = [];
+			scan.complexFieldState = beginFieldState;
+			scan.complexFieldFallbackDisplay = beginFallbackDisplay;
+			scan.complexFieldFormatting = run.formatting;
+		}
+		if (scan.inComplexField) {
+			scan.complexFieldOpenRuns.push(withOrphanFieldCharsPreserved(run, runElement));
+			if (instrText) scan.complexFieldInstr += instrText;
+			if ((!scan.complexFieldFormatting || Object.keys(scan.complexFieldFormatting).length === 0) && run.formatting && Object.keys(run.formatting).length > 0) scan.complexFieldFormatting = run.formatting;
+			let inFieldCodeRegion = !hasFieldBegin && !scan.afterSeparator;
+			const fieldCodeContent = [];
+			for (const content of run.content) {
+				if (content.type === "fieldChar") {
+					inFieldCodeRegion = content.charType === "begin";
+					continue;
+				}
+				if (inFieldCodeRegion) fieldCodeContent.push(content);
+			}
+			if (fieldCodeContent.length > 0) scan.complexFieldCodeRuns.push(fieldCodeContent.length === run.content.length ? run : {
+				...run,
+				content: fieldCodeContent
+			});
+			if (hasFieldSeparate) scan.afterSeparator = true;
+			if (scan.afterSeparator && !hasFieldEnd) {
+				if (!hasFieldSeparate) scan.complexFieldResultRuns.push(run);
+			}
+			if (hasFieldEnd) {
+				let resultRuns = scan.complexFieldResultRuns;
+				let resultIsFallback = false;
+				if (resultRuns.length === 0 && scan.complexFieldFallbackDisplay !== void 0 && isLegacyFormCheckboxInstruction(scan.complexFieldInstr)) {
+					resultRuns = [createLegacyFormCheckboxResultRun(scan.complexFieldFallbackDisplay, scan.complexFieldFormatting)];
+					resultIsFallback = true;
+				}
+				if (resultRuns.length === 0 && !scan.afterSeparator && endOriginalValue !== void 0) resultRuns = [{
+					type: "run",
+					content: [{
+						type: "text",
+						text: endOriginalValue
+					}]
+				}];
+				const complexField = {
+					type: "complexField",
+					instruction: scan.complexFieldInstr,
+					fieldType: parseFieldType(scan.complexFieldInstr),
+					fieldCode: scan.complexFieldCodeRuns,
+					fieldResult: resultRuns,
+					...scan.complexFieldState
+				};
+				if (resultIsFallback) complexField.fieldResultIsFallback = true;
+				if (scan.complexFieldFormatting) complexField.formatting = scan.complexFieldFormatting;
+				contents.push(complexField);
+				if (commentReferenceId !== null) contents.push({
+					type: "commentReference",
+					id: commentReferenceId
+				});
+				scan.inComplexField = false;
+			}
+		} else if (commentReferenceId !== null) {
+			if (runHoldsPayload(run)) contents.push(withOrphanFieldCharsPreserved(run, runElement));
+			contents.push({
+				type: "commentReference",
+				id: commentReferenceId
+			});
+		} else if (hasRunPayload({
+			run,
+			runElement,
+			rels,
+			media
+		})) contents.push(withOrphanFieldCharsPreserved(run, runElement));
+	},
+	hyperlink: (child, { contents, styles, theme, rels, media, previews, inScopeXmlns }) => {
+		contents.push(...parseHyperlinkParagraphContents(child, rels, styles, theme, media, inScopeXmlns, previews));
+	},
+	bookmarkStart: (child, { contents }) => {
+		contents.push(parseBookmarkStart(child));
+	},
+	bookmarkEnd: (child, { contents }) => {
+		contents.push(parseBookmarkEnd(child));
+	},
+	fldSimple: (child, { contents, styles, theme, rels, media, previews, inScopeXmlns }) => {
+		contents.push(parseSimpleField(child, styles, theme, rels, media, inScopeXmlns, previews));
+	},
+	pPr: PARAGRAPH_PROPERTIES_OWNER,
+	customXml: paragraphInlineWrapper("customXml"),
+	proofErr: CAPTURE,
+	permStart: CAPTURE,
+	permEnd: CAPTURE,
+	subDoc: CAPTURE,
+	customXmlDelRangeEnd: CAPTURE,
+	customXmlDelRangeStart: CAPTURE,
+	customXmlInsRangeEnd: CAPTURE,
+	customXmlInsRangeStart: CAPTURE,
+	customXmlMoveFromRangeEnd: CAPTURE,
+	customXmlMoveFromRangeStart: CAPTURE,
+	customXmlMoveToRangeEnd: CAPTURE,
+	customXmlMoveToRangeStart: CAPTURE,
+	smartTagPr: SMART_TAG_PROPERTIES_OWNER,
+	customXmlPr: CUSTOM_XML_PROPERTIES_OWNER,
+	sdt: (child, { contents, styles, theme, rels, media, previews, trackedContext, inScopeXmlns }) => {
+		const sdtPr = findWordprocessingChild(child, "sdtPr");
+		const sdtEndPr = findWordprocessingChild(child, "sdtEndPr");
+		const sdtContentEl = findWordprocessingChild(child, "sdtContent");
+		if (sdtContentEl) {
+			const sdtParsed = parseParagraphContents(sdtContentEl, styles, theme, null, rels, media, previews, trackedContext, mergeXmlnsDeclarations(inScopeXmlns, child));
+			const properties = parseSdtProperties(sdtPr, sdtEndPr);
+			const captured = captureSdtSiblingMarkers(child);
+			if (captured.before.length > 0) properties.rawSdtChildrenBeforeContent = captured.before;
+			if (captured.after.length > 0) properties.rawSdtChildrenAfterContent = captured.after;
+			pushInlineSdtSegments({
+				contents,
+				properties,
+				parsedContent: sdtParsed
+			});
+		}
+	},
+	ins: (child, { contents, styles, theme, rels, media, previews, inScopeXmlns }) => {
+		pushTrackedChangeSegments({
+			contents,
+			type: "insertion",
+			info: parseTrackedChangeInfo(child),
+			parsedContent: parseParagraphContents(child, styles, theme, null, rels, media, previews, "default", inScopeXmlns)
+		});
+	},
+	del: (child, { contents, styles, theme, rels, media, previews, inScopeXmlns }) => {
+		pushTrackedChangeSegments({
+			contents,
+			type: "deletion",
+			info: parseTrackedChangeInfo(child),
+			parsedContent: parseParagraphContents(child, styles, theme, null, rels, media, previews, "deletion", inScopeXmlns)
+		});
+	},
+	moveFrom: (child, { contents, styles, theme, rels, media, previews, inScopeXmlns }) => {
+		pushTrackedChangeSegments({
+			contents,
+			type: "moveFrom",
+			info: parseTrackedChangeInfo(child),
+			parsedContent: parseParagraphContents(child, styles, theme, null, rels, media, previews, "deletion", inScopeXmlns)
+		});
+	},
+	moveTo: (child, { contents, styles, theme, rels, media, previews, inScopeXmlns }) => {
+		pushTrackedChangeSegments({
+			contents,
+			type: "moveTo",
+			info: parseTrackedChangeInfo(child),
+			parsedContent: parseParagraphContents(child, styles, theme, null, rels, media, previews, "default", inScopeXmlns)
+		});
+	},
+	smartTag: paragraphInlineWrapper("smartTag"),
+	moveFromRangeStart: (child, { contents }) => {
+		contents.push({
+			type: "moveFromRangeStart",
+			...parseMoveBookmarkMarker(child)
+		});
+	},
+	moveFromRangeEnd: (child, { contents }) => {
+		contents.push({
+			type: "moveFromRangeEnd",
+			...parseMarkupRangeMarker(child)
+		});
+	},
+	moveToRangeStart: (child, { contents }) => {
+		contents.push({
+			type: "moveToRangeStart",
+			...parseMoveBookmarkMarker(child)
+		});
+	},
+	moveToRangeEnd: (child, { contents }) => {
+		contents.push({
+			type: "moveToRangeEnd",
+			...parseMarkupRangeMarker(child)
+		});
+	},
+	commentRangeStart: (child, { contents }) => {
+		contents.push({
+			type: "commentRangeStart",
+			...parseMarkupRangeMarker(child)
+		});
+	},
+	commentRangeEnd: (child, { contents }) => {
+		contents.push({
+			type: "commentRangeEnd",
+			...parseMarkupRangeMarker(child)
+		});
+	},
+	bdo: paragraphInlineWrapper("bdo"),
+	dir: paragraphInlineWrapper("dir")
+};
 /**
 * Parse all content within a paragraph
 *
 * Returns the parsed content and any complex fields that span multiple runs
 */
-function parseParagraphContents(paraElement, styles, theme, _numbering, rels, media, trackedContext = "default", rootXmlns = {}) {
+function parseParagraphContents(paraElement, styles, theme, _numbering, rels, media, previews, trackedContext = "default", rootXmlns = {}) {
 	const contents = [];
 	const inScopeXmlns = mergeXmlnsDeclarations(rootXmlns, paraElement);
-	let inComplexField = false;
-	let complexFieldInstr = "";
-	let complexFieldCodeRuns = [];
-	let complexFieldResultRuns = [];
-	let complexFieldOpenRuns = [];
-	let afterSeparator = false;
-	let complexFieldState = {};
-	let complexFieldFallbackDisplay;
-	let complexFieldFormatting;
-	const parseInlineWrapper = (child, element) => inlineWrapperOf(element, child, parseParagraphContents(child, styles, theme, null, rels, media, trackedContext, mergeXmlnsDeclarations(inScopeXmlns, child)));
-	const preserved = dispatchChildren({
+	const scan = {
+		inComplexField: false,
+		complexFieldInstr: "",
+		complexFieldCodeRuns: [],
+		complexFieldResultRuns: [],
+		complexFieldOpenRuns: [],
+		afterSeparator: false,
+		complexFieldState: {},
+		complexFieldFallbackDisplay: void 0,
+		complexFieldFormatting: void 0,
+		container: paraElement,
+		assembledFieldBegins: void 0
+	};
+	const preserved = dispatchChildrenWithContext({
 		element: paraElement,
 		container: "run-level-content",
 		capturePosition: () => contents.length,
-		undeclared: { AlternateContent: (child) => {
-			const selectedBranch = selectAlternateContentBranch(child);
-			if (selectedBranch) contents.push(...parseParagraphContents(selectedBranch, styles, theme, null, rels, media, trackedContext, mergeXmlnsDeclarations(inScopeXmlns, child)));
-		} },
-		undeclaredNamespaces: { [OMML_NAMESPACE]: (child) => {
-			const equation = mathContentOf(child);
-			if (equation !== void 0) contents.push(equation);
-		} },
-		handlers: {
-			r: (child) => {
-				const runElement = trackedContext === "deletion" ? normalizeDeletionContentElement(child) : child;
-				const run = parseRun(runElement, styles, theme, rels, media, inScopeXmlns);
-				const commentReferenceId = getCommentReferenceId(runElement);
-				let hasFieldBegin = false;
-				let beginFieldState = {};
-				const beginFallbackDisplay = getLegacyFormCheckboxDisplay(runElement);
-				let hasFieldSeparate = false;
-				let hasFieldEnd = false;
-				let endOriginalValue;
-				let instrText = "";
-				for (const content of run.content) if (content.type === "fieldChar") if (content.charType === "begin") {
-					hasFieldBegin = true;
-					beginFieldState = fieldStateOf(content);
-				} else if (content.charType === "separate") hasFieldSeparate = true;
-				else {
-					hasFieldEnd = true;
-					if (content.originalValue !== void 0) endOriginalValue = content.originalValue;
-				}
-				else if (content.type === "instrText") instrText += content.text;
-				if (hasFieldBegin) {
-					if (inComplexField && afterSeparator) {
-						contents.push(...complexFieldResultRuns);
-						inComplexField = false;
-					}
-					inComplexField = true;
-					afterSeparator = false;
-					complexFieldInstr = "";
-					complexFieldCodeRuns = [];
-					complexFieldResultRuns = [];
-					complexFieldOpenRuns = [];
-					complexFieldState = beginFieldState;
-					complexFieldFallbackDisplay = beginFallbackDisplay;
-					complexFieldFormatting = run.formatting;
-				}
-				if (inComplexField) {
-					complexFieldOpenRuns.push(withOrphanFieldCharsPreserved(run, runElement));
-					if (instrText) complexFieldInstr += instrText;
-					if ((!complexFieldFormatting || Object.keys(complexFieldFormatting).length === 0) && run.formatting && Object.keys(run.formatting).length > 0) complexFieldFormatting = run.formatting;
-					let inFieldCodeRegion = !hasFieldBegin && !afterSeparator;
-					const fieldCodeContent = [];
-					for (const content of run.content) {
-						if (content.type === "fieldChar") {
-							inFieldCodeRegion = content.charType === "begin";
-							continue;
-						}
-						if (inFieldCodeRegion) fieldCodeContent.push(content);
-					}
-					if (fieldCodeContent.length > 0) complexFieldCodeRuns.push(fieldCodeContent.length === run.content.length ? run : {
-						...run,
-						content: fieldCodeContent
-					});
-					if (hasFieldSeparate) afterSeparator = true;
-					if (afterSeparator && !hasFieldEnd) {
-						if (!hasFieldSeparate) complexFieldResultRuns.push(run);
-					}
-					if (hasFieldEnd) {
-						let resultRuns = complexFieldResultRuns;
-						if (resultRuns.length === 0 && complexFieldFallbackDisplay !== void 0 && isLegacyFormCheckboxInstruction(complexFieldInstr)) resultRuns = [createLegacyFormCheckboxResultRun(complexFieldFallbackDisplay, complexFieldFormatting)];
-						if (resultRuns.length === 0 && !afterSeparator && endOriginalValue !== void 0) resultRuns = [{
-							type: "run",
-							content: [{
-								type: "text",
-								text: endOriginalValue
-							}]
-						}];
-						const complexField = {
-							type: "complexField",
-							instruction: complexFieldInstr,
-							fieldType: parseFieldType(complexFieldInstr),
-							fieldCode: complexFieldCodeRuns,
-							fieldResult: resultRuns,
-							...complexFieldState
-						};
-						if (complexFieldFormatting) complexField.formatting = complexFieldFormatting;
-						contents.push(complexField);
-						if (commentReferenceId !== null) contents.push({
-							type: "commentReference",
-							id: commentReferenceId
-						});
-						inComplexField = false;
-					}
-				} else if (commentReferenceId !== null) {
-					if (runHoldsPayload(run)) contents.push(withOrphanFieldCharsPreserved(run, runElement));
-					contents.push({
-						type: "commentReference",
-						id: commentReferenceId
-					});
-				} else if (hasRunPayload({
-					run,
-					runElement,
-					rels,
-					media
-				})) contents.push(withOrphanFieldCharsPreserved(run, runElement));
-			},
-			hyperlink: (child) => {
-				contents.push(...parseHyperlinkParagraphContents(child, rels, styles, theme, media, inScopeXmlns));
-			},
-			bookmarkStart: (child) => {
-				contents.push(parseBookmarkStart(child));
-			},
-			bookmarkEnd: (child) => {
-				contents.push(parseBookmarkEnd(child));
-			},
-			fldSimple: (child) => {
-				contents.push(parseSimpleField(child, styles, theme, rels, media, inScopeXmlns));
-			},
-			pPr: PARAGRAPH_PROPERTIES_OWNER,
-			customXml: (child) => {
-				contents.push(parseInlineWrapper(child, "customXml"));
-			},
-			proofErr: CAPTURE,
-			permStart: CAPTURE,
-			permEnd: CAPTURE,
-			subDoc: CAPTURE,
-			customXmlDelRangeEnd: CAPTURE,
-			customXmlDelRangeStart: CAPTURE,
-			customXmlInsRangeEnd: CAPTURE,
-			customXmlInsRangeStart: CAPTURE,
-			customXmlMoveFromRangeEnd: CAPTURE,
-			customXmlMoveFromRangeStart: CAPTURE,
-			customXmlMoveToRangeEnd: CAPTURE,
-			customXmlMoveToRangeStart: CAPTURE,
-			smartTagPr: SMART_TAG_PROPERTIES_OWNER,
-			customXmlPr: CUSTOM_XML_PROPERTIES_OWNER,
-			sdt: (child) => {
-				const sdtPr = findWordprocessingChild(child, "sdtPr");
-				const sdtEndPr = findWordprocessingChild(child, "sdtEndPr");
-				const sdtContentEl = findWordprocessingChild(child, "sdtContent");
-				if (sdtContentEl) {
-					const sdtParsed = parseParagraphContents(sdtContentEl, styles, theme, null, rels, media, trackedContext, mergeXmlnsDeclarations(inScopeXmlns, child));
-					const properties = parseSdtProperties(sdtPr, sdtEndPr);
-					const captured = captureSdtSiblingMarkers(child);
-					if (captured.before.length > 0) properties.rawSdtChildrenBeforeContent = captured.before;
-					if (captured.after.length > 0) properties.rawSdtChildrenAfterContent = captured.after;
-					pushInlineSdtSegments({
-						contents,
-						properties,
-						parsedContent: sdtParsed
-					});
-				}
-			},
-			ins: (child) => {
-				const insInfo = parseTrackedChangeInfo(child);
-				const insContent = parseParagraphContents(child, styles, theme, null, rels, media, "default", inScopeXmlns);
-				pushTrackedChangeSegments({
-					contents,
-					type: "insertion",
-					info: insInfo,
-					parsedContent: insContent
-				});
-			},
-			del: (child) => {
-				const delInfo = parseTrackedChangeInfo(child);
-				const delContent = parseParagraphContents(child, styles, theme, null, rels, media, "deletion", inScopeXmlns);
-				pushTrackedChangeSegments({
-					contents,
-					type: "deletion",
-					info: delInfo,
-					parsedContent: delContent
-				});
-			},
-			moveFrom: (child) => {
-				const moveFromInfo = parseTrackedChangeInfo(child);
-				const moveFromContent = parseParagraphContents(child, styles, theme, null, rels, media, "deletion", inScopeXmlns);
-				pushTrackedChangeSegments({
-					contents,
-					type: "moveFrom",
-					info: moveFromInfo,
-					parsedContent: moveFromContent
-				});
-			},
-			moveTo: (child) => {
-				const moveToInfo = parseTrackedChangeInfo(child);
-				const moveToContent = parseParagraphContents(child, styles, theme, null, rels, media, "default", inScopeXmlns);
-				pushTrackedChangeSegments({
-					contents,
-					type: "moveTo",
-					info: moveToInfo,
-					parsedContent: moveToContent
-				});
-			},
-			smartTag: (child) => {
-				contents.push(parseInlineWrapper(child, "smartTag"));
-			},
-			moveFromRangeStart: (child) => {
-				contents.push({
-					type: "moveFromRangeStart",
-					...parseMoveBookmarkMarker(child)
-				});
-			},
-			moveFromRangeEnd: (child) => {
-				contents.push({
-					type: "moveFromRangeEnd",
-					...parseMarkupRangeMarker(child)
-				});
-			},
-			moveToRangeStart: (child) => {
-				contents.push({
-					type: "moveToRangeStart",
-					...parseMoveBookmarkMarker(child)
-				});
-			},
-			moveToRangeEnd: (child) => {
-				contents.push({
-					type: "moveToRangeEnd",
-					...parseMarkupRangeMarker(child)
-				});
-			},
-			commentRangeStart: (child) => {
-				contents.push({
-					type: "commentRangeStart",
-					...parseMarkupRangeMarker(child)
-				});
-			},
-			commentRangeEnd: (child) => {
-				contents.push({
-					type: "commentRangeEnd",
-					...parseMarkupRangeMarker(child)
-				});
-			},
-			bdo: (child) => {
-				contents.push(parseInlineWrapper(child, "bdo"));
-			},
-			dir: (child) => {
-				contents.push(parseInlineWrapper(child, "dir"));
-			}
+		undeclared: PARAGRAPH_CONTENT_UNDECLARED,
+		undeclaredNamespaces: PARAGRAPH_CONTENT_UNDECLARED_NAMESPACES,
+		handlers: PARAGRAPH_CONTENT_HANDLERS,
+		context: {
+			styles,
+			theme,
+			rels,
+			media,
+			previews,
+			trackedContext,
+			inScopeXmlns,
+			contents,
+			scan
 		}
 	});
-	if (inComplexField) contents.push(...complexFieldOpenRuns);
+	if (scan.inComplexField) contents.push(...scan.complexFieldOpenRuns);
 	return withPreservedChildren(contents, preserved, preservedInlineCapture);
 }
 function getCommentReferenceId(runElement) {
@@ -956,7 +1059,8 @@ const PARAGRAPH_ATTRIBUTES = /* @__PURE__ */ new Set([
 * @param numbering - Numbering definitions for list info
 * @param rels - Relationship map for resolving hyperlink URLs
 * @param media - Media files map for image data
-* @param options - Parsing options for context-specific body behavior
+* @param options - Parsing options for context-specific body behavior; a
+*   paragraph read without them charges its previews to no package
 * @returns Parsed Paragraph object
 */
 function parseParagraph(node, styles, theme, numbering, rels = null, media = null, options) {
@@ -986,7 +1090,7 @@ function parseParagraph(node, styles, theme, numbering, rels = null, media = nul
 		const sectPr = findChild(pPr, "w", "sectPr");
 		if (sectPr) paragraph.sectionProperties = parseSectionProperties(sectPr);
 	}
-	const rawContent = parseParagraphContents(node, styles, theme, numbering, rels, media, "default", options?.rootXmlns ?? {});
+	const rawContent = parseParagraphContents(node, styles, theme, numbering, rels, media, options?.previews ?? standalonePreviewLedger(), "default", options?.rootXmlns ?? {});
 	paragraph.content = options?.runConsolidation === "deferred" ? rawContent : consolidateParagraphContent(rawContent);
 	const paragraphFormatting = paragraph.formatting;
 	const directNumPr = paragraphFormatting?.numPr;
@@ -1033,6 +1137,7 @@ function parseParagraph(node, styles, theme, numbering, rels = null, media = nul
 				const markerAlignment = markerAlignmentForLevel(level.lvlJc);
 				if (markerAlignment !== void 0) listRendering.markerAlignment = markerAlignment;
 				if (level.suffix) listRendering.markerSuffix = level.suffix;
+				if (level.pPr?.tabs?.length) listRendering.levelTabs = level.pPr.tabs;
 				let implicitChildLevelAdvances = 0;
 				const foldedMarkerSuffix = [];
 				const filteredContent = [];
@@ -1077,9 +1182,7 @@ function parseParagraph(node, styles, theme, numbering, rels = null, media = nul
 					if (!paragraph.formatting) paragraph.formatting = {};
 					const directInd = pPr ? findChild(pPr, "w", "ind") : null;
 					const hasDirectLeft = hasAttributeAnySpelling(directInd, "CT_Ind @left");
-					const directFirstLine = directInd ? parseNumericAttribute(directInd, "w", "firstLine") : void 0;
-					const directHanging = directInd ? parseNumericAttribute(directInd, "w", "hanging") : void 0;
-					const hasDirectFirstLineOrHanging = directFirstLine !== void 0 && directFirstLine !== 0 || directHanging !== void 0 && directHanging !== 0;
+					const hasDirectFirstLineOrHanging = parseNumericAttribute(directInd, "w", "firstLine") !== void 0 || parseNumericAttribute(directInd, "w", "hanging") !== void 0;
 					if (!hasDirectLeft && !chainInd.left && level.pPr.indentLeft !== void 0) paragraph.formatting.indentLeft = level.pPr.indentLeft;
 					if (!hasDirectFirstLineOrHanging && !chainInd.firstLine && numberingLevelHasMarkerSlot(level)) {
 						if (level.pPr.indentFirstLine !== void 0) paragraph.formatting.indentFirstLine = level.pPr.indentFirstLine;