@stll/folio-core 0.45.0 → 0.47.0

package/dist/prosemirror/extensions/features/ListExtension.js

@@ -1,8 +1,11 @@
-import { isNumberingReference } from "../../../docx/numberingReference.js";
+import { isBulletLevel } from "../../../docx/numberingParser.js";
+import { NO_PARAGRAPH_NUMBERING, paragraphNumberingLevel, paragraphNumberingReference, paragraphNumberingReferenceId } from "../../../docx/numberingReference.js";
 import { expectParagraphAttrs } from "../../attrs/index.js";
 import { PPR_CHANGE_SCOPED_ATTR_KEYS, hasSerializableParagraphPropertyChange } from "../../commands/propertyChangeScope.js";
 import { CLEARED_LIST_RENDERING_ATTRS } from "../../listMarker.js";
 import { LIST_RENDERING_ATTR_KEYS } from "../../listRenderingAttrs.js";
+import { resolveListState } from "../../listState.js";
+import { paragraphNumberingAttr } from "../../numberingAttr.js";
 import { getDocumentNumbering } from "../../plugins/documentNumbering.js";
 import { SUGGESTION_META, makeRevisionInfo } from "../../plugins/suggestionMode.js";
 import { listLevelAttrPatch } from "../../styles/resolvedStyleAttrs.js";
