@stll/folio-core 0.12.0 → 0.13.0

package/dist/ai-edits/apply.d.ts

@@ -20,7 +20,8 @@ type ApplyFolioAIEditOperationsOptions = {
   snapshot: FolioAIEditSnapshot;
   operations: FolioAIEditOperation[];
   mode?: FolioAIEditApplyMode;
-  author?: string;
+  author?: string; /** Optional author initials (w:initials) stamped alongside the author. */
+  initials?: string;
   createCommentId?: (text: string) => number;
 };
 declare const applyFolioAIEditOperations: (options: ApplyFolioAIEditOperationsOptions) => FolioAIEditApplyResult;

package/dist/ai-edits/apply.js

@@ -12,6 +12,27 @@ import { applyTableColumnDeletion, applyTableColumnInsertion, applyTableRowDelet
 import { diffWordSegments } from "./word-diff.js";
 import { TableMap } from "prosemirror-tables";
 //#region src/ai-edits/apply.ts
+/**
+* Operation types applied in `"suggested"` mode. Every produced revision — an
+* inline mark, a whole-node `_suggestedInsert` marker, or a suggested
+* `trIns`/`trDel`/`cellMarker` — is stripped from serialized DOCX until
+* accepted. Cell merge/split (not row/column ops) and comment ops stay
+* `unsupportedMode`.
+*/
+const SUGGESTED_SUPPORTED_OPERATION_TYPES = /* @__PURE__ */ new Set([
+	"replaceInBlock",
+	"replaceRange",
+	"formatRange",
+	"replaceBlock",
+	"deleteBlock",
+	"insertAfterBlock",
+	"insertBeforeBlock",
+	"insertSignatureTable",
+	"insertTableRow",
+	"deleteTableRow",
+	"insertTableColumn",
+	"deleteTableColumn"
+]);
 const applyReplaceBlockStyleId = ({ item, tr }) => {
 	if (item.operation.type !== "replaceBlock" || item.operation.styleId === void 0) return tr;
 	const block = tr.doc.nodeAt(item.blockFrom);
@@ -39,7 +60,7 @@ const formattingWouldChange = (marks, formatting) => Object.entries(formatting).
 	if (name === "underline") return mark?.attrs["style"] !== "single";
 	return mark === void 0;
 });
