@stll/folio-core 0.11.0 → 0.13.0

package/dist/prosemirror/extensions/ExtensionManager.js

@@ -1,6 +1,6 @@
 import { panic } from "better-result";
-import { keymap } from "prosemirror-keymap";
 import { Schema } from "prosemirror-model";
+import { keymap } from "prosemirror-keymap";
 //#region src/prosemirror/extensions/ExtensionManager.ts
 /**
 * Extension Manager

package/dist/prosemirror/extensions/StarterKit.js

@@ -41,7 +41,7 @@ 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 } from "./marks/TrackedChangeExtensions.js";
+import { DeletionExtension, InsertionExtension, RunPropertyChangeExtension } from "./marks/TrackedChangeExtensions.js";
 import { UnderlineExtension } from "./marks/UnderlineExtension.js";
 import { BlockSdtExtension } from "./nodes/BlockSdtExtension.js";
 import { FieldExtension } from "./nodes/FieldExtension.js";
@@ -50,10 +50,12 @@ import { HorizontalRuleExtension } from "./nodes/HorizontalRuleExtension.js";
 import { ImageExtension } from "./nodes/ImageExtension.js";
 import { MathExtension } from "./nodes/MathExtension.js";
 import { PageBreakExtension } from "./nodes/PageBreakExtension.js";
+import { RenderedPageBreakExtension } from "./nodes/RenderedPageBreakExtension.js";
 import { SdtExtension } from "./nodes/SdtExtension.js";
 import { ShapeExtension } from "./nodes/ShapeExtension.js";
 import { TabExtension } from "./nodes/TabExtension.js";
 import { TextBoxExtension } from "./nodes/TextBoxExtension.js";
+import { TextBoxAnchorExtension } from "./nodes/TextBoxAnchorExtension.js";
 //#region src/prosemirror/extensions/StarterKit.ts
 /**
 * Create the full set of extensions for the DOCX editor
@@ -101,10 +103,12 @@ function createStarterKit(options = {}) {
 	add("comment", CommentExtension());
 	add("insertion", InsertionExtension());
 	add("deletion", DeletionExtension());
+	add("runPropertyChange", RunPropertyChangeExtension());
 	add("hardBreak", HardBreakExtension());
 	add("tab", TabExtension());
 	add("image", ImageExtension());
 	add("textBox", TextBoxExtension());
+	add("textBoxAnchor", TextBoxAnchorExtension());
 	add("shape", ShapeExtension());
 	add("imageDrag", ImageDragExtension());
 	add("imagePaste", ImagePasteExtension());
@@ -112,6 +116,7 @@ function createStarterKit(options = {}) {
 	add("gapCursor", GapCursorExtension());
 	add("horizontalRule", HorizontalRuleExtension());
 	add("pageBreak", PageBreakExtension());
+	add("renderedPageBreak", RenderedPageBreakExtension());
 	add("field", FieldExtension());
 	add("sdt", SdtExtension());
 	add("blockSdt", BlockSdtExtension());

package/dist/prosemirror/extensions/core/ParagraphExtension.js

@@ -1,6 +1,6 @@
-import { autospacingMatchesBase } from "../../autospacingBase.js";
 import { directionIsRtl } from "../../paragraphDirection.js";
 import { expectParagraphAttrs } from "../../attrs/index.js";
+import { autospacingMatchesBase } from "../../autospacingBase.js";
 import { createNodeExtension } from "../create.js";
 import { paragraphToStyle } from "../../../utils/formatToStyle.js";
 import { collectHeadings } from "../../../utils/headingCollector.js";
@@ -187,8 +187,10 @@ const paragraphNodeSpec = {
 		spaceAfter: { default: null },
 		lineSpacing: { default: null },
 		lineSpacingRule: { default: null },
+		snapToGrid: { default: null },
 		spacingExplicit: { default: null },
 		spacingFromDocDefaults: { default: null },
+		spacingFromImplicitDefaultStyle: { default: null },
 		indentLeft: { default: null },
 		indentRight: { default: null },
 		indentFirstLine: { default: null },
@@ -219,6 +221,7 @@ const paragraphNodeSpec = {
 		pageBreakBefore: { default: null },
 		renderedPageBreakBefore: { default: null },
 		_pageBreakCarrier: { default: null },
+		_trailingPageBreak: { default: null },
 		keepNext: { default: null },
 		keepLines: { default: null },
 		widowControl: { default: null },
@@ -234,7 +237,8 @@ const paragraphNodeSpec = {
 		_autospacingBase: { default: null },
 		_sectionProperties: { default: null },
 		_propertyChanges: { default: null },
-		pPrMark: { default: null }
+		pPrMark: { default: null },
+		_suggestedInsert: { default: null }
 	},
 	parseDOM: [{
 		tag: "p",

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

@@ -55,6 +55,7 @@ const INHERITED_PARA_ATTRS = [
 	"styleId",
 	"lineSpacing",
 	"lineSpacingRule",
+	"snapToGrid",
 	"spaceAfter",
 	"spaceBefore",
 	"contextualSpacing"

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

@@ -1,4 +1,5 @@
 import { createExtension } from "../create.js";
+import { sanitizeImageSrc } from "../../../utils/sanitizeImageSrc.js";
 import { getClipboardImageFiles } from "../../../utils/clipboard.js";
 import { isSafeImageFile } from "../../../utils/imageValidation.js";
 import { Plugin, TextSelection } from "prosemirror-state";
@@ -20,13 +21,18 @@ async function readFileAsDataUrl(file) {
 }
 async function loadImageSize(src) {
 	return await new Promise((resolve, reject) => {
+		const safeSrc = sanitizeImageSrc(src);
+		if (!safeSrc) {
+			reject(/* @__PURE__ */ new Error("Rejected unsafe image source"));
+			return;
+		}
 		const img = new Image();
 		img.addEventListener("load", () => resolve({
 			width: img.naturalWidth || 1,
 			height: img.naturalHeight || 1
 		}));
 		img.addEventListener("error", () => reject(/* @__PURE__ */ new Error("Failed to load pasted image")));
