@stll/folio-core 0.47.3 → 0.47.5

package/dist/prosemirror/attrs/index.js

@@ -868,6 +868,11 @@ const taggedLayerValidator = (label) => (layer, path, issues) => {
 		path: `${path}.${key}`,
 		message: "Expected a string."
 	});
+	const propertiesXml = layer["propertiesXml"];
+	if (typeof propertiesXml === "string" && !isSafePreservedChildXml(propertiesXml)) issues.push({
+		path: `${path}.propertiesXml`,
+		message: "Expected one bounded, well-formed XML element."
+	});
 	for (const key of Object.keys(layer)) if (!TAGGED_LAYER_KEYS.has(key)) issues.push({
 		path: `${path}.${key}`,
 		message: `Unexpected ${label} wrapper property.`
@@ -894,6 +899,19 @@ const INLINE_WRAPPER_LAYER_VALIDATORS = {
 const inlineWrapperLayerValidator = (kind) => {
 	return typeof kind === "string" ? INLINE_WRAPPER_LAYER_VALIDATORS[kind] : void 0;
 };
+const inlineWrapperProperties = function* (layers) {
+	for (let index = 0; index < layers.length; index += 1) {
+		const layer = layers[index];
+		yield { xml: isRecord(layer) && typeof layer["propertiesXml"] === "string" ? layer["propertiesXml"] : "" };
+	}
+};
+const emptyHyperlinkWrapperProperties = function* (stacks) {
+	for (let stackIndex = 0; stackIndex < stacks.length; stackIndex += 1) {
+		const stack = stacks[stackIndex];
+		yield {};
+		if (Array.isArray(stack)) yield* inlineWrapperProperties(stack);
+	}
+};
 const validateInlineWrapperStack = (value, path, issues) => {
 	if (!Array.isArray(value)) {
 		issues.push({
@@ -909,6 +927,13 @@ const validateInlineWrapperStack = (value, path, issues) => {
 		});
 		return;
 	}
+	if (!isWithinPreservedMarkupBudget(inlineWrapperProperties(value))) {
+		issues.push({
+			path,
+			message: "Inline wrapper stack exceeds its resource budget."
+		});
+		return;
+	}
 	for (const [index, layer] of value.entries()) {
 		const layerPath = `${path}[${index}]`;
 		if (!isRecord(layer)) {
@@ -950,6 +975,22 @@ const readInlineWrapperMarkAttrs = (mark) => {
 	const issues = [];
 	expectMarkType(mark, "inlineWrapper", issues);
 	validateInlineWrapperStack(attrs["stack"], "inlineWrapper.attrs.stack", issues);
+	const hyperlinkIndex = attrs["_docxHyperlinkIndex"];
+	const stackStart = attrs["_docxInsideHyperlinkStackStart"];
+	const hasHyperlinkIndex = hyperlinkIndex !== void 0 && hyperlinkIndex !== null;
+	const hasStackStart = stackStart !== void 0 && stackStart !== null;
+	if (hasHyperlinkIndex !== hasStackStart) issues.push({
+		path: "inlineWrapper.attrs",
+		message: "Hyperlink wrapper provenance requires both an index and stack start."
+	});
+	else if (hasHyperlinkIndex && hasStackStart) {
+		validateNonNegativeInteger(hyperlinkIndex, "inlineWrapper.attrs._docxHyperlinkIndex", issues);
+		validateNonNegativeInteger(stackStart, "inlineWrapper.attrs._docxInsideHyperlinkStackStart", issues);
+		if (typeof stackStart === "number" && Array.isArray(attrs["stack"]) && stackStart >= attrs["stack"].length) issues.push({
+			path: "inlineWrapper.attrs._docxInsideHyperlinkStackStart",
+			message: "Expected a stack position inside the wrapper stack."
+		});
+	}
 	return attrsResult(attrs, issues);
 };
 const expectInlineWrapperMarkAttrs = (mark) => expectCachedMarkAttrs(mark, inlineWrapperAttrsCache, readInlineWrapperMarkAttrs, "inline wrapper attrs");
@@ -1745,7 +1786,7 @@ const optionalPositionedBookmarks = (attrs, path, issues) => {
 			});
 			continue;
 		}
-		requiredNumber(entry, "index", `${entryPath}.index`, issues);
+		validateNonNegativeSafeInteger(entry["index"], `${entryPath}.index`, issues);
 		const marker = entry["marker"];
 		if (!isRecord(marker)) {
 			issues.push({
@@ -1762,7 +1803,7 @@ const optionalPositionedBookmarks = (attrs, path, issues) => {
 			});
 			continue;
 		}
-		requiredNumber(marker, "id", `${entryPath}.marker.id`, issues);
+		validateNonNegativeSafeInteger(marker["id"], `${entryPath}.marker.id`, issues);
 		if (type === "bookmarkStart") requiredString(marker, "name", `${entryPath}.marker.name`, issues);
 		optionalContentControls(entry, `${entryPath}.contentControls`, issues);
 	}
@@ -2574,11 +2615,17 @@ const validateNonNegativeInteger = (value, path, issues) => {
 		});
 		return;
 	}
-	if (!Number.isInteger(value) || value < 0) issues.push({
+	if (!Number.isSafeInteger(value) || value < 0) issues.push({
 		path,
 		message: "Expected a non-negative integer."
 	});
 };
+const validateNonNegativeSafeInteger = (value, path, issues) => {
+	if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0) issues.push({
+		path,
+		message: "Expected a non-negative safe integer."
+	});
+};
 const optionalBookmarkArray = (value, issues) => {
 	if (value === void 0 || value === null) return;
 	if (!Array.isArray(value)) {
@@ -2633,6 +2680,23 @@ const optionalEmptyHyperlinkArray = (value, issues) => {
 		optionalString(item, "target", `${itemPath}.target`, issues);
 		optionalBoolean(item, "history", `${itemPath}.history`, issues);
 		optionalString(item, "docLocation", `${itemPath}.docLocation`, issues);
+		const wrapperStacks = item["_docxEmptyWrapperStacks"];
+		if (wrapperStacks === void 0 || wrapperStacks === null) continue;
+		if (!Array.isArray(wrapperStacks)) {
+			issues.push({
+				path: `${itemPath}._docxEmptyWrapperStacks`,
+				message: "Expected an array of inline wrapper stacks."
+			});
+			continue;
+		}
+		if (!isWithinPreservedMarkupBudget(emptyHyperlinkWrapperProperties(wrapperStacks))) {
+			issues.push({
+				path: `${itemPath}._docxEmptyWrapperStacks`,
+				message: "Empty inline wrapper stacks exceed their aggregate resource budget."
+			});
+			continue;
+		}
+		for (const [stackIndex, stack] of wrapperStacks.entries()) validateInlineWrapperStack(stack, `${itemPath}._docxEmptyWrapperStacks[${stackIndex}]`, issues);
 	}
 };
 //#endregion

package/dist/prosemirror/commentReferenceAttrs.js

@@ -8,9 +8,9 @@ const readCommentReferenceAttrs = (node) => {
 		message: `Expected commentReference, got ${node.type.name}.`
 	});
 	const commentId = node.attrs["commentId"];
-	if (typeof commentId !== "number" || !Number.isInteger(commentId) || commentId < 0) issues.push({
+	if (typeof commentId !== "number" || !Number.isSafeInteger(commentId)) issues.push({
 		path: "commentReference.attrs.commentId",
-		message: "Expected a non-negative integer."
+		message: "Expected a safe integer."
 	});
 	if (issues.length > 0 || typeof commentId !== "number") return {
 		ok: false,

package/dist/prosemirror/commentReferenceIntegrity.d.ts

@@ -10,13 +10,17 @@
  * a comment mark creates none — so the repair is computed here and applied by
  * the extension's `appendTransaction`, rather than left to each call site.
  */
-type CommentReferenceOccurrence = {
-  commentId: number;
+type PositionedReference = {
   position: number;
   /** Node size, so a caller can delete the node without re-reading it. */
   size: number;
-  malformed: boolean;
 };
+type CommentReferenceOccurrence = (PositionedReference & {
+  status: "valid";
+  commentId: number;
+}) | (PositionedReference & {
+  status: "malformed";
+});
 /** Where a comment's mark last covers content, and how far that content runs. */
 type CommentMarkExtent = {
   commentId: number;

package/dist/prosemirror/commentReferenceIntegrity.js

@@ -10,7 +10,15 @@ const planCommentReferenceRepairs = ({ references, markExtents }) => {
 	const deletions = [];
 	const keptIds = /* @__PURE__ */ new Set();
 	for (const reference of references) {
-		if (reference.malformed || !markedIds.has(reference.commentId)) {
+		if (reference.status === "malformed") {
+			deletions.push({
+				type: "delete",
+				position: reference.position,
+				size: reference.size
+			});
+			continue;
+		}
+		if (!markedIds.has(reference.commentId)) {
 			deletions.push({
 				type: "delete",
 				position: reference.position,

package/dist/prosemirror/conversion/fromProseDoc.js

@@ -272,6 +272,7 @@ function fromProseDoc(pmDoc, baseDocument, { reuse = "none" } = {}) {
 	if (tokenSources) restoreParagraphPropertySourcesByToken(blocks, tokenSources);
 	else if (baseDocument) restoreParagraphPropertySources(blocks, baseDocument.package.document.content, linkedSources.targets, linkedSources.sources);
 	const documentBody = { content: blocks };
+	if (baseDocument?.package.document.background) documentBody.background = baseDocument.package.document.background;
 	if (baseDocument?.package.document.finalSectionProperties) documentBody.finalSectionProperties = baseDocument.package.document.finalSectionProperties;
 	if (baseDocument?.package.document.sections) documentBody.sections = baseDocument.package.document.sections;
 	if (baseDocument?.package.document.comments) documentBody.comments = baseDocument.package.document.comments;
@@ -1137,6 +1138,17 @@ const inlineWrapperStackOf = (node) => {
 	const mark = node.marks.find((candidate) => candidate.type.name === INLINE_WRAPPER_MARK_NAME);
 	return mark ? expectInlineWrapperMarkAttrs(mark).stack : [];
 };
+/** The authored hyperlink that owns a suffix of the node's wrapper stack. */
+const inlineWrapperHyperlinkOriginOf = (node) => {
+	const mark = node.marks.find((candidate) => candidate.type.name === INLINE_WRAPPER_MARK_NAME);
+	if (!mark) return;
+	const attrs = expectInlineWrapperMarkAttrs(mark);
+	if (typeof attrs._docxHyperlinkIndex !== "number" || typeof attrs._docxInsideHyperlinkStackStart !== "number") return;
+	return {
+		hyperlinkIndex: attrs._docxHyperlinkIndex,
+		stackStart: attrs._docxInsideHyperlinkStackStart
+	};
+};
 const isRevisionWrapper = (item) => item.type === "insertion" || item.type === "deletion" || item.type === "moveFrom" || item.type === "moveTo";
 /** `stack` closed around `content`, outermost layer first. */
 const nestInlineWrappers = (stack, content) => {
@@ -1160,7 +1172,20 @@ const nestInlineWrappers = (stack, content) => {
 * A group with nothing in it writes no wrapper: an authored wrapper whose
 * content was deleted or rejected is gone, and an empty one says nothing.
 */
-const nestInlineWrapperGroups = (items, groups) => {
+const nestInsideHyperlink = (item, stack, hyperlinkIndex, indices) => {
+	if (item.type === "hyperlink") {
+		if (indices.get(item) !== hyperlinkIndex) return false;
+		item.children = [nestInlineWrappers(stack, item.children)];
+		return true;
+	}
+	if (isRevisionWrapper(item)) {
+		let nested = false;
+		for (const child of item.content) if (nestInsideHyperlink(child, stack, hyperlinkIndex, indices)) nested = true;
+		return nested;
+	}
+	return false;
+};
+const nestInlineWrapperGroups = (items, groups, hyperlinkIndices) => {
 	const nested = [];
 	for (const [index, group] of groups.entries()) {
 		const slice = items.slice(group.start, groups[index + 1]?.start ?? items.length);
@@ -1168,10 +1193,22 @@ const nestInlineWrapperGroups = (items, groups) => {
 			nested.push(...slice);
 			continue;
 		}
+		const origin = group.origin;
+		let outerStack = group.stack;
+		if (origin !== void 0) {
+			const innerStack = group.stack.slice(origin.stackStart);
+			let nestedInsideOrigin = false;
+			for (const item of slice) if (nestInsideHyperlink(item, innerStack, origin.hyperlinkIndex, hyperlinkIndices)) nestedInsideOrigin = true;
+			if (nestedInsideOrigin) outerStack = group.stack.slice(0, origin.stackStart);
+		}
+		if (outerStack.length === 0) {
+			nested.push(...slice);
+			continue;
+		}
 		let pending = [];
 		const closeNest = () => {
 			if (pending.length === 0) return;
-			nested.push(nestInlineWrappers(group.stack, pending));
+			nested.push(nestInlineWrappers(outerStack, pending));
 			pending = [];
 		};
 		for (const item of slice) {
@@ -1180,7 +1217,7 @@ const nestInlineWrapperGroups = (items, groups) => {
 				continue;
 			}
 			closeNest();
-			if (item.content.length > 0) item.content = [nestInlineWrappers(group.stack, item.content)];
+			if (item.content.length > 0) item.content = [nestInlineWrappers(outerStack, item.content)];
 			nested.push(item);
 		}
 		closeNest();
@@ -1214,7 +1251,14 @@ function extractParagraphContent(paragraph, _documentCounts, emptyHyperlinks, te
 	let currentHyperlinkKey = null;
 	let currentTrackedChange;
 	const sourceRunOwners = /* @__PURE__ */ new WeakMap();
+	const sourceHyperlinkIndices = /* @__PURE__ */ new WeakMap();
 	const openedComments = /* @__PURE__ */ new Set();
+	const createIndexedHyperlink = (mark) => {
+		const hyperlink = createHyperlink(mark);
+		const index = expectHyperlinkMarkAttrs(mark)._docxHyperlinkIndex;
+		if (typeof index === "number") sourceHyperlinkIndices.set(hyperlink, index);
+		return hyperlink;
+	};
 	const commentLastOffset = /* @__PURE__ */ new Map();
 	paragraph.forEach((node, offset) => {
 		for (const commentId of getCommentMarkIds(node.marks)) commentLastOffset.set(commentId, offset);
@@ -1298,14 +1342,20 @@ function extractParagraphContent(paragraph, _documentCounts, emptyHyperlinks, te
 	*/
 	const enterWrapperGroup = (node) => {
 		const stack = inlineWrapperStackOf(node);
-		const key = inlineWrapperStackKey(stack);
+		const origin = inlineWrapperHyperlinkOriginOf(node);
+		const key = [
+			inlineWrapperStackKey(stack),
+			origin?.hyperlinkIndex ?? "",
+			origin?.stackStart ?? ""
+		].join("\0");
 		if (key === wrapperGroupKey) return;
 		flushCurrentInline();
 		currentTrackedChange = void 0;
 		wrapperGroupKey = key;
 		wrapperGroups.push({
 			start: content.length,
-			stack
+			stack,
+			...origin ? { origin } : {}
 		});
 	};
 	const processInlineNode = (node, offset) => {
@@ -1332,12 +1382,6 @@ function extractParagraphContent(paragraph, _documentCounts, emptyHyperlinks, te
 			content.push({ ...start }, { ...end });
 			return;
 		}
-		if (node.type.name === "moveRangeBoundary") {
-			flushCurrentInline();
-			currentTrackedChange = void 0;
-			content.push({ ...expectMoveRangeBoundaryAttrs(node) });
-			return;
-		}
 		const linkMark = node.marks.find((m) => m.type.name === "hyperlink");
 		const noteRefMark = node.marks.find((m) => m.type.name === "footnoteRef");
 		const insertionMark = node.marks.find((m) => m.type.name === "insertion");
@@ -1354,10 +1398,8 @@ function extractParagraphContent(paragraph, _documentCounts, emptyHyperlinks, te
 			};
 			if (textBoxAnchorMarkers.has(anchorId)) return;
 			textBoxAnchorMarkers.set(anchorId, marker);
-			const anchoredContent = linkMark ? {
-				...createHyperlink(linkMark),
-				children: [marker]
-			} : marker;
+			const anchoredContent = linkMark ? createIndexedHyperlink(linkMark) : marker;
+			if (anchoredContent.type === "hyperlink") anchoredContent.children.push(marker);
 			const changeMark = insertionMark ?? deletionMark;
 			if (!changeMark) {
 				content.push(anchoredContent);
@@ -1409,7 +1451,7 @@ function extractParagraphContent(paragraph, _documentCounts, emptyHyperlinks, te
 			if (linkMark) {
 				const linkKey = getLinkKey(linkMark);
 				if (!currentTrackedChange || currentTrackedChange.type !== "hyperlink" || currentTrackedChange.key !== trackedChangeKey || currentTrackedChange.hyperlinkKey !== linkKey) {
-					const hyperlink = createHyperlink(linkMark);
+					const hyperlink = createIndexedHyperlink(linkMark);
 					const wrapper = createTrackedRunWrapper(type, info, hyperlink);
 					content.push(wrapper);
 					currentTrackedChange = {
@@ -1455,6 +1497,10 @@ function extractParagraphContent(paragraph, _documentCounts, emptyHyperlinks, te
 				currentTrackedChange.wrapper.content.push(bookmarkMarkerFromAttrs(expectBookmarkBoundaryAttrs(node)));
 				return;
 			}
+			if (node.type.name === "moveRangeBoundary") {
+				currentTrackedChange.wrapper.content.push({ ...expectMoveRangeBoundaryAttrs(node) });
+				return;
+			}
 			if (node.type.name === "field" || node.type.name === "structuredField") {
 				currentTrackedChange.wrapper.content.push(createFieldFromNode(node, {
 					...formattingContext,
@@ -1488,6 +1534,12 @@ function extractParagraphContent(paragraph, _documentCounts, emptyHyperlinks, te
 			appendDirectRun(node, ownedRun, node.isText);
 			return;
 		}
+		if (node.type.name === "moveRangeBoundary") {
+			flushCurrentInline();
+			currentTrackedChange = void 0;
+			content.push({ ...expectMoveRangeBoundaryAttrs(node) });
+			return;
+		}
 		if (noteRefMark && !linkMark) {
 			flushCurrentInline();
 			content.push(createNoteReferenceRun(noteRefMark, node.marks, formattingContext));
@@ -1497,7 +1549,7 @@ function extractParagraphContent(paragraph, _documentCounts, emptyHyperlinks, te
 			const linkKey = getLinkKey(linkMark);
 			if (currentHyperlink && currentHyperlinkKey === linkKey) {} else {
 				flushCurrentInline();
-				currentHyperlink = createHyperlink(linkMark);
+				currentHyperlink = createIndexedHyperlink(linkMark);
 				currentHyperlinkKey = linkKey;
 			}
 			addNodeToHyperlink({
@@ -1588,7 +1640,7 @@ function extractParagraphContent(paragraph, _documentCounts, emptyHyperlinks, te
 		type: "commentRangeEnd",
 		id: commentId
 	});
-	return nestInlineWrapperGroups(content, wrapperGroups);
+	return nestInlineWrapperGroups(content, wrapperGroups, sourceHyperlinkIndices);
 }
 function createTrackedChangeRun({ baseParagraphFormatting, inheritedFormatting, marks, node, paragraphMarkFormatting, paragraphMarkPrecedesStyle, styleResolver }) {
 	const formattingContext = {
@@ -1646,6 +1698,7 @@ function createEmptyHyperlink(attrs) {
 	if (attrs.target !== void 0) hyperlink.target = attrs.target;
 	if (attrs.history !== void 0) hyperlink.history = attrs.history;
 	if (attrs.docLocation !== void 0) hyperlink.docLocation = attrs.docLocation;
+	for (const stack of attrs._docxEmptyWrapperStacks ?? []) hyperlink.children.push(nestInlineWrappers(stack, []));
 	return hyperlink;
 }
 function getCommentMarkIds(marks) {
@@ -3298,6 +3351,9 @@ function convertPMTableCell(node, documentCounts, styleResolver = null) {
 		} else if (contentNode.type.name === "table") {
 			content.push(convertPMTable(contentNode, documentCounts, styleResolver));
 			previousStandaloneTextBox = null;
+		} else if (contentNode.type.name === "blockSdt") {
+			content.push(convertPMBlockSdt(contentNode, styleResolver));
+			previousStandaloneTextBox = null;
 		} else if (contentNode.type.name === "textBox") previousStandaloneTextBox = appendTextBoxBlock(content, contentNode, {
 			pendingPageBreaks: 0,
 			previousStandaloneTextBox,

package/dist/prosemirror/conversion/toProseDoc.js

@@ -486,6 +486,7 @@ function convertParagraph(paragraph, styleResolver, context, extraRunFormatting,
 					nextRunIdentityId
 				});
 				if (linkNodes.length === 0) {
+					const emptyWrapperStacks = emptyInlineWrapperStacks(content.children);
 					emptyHyperlinks ??= [];
 					emptyHyperlinks.push({
 						offset: inlineOffset,
@@ -495,7 +496,8 @@ function convertParagraph(paragraph, styleResolver, context, extraRunFormatting,
 						...content.rId !== void 0 ? { rId: content.rId } : {},
 						...content.target !== void 0 ? { target: content.target } : {},
 						...content.history !== void 0 ? { history: content.history } : {},
-						...content.docLocation !== void 0 ? { docLocation: content.docLocation } : {}
+						...content.docLocation !== void 0 ? { docLocation: content.docLocation } : {},
+						...emptyWrapperStacks.length === 0 ? {} : { _docxEmptyWrapperStacks: emptyWrapperStacks }
 					});
 					break;
 				}
@@ -667,6 +669,7 @@ function convertTrackedChange(change, markType, nextHyperlinkInstanceIndex, next
 			id: item.id,
 			displacedByCustomXml: item.displacedByCustomXml
 		}));
+		else if (item.type === "moveFromRangeStart" || item.type === "moveFromRangeEnd" || item.type === "moveToRangeStart" || item.type === "moveToRangeEnd") itemNodes.push(schema.node(MOVE_RANGE_BOUNDARY_NODE_NAME, { marker: item }));
 		else if (item.type === "preservedInline") itemNodes.push(preservedInlineNode(item));
 		else panic(`Unsupported tracked-run content: ${JSON.stringify(item)}`);
 		nodes.push(...withInlineWrapperMark(itemNodes, stack));
@@ -1035,6 +1038,7 @@ function blockHasMeaningfulContent(block) {
 	if (block.type === "preservedBlock") return true;
 	if (block.type === "bookmarkStart" || block.type === "bookmarkEnd") return true;
 	if (block.type === "table") return block.rows.some((row) => row.cells.some((cell) => tableCellHasMeaningfulContent(cell)));
+	if (block.type === "blockSdt") return true;
 	return block.content.some(paragraphContentHasMeaningfulContent);
 }
 function paragraphContentHasMeaningfulContent(content) {
@@ -1394,28 +1398,35 @@ function convertTableCell({ cell, styleResolver, context, isHeader, gridWidthPer
 	}
 	if (preserveVMergeRestart) attrs._preserveVMergeRestart = true;
 	if (vMergeContinuationCells && vMergeContinuationCells.length > 0) attrs._docxVMergeContinuationCells = transportTableCellsWithParagraphPropertySources(vMergeContinuationCells);
-	const contentNodes = [];
-	for (const content of cell.content) switch (content.type) {
-		case "paragraph":
-			contentNodes.push(...convertParagraphWithTextBoxes(content, styleResolver, {
-				textBoxGroupId: context.nextTextBoxGroupId(),
-				context,
-				...conditionalStyle?.rPr !== void 0 ? { extraRunFormatting: conditionalStyle.rPr } : {},
-				...conditionalStyle?.pPr !== void 0 ? { tableParagraphOverlay: conditionalStyle.pPr } : {}
-			}));
-			break;
-		case "table":
-			contentNodes.push(convertTable(content, styleResolver, context));
-			break;
-		case "preservedBlock":
-			contentNodes.push(convertPreservedBlock(content));
-			break;
-		case "bookmarkStart":
-		case "bookmarkEnd":
-			contentNodes.push(convertBlockBookmarkBoundary(content));
-			break;
-		default: panic(`Unsupported table cell content: ${JSON.stringify(content)}`);
-	}
+	const convertCellBlocks = (blocks) => {
+		const nodes = [];
+		for (const block of blocks) switch (block.type) {
+			case "paragraph":
+				nodes.push(...convertParagraphWithTextBoxes(block, styleResolver, {
+					textBoxGroupId: context.nextTextBoxGroupId(),
+					context,
+					...conditionalStyle?.rPr !== void 0 ? { extraRunFormatting: conditionalStyle.rPr } : {},
+					...conditionalStyle?.pPr !== void 0 ? { tableParagraphOverlay: conditionalStyle.pPr } : {}
+				}));
+				break;
+			case "table":
+				nodes.push(convertTable(block, styleResolver, context));
+				break;
+			case "blockSdt":
+				nodes.push(convertBlockSdt(block, convertCellBlocks));
+				break;
+			case "preservedBlock":
+				nodes.push(convertPreservedBlock(block));
+				break;
+			case "bookmarkStart":
+			case "bookmarkEnd":
+				nodes.push(convertBlockBookmarkBoundary(block));
+				break;
+			default: panic(`Unsupported table cell content: ${JSON.stringify(block)}`);
+		}
+		return nodes;
+	};
+	const contentNodes = convertCellBlocks(cell.content);
 	if (contentNodes.length === 0) contentNodes.push(schema.node("paragraph", {}, []));
 	const nodeType = isHeader ? "tableHeader" : "tableCell";
 	return schema.node(nodeType, attrs, contentNodes);
@@ -1527,27 +1538,32 @@ const withInlineWrapperStacks = (content, stack = []) => content.flatMap((item)
 	content: item,
 	stack
 }]);
-/**
-* `nodes` with `stack` recorded outside whatever wrapper they already carry.
-*
-* A revision converts its own content first, so a node that arrives here
-* already marked sat inside the item this stack wraps: the two stacks
-* concatenate, outermost first. Concatenating is what the schema forces — the
-* mark excludes itself, so a second one replaces the first, and the inner
-* wrapper would be the one lost.
-*
-* A node that holds its own leaves, a content control, is marked here as the
-* one node it is; its leaves were marked with the whole enclosing stack when
-* it was built, because the painter reads the wrapper off the leaf.
-*/
-const withInlineWrapperMark = (nodes, stack) => {
+/** Wrapper nests with no leaf to carry their stack as a ProseMirror mark. */
+const emptyInlineWrapperStacks = (content, stack = []) => content.flatMap((item) => {
+	if (item.type !== "inlineWrapper") return [];
+	const nested = [...stack, inlineWrapperLayer(item)];
+	return item.content.length === 0 ? [nested] : emptyInlineWrapperStacks(item.content, nested);
+});
+const withInlineWrapperMark = (nodes, stack, origin) => {
 	const markType = schema.marks["inlineWrapper"];
 	if (stack.length === 0 || !markType) return nodes;
 	return nodes.map((node) => {
-		if (!node.isText && (!node.isInline || !node.type.allowsMarkType(markType))) return node;
+		if (!node.isInline) return node;
 		const inner = node.marks.find((mark) => mark.type === markType);
-		const layers = inner === void 0 ? stack : [...stack, ...expectInlineWrapperMarkAttrs(inner).stack];
-		return node.mark(markType.create({ stack: layers }).addToSet(node.marks));
+		const innerAttrs = inner === void 0 ? void 0 : expectInlineWrapperMarkAttrs(inner);
+		const layers = innerAttrs === void 0 ? stack : [...stack, ...innerAttrs.stack];
+		const inheritedOrigin = typeof innerAttrs?._docxHyperlinkIndex !== "number" || typeof innerAttrs._docxInsideHyperlinkStackStart !== "number" ? void 0 : {
+			hyperlinkIndex: innerAttrs._docxHyperlinkIndex,
+			stackStart: stack.length + innerAttrs._docxInsideHyperlinkStackStart
+		};
+		const provenance = origin ?? inheritedOrigin;
+		return node.mark(markType.create({
+			stack: layers,
+			...provenance === void 0 ? {} : {
+				_docxHyperlinkIndex: provenance.hyperlinkIndex,
+				_docxInsideHyperlinkStackStart: provenance.stackStart
+			}
+		}).addToSet(node.marks));
 	});
 };
 /**
@@ -1570,9 +1586,17 @@ function convertMathEquation(math) {
 function convertInlineSdt(sdt, nextHyperlinkInstanceIndex, nextRunIdentityId, getInheritedRunFormatting, trackedRunFormattingResolvers, styleResolver, textBoxAnchors, wrappedBy = []) {
 	const props = sdt.properties;
 	const inlineNodes = [];
-	for (const { content, stack } of withInlineWrapperStacks(sdt.content, wrappedBy)) {
+	const stacked = withInlineWrapperStacks(sdt.content, wrappedBy);
+	const emptyRanges = planEmptyRanges(stacked.map(({ content }) => content));
+	for (const [index, { content, stack }] of stacked.entries()) {
 		if (!isInlineSdtContent(content)) continue;
 		const itemNodes = [];
+		const anchored = emptyRanges.anchorAt.get(index);
+		if (anchored) {
+			inlineNodes.push(...withInlineWrapperMark([schema.node(RANGE_ANCHOR_NODE_NAME, anchored)], stack));
+			continue;
+		}
+		if (emptyRanges.closedAt.has(index)) continue;
 		switch (content.type) {
 			case "run":
 				itemNodes.push(...convertRun(content, getInheritedRunFormatting(content.formatting), nextRunIdentityId, styleResolver, textBoxAnchors));
@@ -1633,6 +1657,12 @@ function convertInlineSdt(sdt, nextHyperlinkInstanceIndex, nextRunIdentityId, ge
 					displacedByCustomXml: content.displacedByCustomXml
 				}));
 				break;
+			case "moveFromRangeStart":
+			case "moveFromRangeEnd":
+			case "moveToRangeStart":
+			case "moveToRangeEnd":
+				itemNodes.push(schema.node(MOVE_RANGE_BOUNDARY_NODE_NAME, { marker: content }));
+				break;
 			case "preservedInline":
 				itemNodes.push(preservedInlineNode(content));
 				break;
@@ -2331,7 +2361,10 @@ function convertHyperlink(hyperlink, { getInheritedRunFormatting, styleResolver,
 			}
 			default: break;
 		}
-		nodes.push(...withInlineWrapperMark(childNodes, stack));
+		nodes.push(...withInlineWrapperMark(childNodes, stack, {
+			hyperlinkIndex,
+			stackStart: 0
+		}));
 	}
 	return nodes;
 }

package/dist/prosemirror/extensions/marks/HyperlinkExtension.js

@@ -7,6 +7,7 @@ import { panic } from "better-result";
 /**
 * Hyperlink Mark Extension
 */
+const DOCX_HYPERLINK_INDEX_ATTRIBUTE = "data-docx-hyperlink-index";
 /**
 * Sanitize an href arriving from (or being emitted to) the DOM: pasted HTML,
 * clipboard content, or a mark attr already stored on the document. Only
@@ -90,19 +91,25 @@ const HyperlinkExtension = createMarkExtension({
 		inclusive: false,
 		parseDOM: [{
 			tag: "a[href]",
-			getAttrs: (dom) => ({
-				href: sanitizeStoredHref(dom.getAttribute("href") ?? void 0),
-				tooltip: dom.getAttribute("title") ?? void 0,
-				target: dom.getAttribute("target") ?? void 0
-			})
+			getAttrs: (dom) => {
+				const index = dom.getAttribute(DOCX_HYPERLINK_INDEX_ATTRIBUTE);
+				const docxHyperlinkIndex = index !== null && /^\d+$/u.test(index) && Number.isSafeInteger(Number(index)) ? Number(index) : void 0;
+				return {
+					href: sanitizeStoredHref(dom.getAttribute("href") ?? void 0),
+					tooltip: dom.getAttribute("title") ?? void 0,
+					target: dom.getAttribute("target") ?? void 0,
+					...docxHyperlinkIndex === void 0 ? {} : { _docxHyperlinkIndex: docxHyperlinkIndex }
+				};
+			}
 		}],
 		toDOM(mark) {
-			const { href, target, tooltip } = expectHyperlinkMarkAttrs(mark);
+			const { href, target, tooltip, _docxHyperlinkIndex } = expectHyperlinkMarkAttrs(mark);
 			const domAttrs = {
 				href: sanitizeStoredHref(href),
 				...anchorTargetAttrs(target)
 			};
 			if (tooltip) domAttrs["title"] = tooltip;
+			if (typeof _docxHyperlinkIndex === "number") domAttrs[DOCX_HYPERLINK_INDEX_ATTRIBUTE] = String(_docxHyperlinkIndex);
 			return [
 				"a",
 				domAttrs,