-const applyTrackedInlineFormatting = ({ tr, schema, doc, from, to, formatting, revisionId, author, date }) => {
+const applyTrackedInlineFormatting = ({ tr, schema, doc, from, to, formatting, revisionId, author, date, initials, suggestionId = null }) => {
 	const propertyChangeType = schema.marks["runPropertyChange"];
 	if (!propertyChangeType) return tr;
 	const segments = [];
@@ -55,7 +76,8 @@ const applyTrackedInlineFormatting = ({ tr, schema, doc, from, to, formatting, r
 			info: {
 				id: revisionId,
 				author,
-				date
+				date,
+				...initials ? { initials } : {}
 			},
 			...Object.keys(previousFormatting).length > 0 ? { previousFormatting } : {}
 		};
@@ -66,6 +88,10 @@ const applyTrackedInlineFormatting = ({ tr, schema, doc, from, to, formatting, r
 		});
 	});
 	if (segments.length === 0) return tr;
+	const suggestionAttrs = suggestionId === null ? {} : {
+		provenance: "suggested",
+		suggestionId
+	};
 	applyInlineFormatting({
 		tr,
 		schema,
@@ -73,7 +99,10 @@ const applyTrackedInlineFormatting = ({ tr, schema, doc, from, to, formatting, r
 		to,
 		formatting
 	});
-	for (const segment of segments) tr.addMark(segment.from, segment.to, propertyChangeType.create({ changes: segment.changes }));
+	for (const segment of segments) tr.addMark(segment.from, segment.to, propertyChangeType.create({
+		changes: segment.changes,
+		...suggestionAttrs
+	}));
 	return tr;
 };
 /**
@@ -246,7 +275,7 @@ const buildEmphasisInlineContent = (schema, text, baseMarks) => {
 	}
 	return nodes.length > 0 ? nodes : [schema.text(text, [...baseMarks])];
 };
-const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations, mode = "tracked-changes", author = "AI", createCommentId, revisionIdSeed }) => {
+const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations, mode = "tracked-changes", author = "AI", initials, createCommentId, revisionIdSeed }) => {
 	const applied = [];
 	const skipped = [];
 	const resolved = [];
@@ -255,7 +284,9 @@ const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations, mode =
 	const commentType = view.state.schema.marks["comment"];
 	const claimedTableRows = /* @__PURE__ */ new Set();
 	const claimedTableColumns = /* @__PURE__ */ new Set();
-	if (mode === "tracked-changes" && (!insertionType || !deletionType)) return {
+	const producesTrackedChanges = mode !== "direct";
+	const isSuggested = mode === "suggested";
+	if (producesTrackedChanges && (!insertionType || !deletionType)) return {
 		applied,
 		skipped: operations.map((operation) => ({
 			id: operation.id,
@@ -361,6 +392,27 @@ const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations, mode =
 		const commentMark = item.commentId !== void 0 && commentType ? commentType.create({ commentId: item.commentId }) : null;
 		const stepsBefore = tr.steps.length;
 		let appliedRevisionIds;
+		if (isSuggested && !SUGGESTED_SUPPORTED_OPERATION_TYPES.has(item.operation.type)) {
+			skipped.push({
+				id: item.operation.id,
+				reason: "unsupportedMode"
+			});
+			continue;
+		}
+		const suggestionId = isSuggested ? item.operation.suggestionId ?? item.operation.id : null;
+		const trackedRevisionExtras = {
+			...initials ? { initials } : {},
+			...suggestionId !== null ? {
+				provenance: "suggested",
+				suggestionId
+			} : {}
+		};
+		const structuralRevision = producesTrackedChanges ? {
+			revisionId: revisionSeed,
+			author,
+			date,
+			...trackedRevisionExtras
+		} : null;
 		switch (item.operation.type) {
 			case "replaceInBlock":
 			case "replaceRange": {
@@ -374,16 +426,18 @@ const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations, mode =
 					date,
 					revisionIdDelete,
 					revisionIdInsert,
-					commentMark
+					commentMark,
+					suggestionId,
+					initials
 				});
-				if (mode === "tracked-changes") appliedRevisionIds = [revisionIdDelete, revisionIdInsert];
+				if (producesTrackedChanges) appliedRevisionIds = [revisionIdDelete, revisionIdInsert];
 				break;
 			}
 			case "commentOnRange":
 				if (commentMark) tr = tr.addMark(item.from, item.to, commentMark);
 				break;
 			case "formatRange":
-				if (mode === "tracked-changes") {
+				if (producesTrackedChanges) {
 					const revisionId = revisionSeed++;
 					tr = applyTrackedInlineFormatting({
 						tr,
@@ -394,7 +448,9 @@ const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations, mode =
 						formatting: item.operation.formatting,
 						revisionId,
 						author,
-						date
+						date,
+						initials,
+						suggestionId
 					});
 					appliedRevisionIds = [revisionId];
 					break;
@@ -437,13 +493,15 @@ const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations, mode =
 					date,
 					revisionIdDelete,
 					revisionIdInsert,
-					commentMark
+					commentMark,
+					suggestionId,
+					initials
 				});
 				tr = applyReplaceBlockStyleId({
 					item,
 					tr
 				});
-				if (mode === "tracked-changes") appliedRevisionIds = [revisionIdDelete, revisionIdInsert];
+				if (producesTrackedChanges) appliedRevisionIds = [revisionIdDelete, revisionIdInsert];
 				break;
 			}
 			case "insertAfterBlock":
@@ -456,12 +514,15 @@ const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations, mode =
 					continue;
 				}
 				const marks = [];
-				if (mode === "tracked-changes" && insertionType) {
+				let insertedBlockRevisionId = null;
+				if (producesTrackedChanges && insertionType) {
 					const revisionId = revisionSeed++;
+					insertedBlockRevisionId = revisionId;
 					marks.push(insertionType.create({
 						revisionId,
 						author,
-						date
+						date,
+						...trackedRevisionExtras
 					}));
 					appliedRevisionIds = [revisionId];
 				}
@@ -480,6 +541,13 @@ const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations, mode =
 						attrs["listStartOverride"] = null;
 					}
 				}
+				if (isSuggested && suggestionId !== null && insertedBlockRevisionId !== null) attrs["_suggestedInsert"] = {
+					suggestionId,
+					revisionId: insertedBlockRevisionId,
+					author,
+					date,
+					...initials ? { initials } : {}
+				};
 				const node = item.blockNode.type.create(attrs, content);
 				tr = tr.insert(item.from, node);
 				break;
@@ -492,17 +560,32 @@ const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations, mode =
 					});
 					continue;
 				}