@@ -49,11 +52,7 @@ function getPreviousListFormatting(attrs) {
 	return previousFormatting;
 }
 function clearListAttrs(attrs) {
-	const styleNumPr = attrs.numPrFromStyle;
-	const numPr = isNumberingReference(styleNumPr?.numId) ? {
-		numId: 0,
-		ilvl: attrs.numPr?.ilvl ?? styleNumPr?.ilvl ?? 0
-	} : null;
+	const numPr = paragraphNumberingReferenceId(attrs.numPrFromStyle) === void 0 ? null : paragraphNumberingAttr(NO_PARAGRAPH_NUMBERING);
 	return {
 		...attrs,
 		numPr,
@@ -61,14 +60,31 @@ function clearListAttrs(attrs) {
 	};
 }
 function hasActiveListNumbering(attrs) {
-	return isNumberingReference(attrs.numPr?.numId);
+	return attrs.numPr?.kind === "reference";
 }
-function toggleList(numId) {
+/**
+* The numbering instances Folio mints for its own toolbar lists. They are the
+* ids the autoformat rules and the list buttons create; a document Folio did
+* not create numbers its lists however its author did, which is why nothing
+* reads a list's kind off its id any more.
+*/
+const FOLIO_BULLET_NUM_ID = 1;
+const FOLIO_NUMBERED_NUM_ID = 2;
+const targetNumIdForIntent = (numbering, preferredNumId, ilvl, intent) => {
+	const matchesIntent = (numId) => {
+		const level = numbering?.getLevel(numId, ilvl) ?? null;
+		return level !== null && (isBulletLevel(level) ? "bullet" : "numbered") === intent;
+	};
+	if (matchesIntent(preferredNumId)) return preferredNumId;
+	return numbering?.definitions.nums.find(({ numId }) => matchesIntent(numId))?.numId ?? preferredNumId;
+};
+function toggleList(numId, intent) {
 	return (state, dispatch) => {
 		const { $from, $to } = state.selection;
 		const paragraph = $from.parent;
 		if (paragraph.type.name !== "paragraph") return false;
-		const isInSameList = paragraph.attrs["numPr"]?.numId === numId;
+		const numbering = getDocumentNumbering(state);
+		const isInSameList = resolveListState(numbering, expectParagraphAttrs(paragraph).numPr).type === intent;
 		const rev = makeRevisionInfo(state);
 		if (rev) {
 			let hasPendingChange = false;
@@ -89,16 +105,19 @@ function toggleList(numId) {
 				let nextAttrs;
 				if (isInSameList) nextAttrs = clearListAttrs(expectParagraphAttrs(node));
 				else {
-					const isBullet = numId === 1;
+					const ilvl = paragraphNumberingLevel(expectParagraphAttrs(node).numPr) ?? 0;
+					const targetNumId = targetNumIdForIntent(numbering, numId, ilvl, intent);
+					const definition = numbering?.getLevel(targetNumId, ilvl) ?? null;
+					const isBullet = definition === null ? intent === "bullet" : isBulletLevel(definition);
 					nextAttrs = {
 						...node.attrs,
 						...CLEARED_LIST_RENDERING_ATTRS,
-						numPr: {
-							numId,
-							ilvl: node.attrs["numPr"]?.ilvl || 0
-						},
+						numPr: paragraphNumberingAttr(paragraphNumberingReference({
+							numId: targetNumId,
+							ilvl
+						})),
 						listIsBullet: isBullet,
-						listNumFmt: isBullet ? null : "decimal"
+						listNumFmt: isBullet ? null : definition?.numFmt ?? "decimal"
 					};
 				}
 				if (rev) {
@@ -113,8 +132,8 @@ function toggleList(numId) {
 		return true;
 	};
 }
-const toggleBulletList = (state, dispatch) => toggleList(1)(state, dispatch);
-const toggleNumberedList = (state, dispatch) => toggleList(2)(state, dispatch);
+const toggleBulletList = (state, dispatch) => toggleList(FOLIO_BULLET_NUM_ID, "bullet")(state, dispatch);
+const toggleNumberedList = (state, dispatch) => toggleList(FOLIO_NUMBERED_NUM_ID, "numbered")(state, dispatch);
 const attrsForListLevel = (state, attrs, level) => {
 	if (!hasActiveListNumbering(attrs)) panic("Cannot change the level of a list without a numbering id");
 	return {
@@ -131,7 +150,7 @@ const increaseListLevel = (state, dispatch) => {
 	if (paragraph.type.name !== "paragraph") return false;
 	const attrs = expectParagraphAttrs(paragraph);
 	if (!hasActiveListNumbering(attrs)) return false;
-	const currentLevel = attrs.numPr.ilvl || 0;
+	const currentLevel = attrs.numPr.ilvl ?? 0;
 	if (currentLevel >= 8) return false;
 	if (!dispatch) return true;
 	const paragraphPos = $from.before($from.depth);
@@ -144,7 +163,7 @@ const decreaseListLevel = (state, dispatch) => {
 	if (paragraph.type.name !== "paragraph") return false;
 	const attrs = expectParagraphAttrs(paragraph);
 	if (!hasActiveListNumbering(attrs)) return false;
-	const currentLevel = attrs.numPr.ilvl || 0;
+	const currentLevel = attrs.numPr.ilvl ?? 0;
 	if (!dispatch) return true;
 	const paragraphPos = $from.before($from.depth);
 	if (currentLevel <= 0) dispatch(state.tr.setNodeMarkup(paragraphPos, void 0, {
@@ -184,7 +203,7 @@ function getListInfo(state) {
 	if (!hasActiveListNumbering(attrs)) return null;
 	return {
 		numId: attrs.numPr.numId,
-		ilvl: attrs.numPr.ilvl || 0
+		ilvl: attrs.numPr.ilvl ?? 0
 	};
 }
 function exitListOnEmptyEnter() {
@@ -240,7 +259,7 @@ function increaseListIndent() {
 			if (node.type.name === "paragraph") {
 				const attrs = expectParagraphAttrs(node);
 				if (!hasActiveListNumbering(attrs)) return;
-				if ((attrs.numPr?.ilvl ?? 0) < 8) positions.push({
+				if ((attrs.numPr.ilvl ?? 0) < 8) positions.push({
 					pos,
 					attrs
 				});
@@ -249,7 +268,7 @@ function increaseListIndent() {
 		if (positions.length === 0) return false;
 		if (dispatch) {
 			let tr = state.tr;
-			for (const { pos, attrs } of positions) tr = tr.setNodeMarkup(pos, void 0, attrsForListLevel(state, attrs, (attrs.numPr?.ilvl ?? 0) + 1));
+			for (const { pos, attrs } of positions) tr = tr.setNodeMarkup(pos, void 0, attrsForListLevel(state, attrs, (attrs.numPr.ilvl ?? 0) + 1));
 			dispatch(tr);
 		}
 		return true;
@@ -272,7 +291,7 @@ function decreaseListIndent() {
 		if (dispatch) {
 			let tr = state.tr;
 			for (const { pos, attrs } of positions) {
-				const currentLevel = attrs.numPr?.ilvl ?? 0;
+				const currentLevel = attrs.numPr.ilvl ?? 0;
 				if (currentLevel <= 0) tr = tr.setNodeMarkup(pos, void 0, {
 					...clearListAttrs(attrs),
 					indentLeft: null,
@@ -318,7 +337,7 @@ const listAutoformat = (marker, toggleCommand) => new InputRule(marker, (state,
 	const { $from } = state.selection;
 	if ($from.parent.type.name !== "paragraph") return null;
 	if (start !== $from.start()) return null;
-	if (expectParagraphAttrs($from.parent).numPr?.numId) return null;
+	if (paragraphNumberingReferenceId(expectParagraphAttrs($from.parent).numPr) !== void 0) return null;
 	if (makeRevisionInfo(state)) return null;
 	const toggled = captureTransaction(toggleCommand, state);
 	if (!toggled) return null;

package/dist/prosemirror/extensions/features/ParaIdAllocatorExtension.js

@@ -322,6 +322,7 @@ const createParaIdAllocatorPlugin = () => new Plugin({
 		ignoreTrackedChanges(tr);
 		tr.setMeta(paraIdAllocatorKey, "allocated");
 		tr.setMeta("addToHistory", false);
+		if (newState.storedMarks !== null) tr.setStoredMarks(newState.storedMarks);
 		return tr;
 	}
 });

package/dist/prosemirror/extensions/features/ParagraphChangeTrackerExtension.js

@@ -1,4 +1,5 @@
 import { canonicalJson } from "../../../utils/canonicalJson.js";
+import { sectionPropertiesOf } from "../../sectionCarrier.js";
 import { createExtension } from "../create.js";
 import { AddMarkStep, AddNodeMarkStep, AttrStep, RemoveMarkStep, RemoveNodeMarkStep } from "prosemirror-transform";
 import { Plugin, PluginKey } from "prosemirror-state";
@@ -22,13 +23,13 @@ function countDocumentStructure(doc) {
 		parent.forEach((node, _offset, index) => {
 			if (node.type.name === "paragraph") {
 				paragraphs++;
-				if (node.attrs["_sectionProperties"] != null || node.attrs["sectionBreakType"] != null) {
+				const sectionProperties = sectionPropertiesOf(node);
+				if (sectionProperties !== null) {
 					sectionEndpoints++;
 					endpointRecords.push({
 						path: parentPath.length === 0 ? `${index}` : `${parentPath}.${index}`,
 						paraId: node.attrs["paraId"] ?? null,
-						sectionBreakType: node.attrs["sectionBreakType"] ?? null,
-						sectionProperties: node.attrs["_sectionProperties"] ?? null
+						sectionProperties
 					});
 				}
 				return;

package/dist/prosemirror/extensions/features/PasteCleanupExtension.d.ts

@@ -11,9 +11,9 @@ import { Extension } from "../types.js";
  *    default clipboard parser; ProseMirror chains every plugin's
  *    `transformPastedHTML`, so this cooperates with the inliner rather than
  *    replacing it, and `<style>` blocks are left intact for it to resolve.
- * 2. `transformPasted` — drops unpaired bookmark boundaries, then points
- *    pasted headings at the open document's own heading style (see
- *    {@link retargetPastedHeadingStyles}).
+ * 2. `transformPasted` — drops unpaired bookmark and move-range boundaries,
+ *    then points pasted headings at the open document's own heading style
+ *    (see {@link retargetPastedHeadingStyles}).
  * 3. `Mod-Alt-v` — "paste without formatting", inserting clipboard text with
  *    the source formatting stripped (see {@link pasteWithoutFormatting}).
  */

package/dist/prosemirror/extensions/features/PasteCleanupExtension.js

@@ -1,7 +1,7 @@
 import { pasteWithoutFormatting } from "../../commands/pastePlainText.js";
 import { createExtension } from "../create.js";
 import { Priority } from "../types.js";
-import { cleanPastedHtml, removeUnpairedBookmarkBoundaries } from "./pasteCleanup.js";
+import { cleanPastedHtml, removeUnpairedBookmarkBoundaries, removeUnpairedMoveRangeBoundaries } from "./pasteCleanup.js";
 import { retargetPastedHeadingStyles } from "./pastedHeadingStyles.js";
 import { Plugin } from "prosemirror-state";
 //#region src/prosemirror/extensions/features/PasteCleanupExtension.ts
@@ -16,9 +16,9 @@ import { Plugin } from "prosemirror-state";
 *    default clipboard parser; ProseMirror chains every plugin's
 *    `transformPastedHTML`, so this cooperates with the inliner rather than
 *    replacing it, and `<style>` blocks are left intact for it to resolve.
-* 2. `transformPasted` — drops unpaired bookmark boundaries, then points
-*    pasted headings at the open document's own heading style (see
-*    {@link retargetPastedHeadingStyles}).
+* 2. `transformPasted` — drops unpaired bookmark and move-range boundaries,
+*    then points pasted headings at the open document's own heading style
+*    (see {@link retargetPastedHeadingStyles}).
 * 3. `Mod-Alt-v` — "paste without formatting", inserting clipboard text with
 *    the source formatting stripped (see {@link pasteWithoutFormatting}).
 */
@@ -32,7 +32,7 @@ const PasteCleanupExtension = createExtension({
 					const internalClipboardToken = options.getInternalClipboardToken?.();
 					return cleanPastedHtml(html, { ...internalClipboardToken ? { internalClipboardToken } : {} });
 				},
-				transformPasted: (slice, view) => retargetPastedHeadingStyles(removeUnpairedBookmarkBoundaries(slice), view)
+				transformPasted: (slice, view) => retargetPastedHeadingStyles(removeUnpairedMoveRangeBoundaries(removeUnpairedBookmarkBoundaries(slice)), view)
 			} })],
 			keyboardShortcuts: { "Mod-Alt-v": pasteWithoutFormatting }
 		};

package/dist/prosemirror/extensions/features/pasteCleanup.d.ts

@@ -14,5 +14,7 @@ type CleanPastedHtmlOptions = {
 declare function cleanPastedHtml(html: string, options?: CleanPastedHtmlOptions): string;
 /** Remove incomplete or duplicate bookmark pairs at copied slice edges. */
 declare function removeUnpairedBookmarkBoundaries(slice: Slice): Slice;
+/** Remove incomplete, duplicate, or reversed tracked-move pairs at copied slice edges. */
+declare function removeUnpairedMoveRangeBoundaries(slice: Slice): Slice;
 //#endregion
-export { cleanPastedHtml, removeUnpairedBookmarkBoundaries };
+export { cleanPastedHtml, removeUnpairedBookmarkBoundaries, removeUnpairedMoveRangeBoundaries };

package/dist/prosemirror/extensions/features/pasteCleanup.js

@@ -2,6 +2,7 @@ import { htmlCommentEnd } from "../../../utils/htmlComments.js";
 import { stripXmlDeclarations } from "../../../utils/stripXmlDeclarations.js";
 import { readBookmarkBoundaryAttrs } from "../../bookmarkBoundaryAttrs.js";
 import { findInvalidBookmarkBoundaryIds } from "../../bookmarkBoundaryIntegrity.js";
+import { readMoveRangeBoundaryAttrs } from "../../moveRangeBoundaryAttrs.js";
 import { Fragment, Slice } from "prosemirror-model";
 //#region src/prosemirror/extensions/features/pasteCleanup.ts
 /**
@@ -124,6 +125,8 @@ const MAX_EMPTY_SPAN_PASSES = 5;
 const INTERNAL_CLIPBOARD_ATTR_PATTERN = /\s+data-docx-internal-clipboard(?:="([^"]*)"|='([^']*)'|=([^\s>]+))?/gi;
 const TEXTBOX_ANCHOR_ATTR = /\s+data-docx-textbox-anchor(?:="[^"]*"|='[^']*')?/gi;
 const BOOKMARK_BOUNDARY_ATTR = /\s+data-docx-bookmark-(?:boundary|id|name|col-first|col-last)(?:="[^"]*"|='[^']*'|=[^\s>]+)?/gi;
+const RANGE_ANCHOR_ATTR = /\s+data-docx-range-anchor(?:="[^"]*"|='[^']*'|=[^\s>]+)?/gi;
+const MOVE_RANGE_BOUNDARY_ATTR = /\s+data-docx-move-range-boundary(?:="[^"]*"|='[^']*'|=[^\s>]+)?/gi;
 const STRUCTURED_FIELD_ATTR = /\s+data-field-structured(?:="[^"]*"|='[^']*'|=[^\s>]+)?/gi;
 /**
 * Treat reconstruction attributes as internal only when the HTML carries the
@@ -144,6 +147,10 @@ function stripForeignBookmarkBoundaries(html, internal) {
 	if (internal) return html;
 	return html.replace(BOOKMARK_BOUNDARY_ATTR, "");
 }
+function stripForeignRangeCarriers(html, internal) {
+	if (internal) return html;
+	return html.replace(RANGE_ANCHOR_ATTR, "").replace(MOVE_RANGE_BOUNDARY_ATTR, "");
+}
 function stripForeignStructuredFields(html, internal) {
 	if (internal) return html;
 	return html.replace(STRUCTURED_FIELD_ATTR, "");
@@ -158,7 +165,7 @@ function stripEmptySpans(html, preserveInternalAtoms) {
 	let current = html;
 	for (let pass = 0; pass < MAX_EMPTY_SPAN_PASSES; pass++) {
 		const next = current.replace(EMPTY_SPAN, (span) => {
-			if (preserveInternalAtoms && /\bdata-docx-(?:bookmark-boundary|textbox-anchor)\s*=/i.test(span)) return span;
+			if (preserveInternalAtoms && /\bdata-docx-(?:bookmark-boundary|textbox-anchor|range-anchor|move-range-boundary)\s*=/i.test(span)) return span;
 			return "";
 		});
 		if (next === current) break;
@@ -179,6 +186,7 @@ function cleanPastedHtml(html, options = {}) {
 		cleaned = stripEmptySpans(cleaned, internal);
 		cleaned = stripForeignTextBoxAnchors(cleaned, internal);
 		cleaned = stripForeignBookmarkBoundaries(cleaned, internal);
+		cleaned = stripForeignRangeCarriers(cleaned, internal);
 		cleaned = stripForeignStructuredFields(cleaned, internal);
 		cleaned = cleaned.replace(INTERNAL_CLIPBOARD_ATTR_PATTERN, "");
 		return cleaned.trim();
@@ -218,5 +226,51 @@ function removeUnpairedBookmarkBoundaries(slice) {
 	};
 	return new Slice(filterFragment(slice.content), slice.openStart, slice.openEnd);
 }
+const moveRangeKey = (marker) => {
+	return `${marker.type.startsWith("moveFrom") ? "moveFrom" : "moveTo"}:${marker.id}`;
+};
+const moveRangeBoundaryType = (marker) => marker.type.endsWith("Start") ? "start" : "end";
+/** Remove incomplete, duplicate, or reversed tracked-move pairs at copied slice edges. */
+function removeUnpairedMoveRangeBoundaries(slice) {
+	const summaries = /* @__PURE__ */ new Map();
+	const malformedNodes = /* @__PURE__ */ new Set();
+	let boundaryIndex = 0;
+	slice.content.descendants((node) => {
+		if (node.type.name !== "moveRangeBoundary") return true;
+		const result = readMoveRangeBoundaryAttrs(node);
+		if (!result.ok) {
+			malformedNodes.add(node);
+			return false;
+		}
+		const key = moveRangeKey(result.value);
+		const summary = summaries.get(key) ?? {
+			startPositions: [],
+			endPositions: []
+		};
+		summary[moveRangeBoundaryType(result.value) === "start" ? "startPositions" : "endPositions"].push(boundaryIndex);
+		summaries.set(key, summary);
+		boundaryIndex += 1;
+		return false;
+	});
+	const invalidKeys = /* @__PURE__ */ new Set();
+	for (const [key, { startPositions, endPositions }] of summaries) {
+		const start = startPositions.at(0);
+		const end = endPositions.at(0);
+		if (startPositions.length !== 1 || endPositions.length !== 1 || start === void 0 || end === void 0 || start >= end) invalidKeys.add(key);
+	}
+	const filterFragment = (fragment) => {
+		const children = [];
+		fragment.forEach((node) => {
+			if (node.type.name === "moveRangeBoundary") {
+				const result = readMoveRangeBoundaryAttrs(node);
+				if (result.ok && !malformedNodes.has(node) && !invalidKeys.has(moveRangeKey(result.value))) children.push(node);
+				return;
+			}
+			children.push(node.childCount === 0 ? node : node.copy(filterFragment(node.content)));
+		});
+		return Fragment.fromArray(children);
+	};
+	return new Slice(filterFragment(slice.content), slice.openStart, slice.openEnd);
+}
 //#endregion
-export { cleanPastedHtml, removeUnpairedBookmarkBoundaries };
+export { cleanPastedHtml, removeUnpairedBookmarkBoundaries, removeUnpairedMoveRangeBoundaries };

package/dist/prosemirror/extensions/features/pastedHeadingStyles.js

@@ -1,5 +1,6 @@
-import { isHeadingOutlineLevel } from "../../../docx/builtInStyles.js";
+import { readOutlineLevelAttr } from "../../outlineLevelAttr.js";
 import { getDocumentBuiltInStyles, getDocumentStyleResolver } from "../../plugins/documentStyles.js";
+import { headingLevelOf } from "@stll/docx-core/model";
 import { Fragment, Slice } from "prosemirror-model";
 //#region src/prosemirror/extensions/features/pastedHeadingStyles.ts
 /**
@@ -39,11 +40,11 @@ const nearestHeadingStyleId = (outlineLevel, styles) => {
 const retargetedStyleId = (node, view) => {
 	const styleId = node.attrs["styleId"];
 	if (typeof styleId !== "string") return;
-	const outlineLevel = node.attrs["outlineLevel"];
-	if (typeof outlineLevel !== "number" || !isHeadingOutlineLevel(outlineLevel)) return;
+	const headingLevel = headingLevelOf(readOutlineLevelAttr(node.attrs["outlineLevel"]));
+	if (headingLevel === void 0) return;
 	const resolver = getDocumentStyleResolver(view.state);
 	if (resolver === null || resolver.getStyle(styleId) !== void 0) return;
-	const target = nearestHeadingStyleId(outlineLevel, getDocumentBuiltInStyles(view.state));
+	const target = nearestHeadingStyleId(headingLevel, getDocumentBuiltInStyles(view.state));
 	return target === styleId ? void 0 : target;
 };
 const retargetFragment = (fragment, view) => {

package/dist/prosemirror/extensions/markRegistry.d.ts

@@ -0,0 +1,65 @@
+import { MarkExtension } from "./types.js";
+//#region src/prosemirror/extensions/markRegistry.d.ts
+declare const MARK_EXTENSIONS: {
+  readonly bold: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+  readonly italic: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+  readonly underline: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+  readonly strike: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+  readonly textColor: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+  readonly runShading: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+  readonly highlight: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+  readonly fontSize: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+  readonly fontFamily: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+  readonly language: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+  readonly superscript: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+  readonly subscript: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+  readonly hyperlink: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+  readonly allCaps: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+  readonly smallCaps: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+  readonly footnoteRef: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+  readonly characterSpacing: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+  readonly emboss: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+  readonly imprint: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+  readonly hidden: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+  readonly textShadow: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+  readonly emphasisMark: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+  readonly textOutline: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+  readonly rtl: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+  readonly textEffect: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+  readonly runFormattingOverride: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+  readonly characterStyle: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+  readonly runIdentity: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+  readonly comment: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+  readonly insertion: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+  readonly deletion: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+  readonly runPropertyChange: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+  readonly inlineWrapper: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+};
+/** A mark the editor schema declares. */
+type SchemaMarkName = keyof typeof MARK_EXTENSIONS;
+/**
+ * Outermost first: the order the editor registers marks in, which is the order
+ * it nests their DOM elements in.
+ *
+ * Five of these marks are containers on the save leg as well, and their
+ * relative order is that leg's rather than a choice made here.
+ * `extractParagraphContent` opens a comment range around everything a leaf
+ * produces (it flushes the open run and hyperlink and drops the tracked wrapper
+ * before pushing the marker: `fromProseDoc.ts:2359-2369`), then the revision
+ * wrapper (`fromProseDoc.ts:2530`), then the wrapper stack inside that revision
+ * (`nestInlineWrapperGroups`, `fromProseDoc.ts:2200`), then the hyperlink and
+ * the runs it holds (`fromProseDoc.ts:2567`). So the save writes
+ * `w:commentRangeStart … w:ins > w:bdo > w:hyperlink > w:r`, and the editor DOM
+ * nests `span.docx-comment > span.docx-insertion > bdo > a`.
+ * `markNestingOrder.test.ts` holds the two legs to each other.
+ *
+ * `runIdentity` is the fifth: `w:r` is the element it names, and it is the
+ * innermost element that leg emits.
+ *
+ * Every other mark is a run property or run content: it has no element of its
+ * own in OOXML, so the save leg ranks it against nothing and its place here is
+ * a presentation decision.
+ */
+declare const MARK_NESTING_ORDER: readonly ["bold", "italic", "underline", "strike", "textColor", "runShading", "highlight", "fontSize", "fontFamily", "language", "superscript", "subscript", "allCaps", "smallCaps", "footnoteRef", "characterSpacing", "emboss", "imprint", "hidden", "textShadow", "emphasisMark", "textOutline", "rtl", "textEffect", "runFormattingOverride", "characterStyle", "comment", "insertion", "deletion", "inlineWrapper", "hyperlink", "runPropertyChange", "runIdentity"];
+//#endregion
+export { MARK_EXTENSIONS, MARK_NESTING_ORDER, SchemaMarkName };

package/dist/prosemirror/extensions/markRegistry.js

@@ -0,0 +1,138 @@
+import { AllCapsExtension } from "./marks/AllCapsExtension.js";
+import { BoldExtension } from "./marks/BoldExtension.js";
+import { CharacterSpacingExtension } from "./marks/CharacterSpacingExtension.js";
+import { CharacterStyleExtension } from "./marks/CharacterStyleExtension.js";
+import { CommentExtension } from "./marks/CommentExtension.js";
+import { FontFamilyExtension } from "./marks/FontFamilyExtension.js";
+import { FontSizeExtension } from "./marks/FontSizeExtension.js";
+import { FootnoteRefExtension } from "./marks/FootnoteRefExtension.js";
+import { HiddenTextExtension } from "./marks/HiddenTextExtension.js";
+import { HighlightExtension } from "./marks/HighlightExtension.js";
+import { HyperlinkExtension } from "./marks/HyperlinkExtension.js";
+import { InlineWrapperExtension } from "./marks/InlineWrapperExtension.js";
+import { ItalicExtension } from "./marks/ItalicExtension.js";
+import { LanguageExtension } from "./marks/LanguageExtension.js";
+import { RtlExtension } from "./marks/RtlExtension.js";
+import { RunFormattingOverrideExtension } from "./marks/RunFormattingOverrideExtension.js";
+import { RunIdentityExtension } from "./marks/RunIdentityExtension.js";
+import { RunShadingExtension } from "./marks/RunShadingExtension.js";
+import { SmallCapsExtension } from "./marks/SmallCapsExtension.js";
+import { StrikeExtension } from "./marks/StrikeExtension.js";
+import { SubscriptExtension } from "./marks/SubscriptExtension.js";
+import { SuperscriptExtension } from "./marks/SuperscriptExtension.js";
+import { TextColorExtension } from "./marks/TextColorExtension.js";
+import { TextEffectExtension } from "./marks/TextEffectExtension.js";
+import { EmbossExtension, EmphasisMarkExtension, ImprintExtension, TextOutlineExtension, TextShadowExtension } from "./marks/TextEffectsExtensions.js";
+import { DeletionExtension, InsertionExtension, RunPropertyChangeExtension } from "./marks/TrackedChangeExtensions.js";
+import { UnderlineExtension } from "./marks/UnderlineExtension.js";
+//#region src/prosemirror/extensions/markRegistry.ts
+/**
+* Every mark the editor schema declares, and the order they nest in.
+*
+* `StarterKit` builds the schema from this record and from nothing else, so
+* `SchemaMarkName` is the set of marks that exist rather than a list beside it
+* — a table that must decide something per mark (what the painter does with
+* it) can be checked total against this union, and a mark added without that
+* decision does not compile.
+*
+* The record answers which marks exist and how each is built; its key order
+* answers nothing. `MARK_NESTING_ORDER` is the registration order, and
+* registration order is DOM nesting order.
+*/
+const MARK_EXTENSIONS = {
+	bold: BoldExtension,
+	italic: ItalicExtension,
+	underline: UnderlineExtension,
+	strike: StrikeExtension,
+	textColor: TextColorExtension,
+	runShading: RunShadingExtension,
+	highlight: HighlightExtension,
+	fontSize: FontSizeExtension,
+	fontFamily: FontFamilyExtension,
+	language: LanguageExtension,
+	superscript: SuperscriptExtension,
+	subscript: SubscriptExtension,
+	hyperlink: HyperlinkExtension,
+	allCaps: AllCapsExtension,
+	smallCaps: SmallCapsExtension,
+	footnoteRef: FootnoteRefExtension,
+	characterSpacing: CharacterSpacingExtension,
+	emboss: EmbossExtension,
+	imprint: ImprintExtension,
+	hidden: HiddenTextExtension,
+	textShadow: TextShadowExtension,
+	emphasisMark: EmphasisMarkExtension,
+	textOutline: TextOutlineExtension,
+	rtl: RtlExtension,
+	textEffect: TextEffectExtension,
+	runFormattingOverride: RunFormattingOverrideExtension,
+	characterStyle: CharacterStyleExtension,
+	runIdentity: RunIdentityExtension,
+	comment: CommentExtension,
+	insertion: InsertionExtension,
+	deletion: DeletionExtension,
+	runPropertyChange: RunPropertyChangeExtension,
+	inlineWrapper: InlineWrapperExtension
+};
+/** The order, rejected unless it names every mark; a repeat is the test's. */
+const markNestingOrder = (names) => names;
+/**
+* Outermost first: the order the editor registers marks in, which is the order
+* it nests their DOM elements in.
+*
+* Five of these marks are containers on the save leg as well, and their
+* relative order is that leg's rather than a choice made here.
+* `extractParagraphContent` opens a comment range around everything a leaf
+* produces (it flushes the open run and hyperlink and drops the tracked wrapper
+* before pushing the marker: `fromProseDoc.ts:2359-2369`), then the revision
+* wrapper (`fromProseDoc.ts:2530`), then the wrapper stack inside that revision
+* (`nestInlineWrapperGroups`, `fromProseDoc.ts:2200`), then the hyperlink and
+* the runs it holds (`fromProseDoc.ts:2567`). So the save writes
+* `w:commentRangeStart … w:ins > w:bdo > w:hyperlink > w:r`, and the editor DOM
+* nests `span.docx-comment > span.docx-insertion > bdo > a`.
+* `markNestingOrder.test.ts` holds the two legs to each other.
+*
+* `runIdentity` is the fifth: `w:r` is the element it names, and it is the
+* innermost element that leg emits.
+*
+* Every other mark is a run property or run content: it has no element of its
+* own in OOXML, so the save leg ranks it against nothing and its place here is
+* a presentation decision.
+*/
+const MARK_NESTING_ORDER = markNestingOrder([
+	"bold",
+	"italic",
+	"underline",
+	"strike",
+	"textColor",
+	"runShading",
+	"highlight",
+	"fontSize",
+	"fontFamily",
+	"language",
+	"superscript",
+	"subscript",
+	"allCaps",
+	"smallCaps",
+	"footnoteRef",
+	"characterSpacing",
+	"emboss",
+	"imprint",
+	"hidden",
+	"textShadow",
+	"emphasisMark",
+	"textOutline",
+	"rtl",
+	"textEffect",
+	"runFormattingOverride",
+	"characterStyle",
+	"comment",
+	"insertion",
+	"deletion",
+	"inlineWrapper",
+	"hyperlink",
+	"runPropertyChange",
+	"runIdentity"
+]);
+//#endregion
+export { MARK_EXTENSIONS, MARK_NESTING_ORDER };

package/dist/prosemirror/extensions/marks/InlineWrapperExtension.d.ts

@@ -0,0 +1,18 @@
+import { MarkExtension } from "../types.js";
+//#region src/prosemirror/extensions/marks/InlineWrapperExtension.d.ts
+/**
+ * Inline wrapper mark — the transparent wrappers a leaf sits inside.
+ *
+ * One mark for every wrapper kind rather than one mark per kind: ProseMirror's
+ * mark set is unordered across types, so two marks could not say which wrapper
+ * is inside which. The nesting lives in the `stack` attr, outermost first, and
+ * the mark excludes itself (ProseMirror's default) because a second one would
+ * be a second answer to the same question.
+ *
+ * `inclusive: false` so typing at the end of a wrapped span does not silently
+ * extend the wrapper over text the author wrote outside it.
+ */
+declare const INLINE_WRAPPER_MARK_NAME = "inlineWrapper";
+declare const InlineWrapperExtension: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+//#endregion
+export { INLINE_WRAPPER_MARK_NAME, InlineWrapperExtension };