-		img.src = src;
+		img.src = safeSrc;
 	});
 }
 async function insertImageFiles(view, files) {
@@ -37,7 +43,9 @@ async function insertImageFiles(view, files) {
 		if (!await isSafeImageFile(file)) continue;
 		let dataUrl;
 		try {
-			dataUrl = await readFileAsDataUrl(file);
+			const safeSrc = sanitizeImageSrc(await readFileAsDataUrl(file));
+			if (!safeSrc) continue;
+			dataUrl = safeSrc;
 		} catch {
 			continue;
 		}

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

@@ -1,7 +1,7 @@
-import { PPR_CHANGE_SCOPED_ATTR_KEYS } from "../../commands/propertyChangeScope.js";
 import { Priority } from "../types.js";
 import { createExtension } from "../create.js";
 import { SUGGESTION_META, makeRevisionInfo } from "../../plugins/suggestionMode.js";
+import { PPR_CHANGE_SCOPED_ATTR_KEYS } from "../../commands/propertyChangeScope.js";
 import { goToNextCell, goToPrevCell } from "../nodes/TableExtension.js";
 //#region src/prosemirror/extensions/features/ListExtension.ts
 function chainCommands(...commands) {

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

@@ -1,9 +1,18 @@
 import { Extension } from "../types.js";
 import { EditorState, PluginKey } from "prosemirror-state";
+import { Node } from "prosemirror-model";
 
 //#region src/prosemirror/extensions/features/ParaIdAllocatorExtension.d.ts
 declare const paraIdAllocatorKey: PluginKey<any>;
+/**
+ * Allocate initial paragraph IDs before constructing editor state.
+ *
+ * Rebuilding only changed branches avoids applying one ProseMirror transaction
+ * step per missing paragraph. Live edits still use the transaction-based plugin
+ * below so history, mappings, and duplicate ownership retain their semantics.
+ */
+declare const ensureParaIdsInDoc: (doc: Node) => Node;
 declare const ensureParaIdsInState: (state: EditorState) => EditorState;
 declare const ParaIdAllocatorExtension: (options?: Partial<{}> | undefined) => Extension;
 //#endregion
-export { ParaIdAllocatorExtension, ensureParaIdsInState, paraIdAllocatorKey };
+export { ParaIdAllocatorExtension, ensureParaIdsInDoc, ensureParaIdsInState, paraIdAllocatorKey };

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

@@ -1,8 +1,46 @@
-import { generateHexId } from "../../../utils/hexId.js";
 import { createExtension } from "../create.js";
 import { ignoreTrackedChanges } from "./ParagraphChangeTrackerExtension.js";
+import { generateHexId } from "../../../utils/hexId.js";
+import { Fragment } from "prosemirror-model";
 import { Plugin, PluginKey } from "prosemirror-state";
 //#region src/prosemirror/extensions/features/ParaIdAllocatorExtension.ts
+/**
+* ParaIdAllocator — assigns a stable `w14:paraId` to every paragraph.
+*
+* Lifted from
+* https://github.com/eigenpal/docx-editor/blob/main/packages/core/src/prosemirror/extensions/features/ParaIdAllocatorExtension.ts
+* (Apache-2.0). Adapted to folio's `createExtension` + import style;
+* keep behaviour in sync upstream. folio divergences: duplicate
+* resolution maps the original paragraph's position through the
+* transaction (see below), and the appended allocation transaction is
+* excluded from paragraph change tracking like `ensureParaIdsInState`.
+*
+* Why: AI tooling, chat citation chips, and the change tracker all
+* anchor on `paraId`. A paragraph with `paraId: null` is invisible
+* to those surfaces; a duplicated paraId (the second half of an
+* Enter-split, or content pasted from another doc) silently desyncs
+* their anchors. This plugin closes both gaps by allocating fresh
+* ids in an `appendTransaction` hook after every doc-changed step.
+*
+* Id lifecycle rules (locked by the co-located tests):
+* - Missing/empty/reserved-zero id: a fresh random id is minted.
+* - Split: the half holding the paragraph's original start position
+*   keeps the id; the other half gets a fresh one. Anchors inside the
+*   content stay resolvable on the half that carries them.
+* - Merge/join: the surviving paragraph keeps its id; the absorbed id
+*   dangles by design (consumers degrade to snapshot fallback).
+* - Paste/duplicate carrying an id already in the doc: the paragraph
+*   whose mapped pre-transaction position matches keeps it — pasting a
+*   copy above its source no longer steals the source's id. When no
+*   occurrence maps back (e.g. both are new), the first in document
+*   order keeps it.
+* - Paste of an id unknown to this doc (cross-doc paste, cut-then-
+*   paste move): the id is kept, so a moved paragraph stays anchored.
+* - Undo/redo: allocation applies with `addToHistory: false`, and
+*   ProseMirror remaps it into the originating history event. Redoing a
+*   split therefore restores the same allocated id instead of minting
+*   another one.
+*/
 const paraIdAllocatorKey = new PluginKey("paraIdAllocator");
 const isUsableParaId = (value) => typeof value === "string" && value.length > 0 && value !== "00000000";
 /**
@@ -76,6 +114,59 @@ const collectParaIdUpdates = (doc, keeperPositions) => {
 	updates.sort((a, b) => a.pos - b.pos);
 	return updates;
 };
+const collectInitialParaIds = (doc) => {
+	let needsRewrite = false;
+	const taken = /* @__PURE__ */ new Set();
+	doc.descendants((node) => {
+		if (node.type.name !== "paragraph") return true;
+		const id = node.attrs["paraId"];
+		if (!isUsableParaId(id) || taken.has(id)) needsRewrite = true;
+		else taken.add(id);
+		return false;
+	});
+	return {
+		needsRewrite,
+		taken
+	};
+};
+const rewriteInitialParaIds = (parent, taken, seen) => {
+	let changed = false;
+	const children = [];
+	parent.forEach((child) => {
+		let next = child;
+		if (child.type.name === "paragraph") {
+			const id = child.attrs["paraId"];
+			if (!isUsableParaId(id) || seen.has(id)) {
+				let newId = generateHexId();
+				while (taken.has(newId)) newId = generateHexId();
+				taken.add(newId);
+				seen.add(newId);
+				next = child.type.create({
+					...child.attrs,
+					paraId: newId
+				}, child.content, child.marks);
+			} else seen.add(id);
+		} else if (child.childCount > 0) {
+			const content = rewriteInitialParaIds(child, taken, seen);
+			if (content !== child.content) next = child.copy(content);
+		}
+		if (next !== child) changed = true;
+		children.push(next);
+	});
+	return changed ? Fragment.fromArray(children) : parent.content;
+};
+/**
+* Allocate initial paragraph IDs before constructing editor state.
+*
+* Rebuilding only changed branches avoids applying one ProseMirror transaction
+* step per missing paragraph. Live edits still use the transaction-based plugin
+* below so history, mappings, and duplicate ownership retain their semantics.
+*/
+const ensureParaIdsInDoc = (doc) => {
+	const { needsRewrite, taken } = collectInitialParaIds(doc);
+	if (!needsRewrite) return doc;
+	return doc.copy(rewriteInitialParaIds(doc, taken, /* @__PURE__ */ new Set()));
+};
 const ensureParaIdsInState = (state) => {
 	const updates = collectParaIdUpdates(state.doc);
 	if (updates.length === 0) return state;
@@ -109,4 +200,4 @@ const ParaIdAllocatorExtension = createExtension({
 	}
 });
 //#endregion
-export { ParaIdAllocatorExtension, ensureParaIdsInState, paraIdAllocatorKey };
+export { ParaIdAllocatorExtension, ensureParaIdsInDoc, ensureParaIdsInState, paraIdAllocatorKey };

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

@@ -30,6 +30,7 @@ declare function hasUntrackedChanges(state: EditorState): boolean;
  */
 declare function clearTrackedChanges(state: EditorState): Transaction;
 declare function ignoreTrackedChanges(tr: Transaction): Transaction;
+declare function markStructuralChange(tr: Transaction): Transaction;
 declare const ParagraphChangeTrackerExtension: (options?: Partial<{}> | undefined) => Extension;
 //#endregion
-export { ParagraphChangeTrackerExtension, ParagraphChangeTrackerState, clearTrackedChanges, getChangeTrackerState, getChangedParagraphIds, hasStructuralChanges, hasUntrackedChanges, ignoreTrackedChanges, paragraphChangeTrackerKey };
+export { ParagraphChangeTrackerExtension, ParagraphChangeTrackerState, clearTrackedChanges, getChangeTrackerState, getChangedParagraphIds, hasStructuralChanges, hasUntrackedChanges, ignoreTrackedChanges, markStructuralChange, paragraphChangeTrackerKey };

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

@@ -12,6 +12,7 @@ import { AddMarkStep, AddNodeMarkStep, RemoveMarkStep, RemoveNodeMarkStep } from
 const paragraphChangeTrackerKey = new PluginKey("paragraphChangeTracker");
 const CLEAR_META = "clear";
 const IGNORE_META = "ignore";
+const STRUCTURAL_META = "structural";
 /**
 * Count paragraph nodes in a ProseMirror document
 */
@@ -103,7 +104,7 @@ function createParagraphChangeTrackerPlugin() {
 				const newCount = countParagraphs(tr.doc);
 				const newState = {
 					changedParaIds: new Set(prevState.changedParaIds),
-					structuralChange: prevState.structuralChange,
+					structuralChange: prevState.structuralChange || meta === STRUCTURAL_META,
 					hasUntrackedChanges: prevState.hasUntrackedChanges,
 					paragraphCount: newCount
 				};
@@ -177,6 +178,9 @@ function clearTrackedChanges(state) {
 function ignoreTrackedChanges(tr) {
 	return tr.setMeta(paragraphChangeTrackerKey, IGNORE_META);
 }
+function markStructuralChange(tr) {
+	return tr.setMeta(paragraphChangeTrackerKey, STRUCTURAL_META);
+}
 const ParagraphChangeTrackerExtension = createExtension({
 	name: "paragraphChangeTracker",
 	defaultOptions: {},
@@ -185,4 +189,4 @@ const ParagraphChangeTrackerExtension = createExtension({
 	}
 });
 //#endregion
-export { ParagraphChangeTrackerExtension, clearTrackedChanges, getChangeTrackerState, getChangedParagraphIds, hasStructuralChanges, hasUntrackedChanges, ignoreTrackedChanges, paragraphChangeTrackerKey };
+export { ParagraphChangeTrackerExtension, clearTrackedChanges, getChangeTrackerState, getChangedParagraphIds, hasStructuralChanges, hasUntrackedChanges, ignoreTrackedChanges, markStructuralChange, paragraphChangeTrackerKey };

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

@@ -1,3 +1,4 @@
+import { stripXmlDeclarations } from "../../../utils/stripXmlDeclarations.js";
 //#region src/prosemirror/extensions/features/pasteCleanup.ts
 /**
 * Office / web paste cleanup
@@ -112,11 +113,22 @@ function splitStyleDeclarations(value) {
 }
 const TAG_TAIL = `(?:"[^"]*"|'[^']*'|[^>"'])*`;
 const NAMESPACED_TAG = new RegExp(`<\\/?(?:[owvm]|st\\d+):${TAG_TAIL}>`, "gi");
-const XML_PROCESSING_INSTRUCTION = new RegExp(`<\\?xml${TAG_TAIL}>`, "gi");
 const STRAY_XML_TAG = new RegExp(`<\\/?xml${TAG_TAIL}>`, "gi");
 const NOISE_TAG = new RegExp(`<\\/?(?:font|meta|link)${TAG_TAIL}>`, "gi");
 const EMPTY_SPAN = new RegExp(`<span(?:\\s${TAG_TAIL})?><\\/span>`, "gi");
 const MAX_EMPTY_SPAN_PASSES = 5;
+const PM_SLICE_MARKER = /\bdata-pm-slice\s*=/i;
+const TEXTBOX_ANCHOR_ATTR = /\s+data-docx-textbox-anchor(?:="[^"]*"|='[^']*')?/gi;
+/**
+* Remove the `data-docx-textbox-anchor` marker from HTML that did not come
+* from a ProseMirror clipboard slice (see {@link PM_SLICE_MARKER}). Internal
+* copy/paste of a real text box carries the marker HTML unmodified so it
+* keeps working; anything else has the marker stripped defensively.
+*/
+function stripForeignTextBoxAnchors(html, originalHtml) {
+	if (PM_SLICE_MARKER.test(originalHtml)) return html;
+	return html.replace(TEXTBOX_ANCHOR_ATTR, "");
+}
 /**
 * Remove empty spans left behind after stripping `mso-*` styles. Only truly
 * empty spans are removed (whitespace-only spans are kept so word-separating
@@ -144,12 +156,13 @@ function cleanPastedHtml(html) {
 	if (!html) return html;
 	try {
 		let cleaned = stripHtmlComments(html);
-		cleaned = cleaned.replace(XML_PROCESSING_INSTRUCTION, "");
+		cleaned = stripXmlDeclarations(cleaned);
 		cleaned = cleaned.replace(NAMESPACED_TAG, "");
 		cleaned = cleaned.replace(STRAY_XML_TAG, "");
 		cleaned = cleaned.replace(NOISE_TAG, "");
 		cleaned = stripMsoStyles(cleaned);
 		cleaned = stripEmptySpans(cleaned);
+		cleaned = stripForeignTextBoxAnchors(cleaned, html);
 		return cleaned.trim();
 	} catch {
 		return html;

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

@@ -1,5 +1,5 @@
-import { formatPx, twipsToPixels } from "../../../utils/units.js";
 import { expectCharacterSpacingMarkAttrs } from "../../attrs/index.js";
+import { formatPx, twipsToPixels } from "../../../utils/units.js";
 import { createMarkExtension } from "../create.js";
 //#region src/prosemirror/extensions/marks/CharacterSpacingExtension.ts
 /**

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

@@ -1,11 +1,37 @@
 import { expectHyperlinkMarkAttrs } from "../../attrs/index.js";
 import { createMarkExtension } from "../create.js";
 import { isMarkActive } from "./markUtils.js";
+import { normalizeUserUrl, sanitizeExternalUrl } from "../../../utils/urlSecurity.js";
 import { panic } from "better-result";
 //#region src/prosemirror/extensions/marks/HyperlinkExtension.ts
 /**
 * Hyperlink Mark Extension
 */
+/**
+* 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
+* allow-listed absolute URLs (http/https/mailto/tel) and internal bookmark
+* anchors survive; everything else (javascript:, data:, file:, ...) becomes
+* an empty href, matching how the codebase already signals "no link" for an
+* unresolved hyperlink (see `toProseDoc.ts`'s `hyperlink.href || ""`).
+*/
+function sanitizeStoredHref(rawHref) {
+	if (!rawHref) return "";
+	const trimmed = rawHref.trim();
+	if (trimmed.startsWith("#")) return trimmed;
+	return sanitizeExternalUrl(trimmed) ?? "";
+}
+/**
+* Normalize/sanitize a URL typed by a user (hyperlink dialog/popup) before it
+* is written into a mark. Protocol-less input (e.g. "example.com") is
+* accepted and normalized to https; anything resolving to a disallowed
+* scheme is dropped.
+*/
+function normalizeHyperlinkInput(rawHref) {
+	const trimmed = rawHref.trim();
+	if (trimmed.startsWith("#")) return trimmed;
+	return normalizeUserUrl(trimmed);
+}
 function isHyperlinkActive(state) {
 	const hlType = state.schema.marks["hyperlink"];
 	if (!hlType) return false;
@@ -62,14 +88,14 @@ const HyperlinkExtension = createMarkExtension({
 		parseDOM: [{
 			tag: "a[href]",
 			getAttrs: (dom) => ({
-				href: dom.getAttribute("href") ?? "",
+				href: sanitizeStoredHref(dom.getAttribute("href") ?? void 0),
 				tooltip: dom.getAttribute("title") ?? void 0
 			})
 		}],
 		toDOM(mark) {
 			const { href, tooltip } = expectHyperlinkMarkAttrs(mark);
 			const domAttrs = {
-				href,
+				href: sanitizeStoredHref(href),
 				target: "_blank",
 				rel: "noopener noreferrer"
 			};
@@ -89,7 +115,7 @@ const HyperlinkExtension = createMarkExtension({
 			if (empty) return false;
 			if (dispatch) {
 				const mark = hlType.create({
-					href,
+					href: normalizeHyperlinkInput(href),
 					tooltip: tooltip || null
 				});
 				let tr = state.tr.addMark(from, to, mark);
@@ -127,7 +153,7 @@ const HyperlinkExtension = createMarkExtension({
 		const insertHyperlink = (text, href, tooltip) => (state, dispatch) => {
 			if (dispatch) {
 				const mark = hlType.create({
-					href,
+					href: normalizeHyperlinkInput(href),
 					tooltip: tooltip || null
 				});
 				const textNode = state.schema.text(text, [mark]);

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

@@ -18,5 +18,13 @@ declare const InsertionExtension: (options?: Partial<Record<string, unknown>> |
  * Renders with per-author colored strikethrough.
  */
 declare const DeletionExtension: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
+/**
+ * Run property change — formatting changed while review tracking was active.
+ *
+ * The current formatting remains represented by the normal formatting marks;
+ * this mark carries the previous run properties and revision metadata needed
+ * to serialize, list, accept, and reject the change.
+ */
+declare const RunPropertyChangeExtension: (options?: Partial<Record<string, unknown>> | undefined) => MarkExtension;
 //#endregion
-export { DeletionExtension, InsertionExtension };
+export { DeletionExtension, InsertionExtension, RunPropertyChangeExtension };

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

@@ -18,6 +18,20 @@ import { AUTHOR_COLORS, getAuthorColorIdx } from "../../../utils/authorColors.js
 const insertionStyle = (color) => `color: ${color}; text-decoration: underline; text-decoration-color: ${color};`;
 const deletionStyle = (color) => `color: ${color}; text-decoration: line-through; text-decoration-color: ${color};`;
 /**
+* Suggested (AI-proposed) tracked changes reuse the insertion/deletion visual
+* grammar but with a DOTTED stroke and a dedicated suggestion hue, kept
+* distinct from the per-author redline colors. The hue and tint are driven by
+* the `--suggestion-color` / `--suggestion-bg` CSS custom properties (see
+* editor.css); the inline fallbacks below keep the paged-canvas projection —
+* which reuses this same `toDOM` style string — legible when the stylesheet
+* variables are not in scope.
+*/
+const SUGGESTION_COLOR = "var(--suggestion-color, #6d3bd6)";
+const SUGGESTION_TINT = "var(--suggestion-bg, color-mix(in oklch, #6d3bd6 12%, transparent))";
+const SUGGESTION_TINT_LAYER = `linear-gradient(${SUGGESTION_TINT}, ${SUGGESTION_TINT})`;
+const suggestedInsertionStyle = () => `color: ${SUGGESTION_COLOR}; text-decoration: underline; text-decoration-style: dotted; text-decoration-color: ${SUGGESTION_COLOR}; background-image: ${SUGGESTION_TINT_LAYER};`;
+const suggestedDeletionStyle = () => `color: ${SUGGESTION_COLOR}; text-decoration: line-through; text-decoration-style: dotted; text-decoration-color: ${SUGGESTION_COLOR}; background-image: ${SUGGESTION_TINT_LAYER};`;
+/**
 * Insertion mark — text added in tracked changes
 * Renders with per-author colored underline.
 */
@@ -29,7 +43,10 @@ const InsertionExtension = createMarkExtension({
 			revisionId: { default: 0 },
 			author: { default: "" },
 			date: { default: null },
-			moveKind: { default: null }
+			moveKind: { default: null },
+			initials: { default: null },
+			provenance: { default: "user" },
+			suggestionId: { default: null }
 		},
 		inclusive: false,
 		parseDOM: [{
@@ -43,20 +60,23 @@ const InsertionExtension = createMarkExtension({
 			}
 		}],
 		toDOM(mark) {
-			const { revisionId, author, date } = expectTrackedChangeMarkAttrs(mark);
+			const { revisionId, author, date, provenance, suggestionId } = expectTrackedChangeMarkAttrs(mark);
 			const idx = getAuthorColorIdx(author);
 			const color = AUTHOR_COLORS[idx] ?? "#000000";
 			const titleParts = [author, date ? new Date(date).toLocaleDateString() : ""].filter(Boolean);
+			const suggested = provenance === "suggested";
 			return [
 				"span",
 				{
-					class: "docx-insertion",
+					class: suggested ? "docx-insertion docx-insertion--suggested" : "docx-insertion",
 					"data-revision-id": String(revisionId),
 					"data-author": author,
 					"data-tc-author-idx": String(idx),
+					...suggested ? { "data-provenance": "suggested" } : {},
+					...suggested && suggestionId ? { "data-suggestion-id": suggestionId } : {},
 					...date ? { "data-date": date } : {},
-					...titleParts.length > 0 ? { title: `Inserted: ${titleParts.join(", ")}` } : {},
-					style: insertionStyle(color)
+					...titleParts.length > 0 ? { title: `${suggested ? "Suggested" : "Inserted"}: ${titleParts.join(", ")}` } : {},
+					style: suggested ? suggestedInsertionStyle() : insertionStyle(color)
 				},
 				0
 			];
@@ -75,7 +95,10 @@ const DeletionExtension = createMarkExtension({
 			revisionId: { default: 0 },
 			author: { default: "" },
 			date: { default: null },
-			moveKind: { default: null }
+			moveKind: { default: null },
+			initials: { default: null },
+			provenance: { default: "user" },
+			suggestionId: { default: null }
 		},
 		inclusive: false,
 		parseDOM: [{
@@ -89,20 +112,56 @@ const DeletionExtension = createMarkExtension({
 			}
 		}],
 		toDOM(mark) {
-			const { revisionId, author, date } = expectTrackedChangeMarkAttrs(mark);
+			const { revisionId, author, date, provenance, suggestionId } = expectTrackedChangeMarkAttrs(mark);
 			const idx = getAuthorColorIdx(author);
 			const color = AUTHOR_COLORS[idx] ?? "#000000";
 			const titleParts = [author, date ? new Date(date).toLocaleDateString() : ""].filter(Boolean);
+			const suggested = provenance === "suggested";
 			return [
 				"span",
 				{
-					class: "docx-deletion",
+					class: suggested ? "docx-deletion docx-deletion--suggested" : "docx-deletion",
 					"data-revision-id": String(revisionId),
 					"data-author": author,
 					"data-tc-author-idx": String(idx),
+					...suggested ? { "data-provenance": "suggested" } : {},
+					...suggested && suggestionId ? { "data-suggestion-id": suggestionId } : {},
 					...date ? { "data-date": date } : {},
-					...titleParts.length > 0 ? { title: `Deleted: ${titleParts.join(", ")}` } : {},
-					style: deletionStyle(color)
+					...titleParts.length > 0 ? { title: `${suggested ? "Suggested deletion" : "Deleted"}: ${titleParts.join(", ")}` } : {},
+					style: suggested ? suggestedDeletionStyle() : deletionStyle(color)
+				},
+				0
+			];
+		}
+	}
+});
+/**
+* Run property change — formatting changed while review tracking was active.
+*
+* The current formatting remains represented by the normal formatting marks;
+* this mark carries the previous run properties and revision metadata needed
+* to serialize, list, accept, and reject the change.
+*/
+const RunPropertyChangeExtension = createMarkExtension({
+	name: "runPropertyChange",
+	schemaMarkName: "runPropertyChange",
+	markSpec: {
+		attrs: {
+			changes: { default: [] },
+			provenance: { default: "user" },
+			suggestionId: { default: null }
+		},
+		inclusive: false,
+		parseDOM: [{ tag: "span.docx-run-property-change" }],
+		toDOM(mark) {
+			const suggested = mark.attrs["provenance"] === "suggested";
+			const suggestionId = mark.attrs["suggestionId"];
+			return [
+				"span",
+				{
+					class: suggested ? "docx-run-property-change docx-run-property-change--suggested" : "docx-run-property-change",
+					...suggested ? { "data-provenance": "suggested" } : {},
+					...suggested && typeof suggestionId === "string" ? { "data-suggestion-id": suggestionId } : {}
 				},
 				0
 			];
@@ -110,4 +169,4 @@ const DeletionExtension = createMarkExtension({
 	}
 });
 //#endregion
-export { DeletionExtension, InsertionExtension };
+export { DeletionExtension, InsertionExtension, RunPropertyChangeExtension };

package/dist/prosemirror/extensions/nodes/FieldExtension.js

@@ -1,6 +1,6 @@
-import { parseFieldInstruction } from "../../../docx/fieldParser.js";
 import { expectFieldAttrs } from "../../attrs/index.js";
 import { createNodeExtension } from "../create.js";
+import { parseFieldInstruction } from "../../../docx/fieldParser.js";
 //#region src/prosemirror/extensions/nodes/FieldExtension.ts
 /**
 * Field Extension — inline field node (PAGE, NUMPAGES, DATE, MERGEFIELD, etc.)

package/dist/prosemirror/extensions/nodes/RenderedPageBreakExtension.d.ts

@@ -0,0 +1,7 @@
+import { NodeExtension } from "../types.js";
+
+//#region src/prosemirror/extensions/nodes/RenderedPageBreakExtension.d.ts
+/** Zero-width cached pagination boundary preserved from DOCX. */
+declare const RenderedPageBreakExtension: (options?: Partial<Record<string, unknown>> | undefined) => NodeExtension;
+//#endregion
+export { RenderedPageBreakExtension };

package/dist/prosemirror/extensions/nodes/RenderedPageBreakExtension.js

@@ -0,0 +1,22 @@
+import { createNodeExtension } from "../create.js";
+//#region src/prosemirror/extensions/nodes/RenderedPageBreakExtension.ts
+/** Zero-width cached pagination boundary preserved from DOCX. */
+const RenderedPageBreakExtension = createNodeExtension({
+	name: "renderedPageBreak",
+	schemaNodeName: "renderedPageBreak",
+	nodeSpec: {
+		inline: true,
+		group: "inline",
+		atom: true,
+		selectable: false,
+		parseDOM: [{ tag: "span[data-docx-rendered-page-break]" }],
+		toDOM() {
+			return ["span", {
+				"data-docx-rendered-page-break": "true",
+				style: "display: none;"
+			}];
+		}
+	}
+});
+//#endregion
+export { RenderedPageBreakExtension };

package/dist/prosemirror/extensions/nodes/TableExtension.d.ts

@@ -1,5 +1,5 @@
-import { AnyExtension, Extension, NodeExtension } from "../types.js";
 import { ColorValue } from "../../../types/colors.js";
+import { AnyExtension, Extension, NodeExtension } from "../types.js";
 import { Command, EditorState } from "prosemirror-state";
 import { Node } from "prosemirror-model";