-				const node = buildSignatureTableNode({
+				const signatureTable = buildSignatureTableNode({
 					schema: view.state.schema,
 					parties: item.operation.parties
 				});
-				if (!node) {
+				if (!signatureTable) {
 					skipped.push({
 						id: item.operation.id,
 						reason: "unsupportedBlock"
 					});
 					continue;
 				}
+				let node = signatureTable;
+				if (isSuggested && suggestionId !== null) {
+					const revisionId = revisionSeed++;
+					node = signatureTable.type.create({
+						...signatureTable.attrs,
+						_suggestedInsert: {
+							suggestionId,
+							revisionId,
+							author,
+							date,
+							...initials ? { initials } : {}
+						}
+					}, signatureTable.content, signatureTable.marks);
+					appliedRevisionIds = [revisionId];
+				}
 				tr = tr.insert(item.from, node);
 				break;
 			}
@@ -515,11 +598,7 @@ const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations, mode =
 					});
 					continue;
 				}
-				const revision = mode === "tracked-changes" ? {
-					revisionId: revisionSeed,
-					author,
-					date
-				} : null;
+				const revision = structuralRevision;
 				const result = applyTableRowInsertion({
 					tr,
 					insertion,
@@ -549,11 +628,7 @@ const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations, mode =
 					});
 					continue;
 				}
-				const revision = mode === "tracked-changes" ? {
-					revisionId: revisionSeed,
-					author,
-					date
-				} : null;
+				const revision = structuralRevision;
 				const result = applyTableColumnInsertion({
 					tr,
 					insertion,
@@ -586,11 +661,7 @@ const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations, mode =
 					continue;
 				}
 				const columnKey = getTableColumnCoordinateKey(deletion);
-				const revision = mode === "tracked-changes" ? {
-					revisionId: revisionSeed,
-					author,
-					date
-				} : null;
+				const revision = structuralRevision;
 				const result = applyTableColumnDeletion({
 					tr,
 					deletion,
@@ -703,11 +774,7 @@ const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations, mode =
 				const result = applyTableRowDeletion({
 					tr,
 					deletion,
-					revision: mode === "tracked-changes" ? {
-						revisionId: revisionSeed,
-						author,
-						date
-					} : null
+					revision: structuralRevision
 				});
 				if (result.type === "unsupported") {
 					skipped.push({
@@ -733,7 +800,8 @@ const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations, mode =
 					tr = tr.addMark(item.from, item.to, deletionType.create({
 						revisionId,
 						author,
-						date
+						date,
+						...trackedRevisionExtras
 					}));
 					appliedRevisionIds = [revisionId];
 				}
@@ -757,7 +825,8 @@ const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations, mode =
 			...appliedRevisionIds !== void 0 && appliedRevisionIds[0] !== void 0 && {
 				revisionId: appliedRevisionIds[0],
 				revisionIds: appliedRevisionIds
-			}
+			},
+			...suggestionId !== null && { suggestionId }
 		});
 	}
 	if (tr.docChanged) view.dispatch(tr);
@@ -787,7 +856,7 @@ const previewFolioAIEditOperations = (options) => {
 		skipped: result.skipped
 	};
 };
-const applyTextReplacement = ({ tr, item, mode, author, date, revisionIdDelete, revisionIdInsert, commentMark }) => {
+const applyTextReplacement = ({ tr, item, mode, author, date, revisionIdDelete, revisionIdInsert, commentMark, suggestionId = null, initials }) => {
 	let nextTr = tr;
 	const replacement = stripInlineEmphasisMarkers((() => {
 		if (item.operation.type === "replaceInBlock" || item.operation.type === "replaceRange") return item.operation.replace;
@@ -805,15 +874,24 @@ const applyTextReplacement = ({ tr, item, mode, author, date, revisionIdDelete,
 	}
 	const insertionType = nextTr.doc.type.schema.marks["insertion"];
 	const deletionType = nextTr.doc.type.schema.marks["deletion"];
+	const suggestionAttrs = suggestionId === null ? {} : {
+		provenance: "suggested",
+		suggestionId
+	};
+	const initialsAttr = initials ? { initials } : {};
 	const delAttrs = {
 		revisionId: revisionIdDelete,
 		author,
-		date
+		date,
+		...initialsAttr,
+		...suggestionAttrs
 	};
 	const insAttrs = {
 		revisionId: revisionIdInsert,
 		author,
-		date
+		date,
+		...initialsAttr,
+		...suggestionAttrs
 	};
 	const cleanBlock = item.blockNode.content.size === item.blockNode.textContent.length ? buildCleanBlockText(item.blockNode, item.blockFrom) : null;
 	let sourceText = null;

package/dist/ai-edits/blockRange.js

@@ -13,7 +13,7 @@ const resolveFolioAIBlockRange = ({ blockId, doc, snapshot }) => {
 		};
 	}
 	const resolvedSnapshot = snapshot ?? createFolioAIEditSnapshot(doc);
-	const anchor = resolvedSnapshot.anchors[blockId] ?? resolveSequentialBlockAnchor(blockId, resolvedSnapshot);
+	const anchor = Object.hasOwn(resolvedSnapshot.anchors, blockId) ? resolvedSnapshot.anchors[blockId] : resolveSequentialBlockAnchor(blockId, resolvedSnapshot);
 	if (!anchor) return null;
 	return clampRangeToDocSize(doc.content.size, anchor);
 };

package/dist/ai-edits/clean-text.js

@@ -2,13 +2,14 @@
 const DELETION_MARK = "deletion";
 const INSERTION_MARK = "insertion";
 const COMMENT_MARK = "comment";
+const HIDDEN_MARK = "hidden";
 const buildCleanBlockText = (blockNode, blockFrom) => {
 	let text = "";
 	const offsets = [];
 	let lastEnd = blockFrom + 1;
 	blockNode.descendants((node, pos) => {
 		if (!node.isText || node.text === void 0) return true;
-		if (node.marks.some((mark) => mark.type.name === DELETION_MARK)) return false;
+		if (node.marks.some((mark) => mark.type.name === DELETION_MARK || mark.type.name === HIDDEN_MARK)) return false;
 		const startPos = blockFrom + 1 + pos;
 		for (let i = 0; i < node.text.length; i++) offsets.push(startPos + i);
 		text += node.text;

package/dist/ai-edits/headless.js

@@ -1,10 +1,10 @@
-import { proseDocToBlocks, updateDocumentContent } from "../prosemirror/conversion/fromProseDoc.js";
-import { buildAnnotatedBlockText } from "./clean-text.js";
-import { createFolioAIEditSnapshot, normalizeFolioAIBlockText } from "./snapshot.js";
 import { getChangedParagraphIds, hasStructuralChanges, hasUntrackedChanges, ignoreTrackedChanges } from "../prosemirror/extensions/features/ParagraphChangeTrackerExtension.js";
 import { deterministicHexId } from "../utils/hexId.js";
 import { schema, singletonManager } from "../prosemirror/schema/index.js";
 import { footnoteToProseDoc, headerFooterToProseDoc, toProseDoc } from "../prosemirror/conversion/toProseDoc.js";
+import { proseDocToBlocks, updateDocumentContent } from "../prosemirror/conversion/fromProseDoc.js";
+import { buildAnnotatedBlockText } from "./clean-text.js";
+import { createFolioAIEditSnapshot, normalizeFolioAIBlockText } from "./snapshot.js";
 import { applyFolioDocumentOperations } from "../document-operations.js";
 import { getEndnoteText, getFootnoteText, isSeparatorEndnote, isSeparatorFootnote } from "../docx/footnoteParser.js";
 import { getHeaderFooterText } from "../docx/headerFooterParser.js";

package/dist/ai-edits/snapshot.js

@@ -18,6 +18,22 @@ const createFolioAITextRangeHandle = ({ blockId, text, startOffset, endOffset })
 		selectedTextHash: hashFolioAIBlockText(text.slice(startOffset, endOffset))
 	};
 };
+const TABLE_ROW_NODE_NAME = "tableRow";
+/**
+* True when `pos`'s nearest `tableRow` ancestor is marked `hidden` (OOXML
+* `w:trPr/w:hidden` — Word never renders the row). A textblock inside such a
+* row must not surface its text to the AI/agent snapshot: an attacker DOCX
+* could otherwise smuggle prompt-injection instructions into a row that no
+* human ever sees.
+*/
+const isInHiddenTableRow = (doc, pos) => {
+	const $pos = doc.resolve(pos);
+	for (let depth = $pos.depth; depth > 0; depth--) {
+		const ancestor = $pos.node(depth);
+		if (ancestor.type.name === TABLE_ROW_NODE_NAME) return ancestor.attrs["hidden"] === true;
+	}
+	return false;
+};
 const createFolioAIEditSnapshot = (doc) => {
 	const draftBlocks = [];
 	const hashCounts = /* @__PURE__ */ new Map();
@@ -28,11 +44,12 @@ const createFolioAIEditSnapshot = (doc) => {
 	};
 	let blockIndex = 0;
 	doc.descendants((node, pos, parent) => {
-		if (!node.isTextblock) return;
+		if (!node.isTextblock) return true;
+		if (isInHiddenTableRow(doc, pos)) return false;
 		const { text } = buildCleanBlockText(node, pos);
 		const normalizedText = normalizeFolioAIBlockText(text);
 		if (normalizedText.length === 0) {
-			if (parent?.type !== doc.type) return;
+			if (parent?.type !== doc.type) return true;
 			emptyAnchorState.textblockCount++;
 			if (emptyAnchorState.candidate === null) {
 				const paraIdAttr = node.attrs["paraId"];
@@ -42,7 +59,7 @@ const createFolioAIEditSnapshot = (doc) => {
 					paraId: typeof paraIdAttr === "string" && paraIdAttr.length > 0 ? paraIdAttr : null
 				};
 			}
-			return;
+			return true;
 		}
 		const textHash = hashFolioAIBlockText(normalizedText);
 		hashCounts.set(textHash, (hashCounts.get(textHash) ?? 0) + 1);
@@ -78,6 +95,7 @@ const createFolioAIEditSnapshot = (doc) => {
 				textHash
 			}
 		});
+		return true;
 	});
 	const blocks = [];
 	const anchors = {};

package/dist/ai-edits/table-cell-mutations.js

@@ -1,7 +1,7 @@
 import { expectTableCellAttrs } from "../prosemirror/attrs/index.js";
-import { standaloneTableCellFromProseMirror } from "../prosemirror/conversion/fromProseDoc.js";
 import { markStructuralChange } from "../prosemirror/extensions/features/ParagraphChangeTrackerExtension.js";
 import { standaloneTableCellToProseMirror } from "../prosemirror/conversion/toProseDoc.js";
+import { standaloneTableCellFromProseMirror } from "../prosemirror/conversion/fromProseDoc.js";
 import { tableRectanglesEqual } from "./table-mutation-plan.js";
 import { tableRectangleCutsMergedCell } from "./table-targets.js";
 import { Result } from "better-result";
@@ -210,6 +210,7 @@ const splitTrackedVerticalTableCell = ({ tr, tablePosition, table, rectangle, re
 };
 const isEmptyTableCell = (cell) => cell.childCount === 1 && cell.firstChild?.isTextblock === true && cell.firstChild.childCount === 0;
 const trackedSplitCellFromStoredSource = ({ origin, source, marker }) => {
+	if (source.formatting?.gridSpan !== void 0 && source.formatting.gridSpan > 1) return null;
 	const formatting = formattingWithoutVerticalMerge(source.formatting);
 	const converted = standaloneTableCellToProseMirror({
 		type: "tableCell",

package/dist/ai-edits/table-row-column-mutations.d.ts

@@ -1,3 +1,4 @@
+import { TrackedChangeProvenance } from "../prosemirror/schema/marks.js";
 import { TableRowTarget } from "./table-targets.js";
 import { Transaction } from "prosemirror-state";
 import { Node } from "prosemirror-model";
@@ -19,7 +20,14 @@ type TableColumnDeletion = TableColumnInsertion;
 type TableStructureRevision = {
   revisionId: number;
   author: string;
-  date: string;
+  date: string; /** Optional author initials (w:initials), carried for round-trip. */
+  initials?: string;
+  /**
+   * `"suggested"` marks the produced `trIns`/`trDel`/`cellMarker` as an AI
+   * proposal that is stripped from serialized DOCX until accepted.
+   */
+  provenance?: TrackedChangeProvenance;
+  suggestionId?: string;
 };
 type TableRowColumnMutationResult = {
   type: "applied";

package/dist/ai-edits/table-row-column-mutations.js

@@ -1,5 +1,5 @@
-import { stripBlockIdentityAttrs } from "./block-identity.js";
 import { markStructuralChange } from "../prosemirror/extensions/features/ParagraphChangeTrackerExtension.js";
+import { stripBlockIdentityAttrs } from "./block-identity.js";
 import { findEnclosingTableCell, findEnclosingTableRow } from "./table-targets.js";
 import { TableMap, columnIsHeader, removeColumn, removeRow, rowIsHeader, tableNodeTypes } from "prosemirror-tables";
 //#region src/ai-edits/table-row-column-mutations.ts

package/dist/ai-edits/types.d.ts

@@ -122,6 +122,13 @@ type FolioAISignatureParty = {
 };
 type FolioAIEditOperation = FolioAIEditReviewMeta & {
   precondition?: FolioAIEditPrecondition;
+  /**
+   * Groups this operation's produced marks under one logical suggestion so the
+   * host can accept/reject them together. Only consulted in `"suggested"` apply
+   * mode; ignored otherwise. When omitted in suggested mode the applier falls
+   * back to the operation `id`, giving per-operation grouping.
+   */
+  suggestionId?: string;
 } & ({
   id: string;
   type: "replaceInBlock";
@@ -231,7 +238,21 @@ type FolioAIEditOperation = FolioAIEditReviewMeta & {
   type: "splitTableCell"; /** Stable paragraph anchor inside the cell to split. */
   blockId: string;
 });
-type FolioAIEditApplyMode = "direct" | "tracked-changes";
+/**
+ * How AI-authored operations are applied:
+ * - `"direct"` — edits are written straight into the document.
+ * - `"tracked-changes"` — edits land as normal tracked changes (`w:ins`/`w:del`).
+ * - `"suggested"` — edits land as tracked changes carrying `"suggested"`
+ *   provenance: rendered with the tracked-change grammar but stripped from
+ *   serialized DOCX until a human accepts them. Behaves like `"tracked-changes"`
+ *   and covers the inline text/format operations (replaceInBlock, replaceRange,
+ *   formatRange) plus the block and table row/column structural operations
+ *   (insertAfterBlock, insertBeforeBlock, replaceBlock, deleteBlock,
+ *   insertSignatureTable, insertTableRow, deleteTableRow, insertTableColumn,
+ *   deleteTableColumn). Only comment operations and cell merge/split report
+ *   `unsupportedMode`.
+ */
+type FolioAIEditApplyMode = "direct" | "tracked-changes" | "suggested";
 type FolioAIEditSkipReason = "missingBlock" | "changedBlock" | "ambiguousFind" | "missingFind" | "unsupportedBlock" | "unsupportedMode" | "atomicBatchRejected" | "preconditionFailed" | "staleRange" | "emptyOperation"
 /**
  * The operation would not change the document — find equals
@@ -259,6 +280,12 @@ type FolioAIEditAppliedOperation = {
    * belonging to this op.
    */
   revisionIds?: readonly number[];
+  /**
+   * The suggestion id stamped on every mark this operation produced (only set
+   * in `"suggested"` apply mode). Pass it to `acceptSuggestion` /
+   * `rejectSuggestion` / `scrollToSuggestion` to resolve the whole suggestion.
+   */
+  suggestionId?: string;
 };
 type FolioAIEditSkippedOperation = {
   id: string;

package/dist/ai-edits/word-diff.js

@@ -1,11 +1,32 @@
 //#region src/ai-edits/word-diff.ts
 const tokenize = (s) => s.match(/\s+|\S+/gu) ?? [];
+/**
+* Cell budget for the O(n*m) word-diff DP table below, mirroring
+* `MAX_LCS_CELLS` in `version-comparison.ts`. `before`/`after` come from
+* attacker-controlled document text (a `modified` block pair), so an
+* unbounded pair of large strings would otherwise force a quadratic-sized
+* allocation. Past this budget, skip the DP and fall back to a single
+* whole-string `del` + `ins` pair — a coarser diff, but O(1) memory.
+*/
+const MAX_WORD_DIFF_CELLS = 4e6;
 const diffWordSegments = (before, after) => {
 	const a = tokenize(before);
 	const b = tokenize(after);
 	if (a.length === 0 && b.length === 0) return [];
 	const m = a.length;
 	const n = b.length;
+	if (m * n > MAX_WORD_DIFF_CELLS) {
+		const segments = [];
+		if (before.length > 0) segments.push({
+			type: "del",
+			text: before
+		});
+		if (after.length > 0) segments.push({
+			type: "ins",
+			text: after
+		});
+		return segments;
+	}
 	const dp = Array.from({ length: m + 1 }, () => Array.from({ length: n + 1 }, () => 0));
 	for (let i = 0; i < m; i++) for (let j = 0; j < n; j++) {
 		const row = dp[i + 1];

package/dist/compat/eigenpal.d.ts

@@ -27,9 +27,9 @@ import { AcceptAutocompleteResult, AutocompleteSuggestionPluginOptions, Autocomp
 import { ImageMeta, ImageRef, MarkdownOptions, MarkdownResult } from "../markdown/types.js";
 import { fromMarkdown } from "../markdown/fromMarkdown.js";
 import { toMarkdown, toMarkdownResult } from "../markdown/index.js";
-import { EmbeddedFont, EmbeddedFontParts, extractEmbeddedFonts, getEmbeddedFontFaces } from "../fonts/embeddedFonts.js";
-import { getGoogleFontsEnabled, setGoogleFontsEnabled } from "../utils/fontResolver.js";
+import { EmbeddedFont, EmbeddedFontParts, buildEmbeddedFontFamilyMap, extractEmbeddedFonts, getEmbeddedFontFaces, scopeEmbeddedFontFamily } from "../fonts/embeddedFonts.js";
+import { getGoogleFontsEnabled, setEmbeddedFontFamilyMap, setGoogleFontsEnabled } from "../utils/fontResolver.js";
 import { DOCX_CONFORMANCE_CLASSES } from "../index.js";
 type Document = document_d_exports.Document;
 type DocxConformanceClass = document_d_exports.DocxConformanceClass;
-export { type AIBarStatus, type AIChatMode, type AICitation, type AICitationRange, type AICitationSource, type AIGenerateInput, type AISuggestion, type AISuggestionApplyMode, type AISuggestionPreset, type AISuggestionSeverity, type AISuggestionStatus, type AcceptAutocompleteResult, type AnonymizationMatch, type AnonymizationTerm, type ApplyFolioDocumentOperationsOptions, type ApplyResult, type AutocompleteSuggestionPluginOptions, type AutocompleteSuggestionState, type AutocompleteSuggestionStatus, type AutocompleteTriggerCheck, type AutocompleteTriggerOptions, type AutocompleteTriggerSkipReason, type CreateEmptyDocumentOptions, DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DOCX_CONFORMANCE_CLASSES, type DeriveBlockIdInput, type DirectiveKind, type DirectiveRange, type Document, type DocumentPreset, type DocumentStyleCatalog, type DocumentStyleCatalogEntry, type DocumentStyleSet, type DocxCompatibility, type DocxCompatibilityContext, type DocxCompatibilityIssue, type DocxCompatibilityLocation, type DocxCompatibilityPart, type DocxConformanceClass, type EmbeddedFont, type EmbeddedFontParts, type ExtractDocumentStyleSetOptions, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIComment, type FolioAIEditAppliedOperation, type FolioAIEditApplyMode, type FolioAIEditApplyResult, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditReviewMeta, type FolioAIEditSeverity, type FolioAIEditSkipReason, type FolioAIEditSkippedOperation, type FolioAIEditSnapshot, type FolioAISignatureParty, type FolioBlockId, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationStatus, type FolioDocumentOperationStory, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type FolioDocxCompatibilityHost, type FolioDocxCompatibilityProfile, type ImageMeta, type ImageRef, type InspectDocxCompatibilityOptions, InvalidFolioDocumentOperationBatchError, type MarkdownOptions, type MarkdownResult, type PositionalText, type ResolvedAnchor, STELLA_STYLE_SET_NAME, type TemplatePreviewSpan, type TemplatePreviewValue, type TemplatePreviewValues, type TemplateSlashMenuKeyAction, type TemplateSlashMenuState, UnsupportedFolioDocumentOperationVersionError, type WordDiffSegment, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, createStellaStyleDocumentPreset, createStellaStyleSet, deriveBlockId, diffWordSegments, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxCompatibility, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };
+export { type AIBarStatus, type AIChatMode, type AICitation, type AICitationRange, type AICitationSource, type AIGenerateInput, type AISuggestion, type AISuggestionApplyMode, type AISuggestionPreset, type AISuggestionSeverity, type AISuggestionStatus, type AcceptAutocompleteResult, type AnonymizationMatch, type AnonymizationTerm, type ApplyFolioDocumentOperationsOptions, type ApplyResult, type AutocompleteSuggestionPluginOptions, type AutocompleteSuggestionState, type AutocompleteSuggestionStatus, type AutocompleteTriggerCheck, type AutocompleteTriggerOptions, type AutocompleteTriggerSkipReason, type CreateEmptyDocumentOptions, DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DOCX_CONFORMANCE_CLASSES, type DeriveBlockIdInput, type DirectiveKind, type DirectiveRange, type Document, type DocumentPreset, type DocumentStyleCatalog, type DocumentStyleCatalogEntry, type DocumentStyleSet, type DocxCompatibility, type DocxCompatibilityContext, type DocxCompatibilityIssue, type DocxCompatibilityLocation, type DocxCompatibilityPart, type DocxConformanceClass, type EmbeddedFont, type EmbeddedFontParts, type ExtractDocumentStyleSetOptions, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIComment, type FolioAIEditAppliedOperation, type FolioAIEditApplyMode, type FolioAIEditApplyResult, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditReviewMeta, type FolioAIEditSeverity, type FolioAIEditSkipReason, type FolioAIEditSkippedOperation, type FolioAIEditSnapshot, type FolioAISignatureParty, type FolioBlockId, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationStatus, type FolioDocumentOperationStory, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type FolioDocxCompatibilityHost, type FolioDocxCompatibilityProfile, type ImageMeta, type ImageRef, type InspectDocxCompatibilityOptions, InvalidFolioDocumentOperationBatchError, type MarkdownOptions, type MarkdownResult, type PositionalText, type ResolvedAnchor, STELLA_STYLE_SET_NAME, type TemplatePreviewSpan, type TemplatePreviewValue, type TemplatePreviewValues, type TemplateSlashMenuKeyAction, type TemplateSlashMenuState, UnsupportedFolioDocumentOperationVersionError, type WordDiffSegment, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildEmbeddedFontFamilyMap, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, createStellaStyleDocumentPreset, createStellaStyleSet, deriveBlockId, diffWordSegments, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxCompatibility, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scopeEmbeddedFontFamily, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setEmbeddedFontFamilyMap, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };

package/dist/compat/eigenpal.js

@@ -1,6 +1,6 @@
+import { getGoogleFontsEnabled, setEmbeddedFontFamilyMap, setGoogleFontsEnabled } from "../utils/fontResolver.js";
 import { deriveBlockId, getFolioParaIdFromBlockId, isFolioBlockId, isSequentialFolioBlockId } from "../types/block-id.js";
 import { createFolioAIEditSnapshot, hashFolioAIBlockText, normalizeFolioAIBlockText } from "../ai-edits/snapshot.js";
-import { getGoogleFontsEnabled, setGoogleFontsEnabled } from "../utils/fontResolver.js";
 import { diffWordSegments } from "../ai-edits/word-diff.js";
 import { applyFolioAIEditOperations } from "../ai-edits/apply.js";
 import { FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch } from "../document-operations.js";
@@ -25,6 +25,6 @@ import { clearTemplateSlashMenu, consumeTemplateSlashQuery, getTemplateSlashMenu
 import { DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, acceptAutocompleteSuggestion, acceptAutocompleteWord, appendAutocompleteToken, autocompleteSuggestionKey, autocompleteSuggestionPlugin, clearAutocompleteSuggestion, finishAutocompleteSuggestion, getAutocompleteSuggestion, shouldTriggerAutocomplete, startAutocompleteSuggestion } from "../prosemirror/plugins/autocompleteSuggestion.js";
 import { fromMarkdown } from "../markdown/fromMarkdown.js";
 import { toMarkdown, toMarkdownResult } from "../markdown/index.js";
-import { extractEmbeddedFonts, getEmbeddedFontFaces } from "../fonts/embeddedFonts.js";
+import { buildEmbeddedFontFamilyMap, extractEmbeddedFonts, getEmbeddedFontFaces, scopeEmbeddedFontFamily } from "../fonts/embeddedFonts.js";
 import { DOCX_CONFORMANCE_CLASSES } from "../index.js";
-export { DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DOCX_CONFORMANCE_CLASSES, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, InvalidFolioDocumentOperationBatchError, STELLA_STYLE_SET_NAME, UnsupportedFolioDocumentOperationVersionError, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, createStellaStyleDocumentPreset, createStellaStyleSet, deriveBlockId, diffWordSegments, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxCompatibility, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };
+export { DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, DOCUMENT_PRESET_VERSION, DOCUMENT_STYLE_SET_VERSION, DOCX_CONFORMANCE_CLASSES, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, InvalidFolioDocumentOperationBatchError, STELLA_STYLE_SET_NAME, UnsupportedFolioDocumentOperationVersionError, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildEmbeddedFontFamilyMap, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, createStellaStyleDocumentPreset, createStellaStyleSet, deriveBlockId, diffWordSegments, extractDocumentStyleSet, extractDocumentStyleSetFromDocx, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, inspectDocumentStyles, inspectDocumentStylesFromDocx, inspectDocxCompatibility, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scopeEmbeddedFontFamily, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setEmbeddedFontFamilyMap, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };

package/dist/controller/headerFooterEditorManager.js

@@ -1,4 +1,3 @@
-import { proseDocToBlocks } from "../prosemirror/conversion/fromProseDoc.js";
 import { ExtensionManager } from "../prosemirror/extensions/ExtensionManager.js";
 import { ensureBaseDirectionInState } from "../prosemirror/extensions/features/AutoBidiDetectionExtension.js";
 import { createDocumentStylesPlugin } from "../prosemirror/plugins/documentStyles.js";
@@ -6,6 +5,7 @@ import { ensureParaIdsInState } from "../prosemirror/extensions/features/ParaIdA
 import { createStarterKit } from "../prosemirror/extensions/StarterKit.js";
 import { schema } from "../prosemirror/schema/index.js";
 import { headerFooterToProseDoc } from "../prosemirror/conversion/toProseDoc.js";
+import { proseDocToBlocks } from "../prosemirror/conversion/fromProseDoc.js";
 import { clearHeaderFooterVerbatimXml } from "../docx/headerFooterVerbatim.js";
 import { EditorState } from "prosemirror-state";
 import { EditorView } from "prosemirror-view";