@stll/folio-core 0.54.1 → 0.55.0

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

@@ -20,7 +20,7 @@ type FolioAIEditView = {
 /**
  * Fixed revision provenance, for callers whose output must be reproducible.
  * Both halves of the stamp travel together because either one left to the
- * ambient clock (`new Date()` for the date, a `Date.now()`-seeded cursor for
+ * ambient clock (`new Date()` for the date, the shared bounded allocator for
  * the ids) makes the produced package differ between two runs over the same
  * inputs. `idSeed` starts a contiguous range the batch allocates from, so it
  * must sit above every revision id the target document already carries.

package/dist/ai-edits/apply.js

@@ -21,6 +21,7 @@ import { carryParagraphProperties, paragraphLeftAfter, propertiesSetInBatch, rec
 import { directParagraphSpacing, paragraphSpacingAttrPatch, paragraphSpacingEqual, paragraphSpacingFromFormatting, withDirectParagraphSpacing } from "../prosemirror/paragraphSpacing.js";
 import { getDocumentNumbering, getDocumentNumberingInstanceIds } from "../prosemirror/plugins/documentNumbering.js";
 import { getDocumentStyleDefinitions, getDocumentStyleResolver } from "../prosemirror/plugins/documentStyleState.js";
+import { claimRevisionIds, nextRevisionId, nextRevisionIdRange, reserveRevisionIds, seedRevisionIdsFromDoc } from "../prosemirror/plugins/revisionIds.js";
 import { rebaseParagraphRuns } from "../prosemirror/rebaseParagraphRuns.js";
 import { NON_INCLUSIVE_MARK_DISPOSITION, addCarriedMarks, annotatedReplacement, commentsAcrossBlockBoundary, commentsForTrackedInsertion, hasReplacedAnnotations, inheritedReplacementMarks, placeTrackedInsertion, surveyReplacedAnnotations } from "../prosemirror/replacedAnnotations.js";
 import { applyMarksToRunFormattingRepresentation, runFormattingInlineControlNodeName, selectRunFormattingCarrierRepresentations } from "../prosemirror/runFormattingInlineCarriers.js";
@@ -825,24 +826,6 @@ const applyTrackedInlineFormattingToRanges = ({ tr, schema, doc = tr.doc, ranges
 	};
 };
 /**
-* Module-scoped monotonic counter for tracked-change revision ids.
-* Seeded once from `Date.now()` so ids are roughly time-ordered for
-* humans reading raw DOCX, then incremented per allocation. A bare
-* `Date.now()` seed per applyAIEditOperations call would collide
-* across batches that fire within the same millisecond (the panel's
-* Accept-all loop does exactly that — multiple calls in tight
-* succession).
-*
-* A batch without a revision stamp allocates from it as it writes and claims
-* each operation's ids once they are written, rather than reserving a guess
-* up front: how many revisions an operation records is known only once it has
-* recorded them (clearing a background records one run-property change per
-* carrier). The claim also comes before anything that may start another
-* batch, a comment-id callback or the dispatch, so batches in one realm never
-* share an id and follow one another without a gap.
-*/
-let revisionIdCursor = Date.now() * 1e3;
-/**
 * Walk the live doc once and bucket every textblock by its
 * normalised text hash. Resolution then maps each snapshot anchor
 * to the live block at the same ordinal among same-hash siblings —
@@ -1502,6 +1485,22 @@ const finalParagraphPredecessor = (doc, at) => {
 	}
 	return null;
 };
+/**
+* Whether a sibling between a final carrier's predecessor and the carrier
+* has its break deleted by this batch.
+*/
+const crossesBatchDeletion = ({ doc, from, to, batchRevisionIds }) => {
+	const $to = doc.resolve(to);
+	let position = to;
+	for (let index = $to.index() - 1; index >= 0 && position > from; index--) {
+		const node = $to.parent.child(index);
+		position -= node.nodeSize;
+		const mark = node.attrs["pPrMark"];
+		const revisionId = isPlainDeletedPPrMark(mark) ? addedOrDeletedBreakRevisionId(mark) : null;
+		if (revisionId !== null && batchRevisionIds.has(revisionId)) return true;
+	}
+	return false;
+};
 /** Pending retirements, read after the merge has mapped any inserted separator. */
 const pendingRemovedFinalBreakPositions = (tr, deletions) => {
 	const positions = /* @__PURE__ */ new Set();
@@ -1586,7 +1585,12 @@ const withRetiredFinalParagraphs = ({ tr, deletions, mergedPropertyTargets, appl
 					date,
 					...revisionExtras
 				},
-				keep: propertiesSetInBatch(emptied, batchRevisionIds)
+				keep: crossesBatchDeletion({
+					doc: tr.doc,
+					from: position + previous.nodeSize,
+					to: at,
+					batchRevisionIds
+				}) ? /* @__PURE__ */ new Set() : propertiesSetInBatch(emptied, batchRevisionIds)
 			});
 			resolvedOperationIds.add(operationId);
 			addedRevisions.push({
@@ -2060,6 +2064,7 @@ const buildInsertedParagraphs = ({ item, schema, formattingFromStyle, mode, auth
 	};
 };
 const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations: requestedOperations, mode = "tracked-changes", author = "AI", initials, createCommentId, revisionStamp, revisionIdSeed, wordDiff, wordDiffMode = "bounded", tableTemplates, replacementBackground = "clear", undefinedStyles = "refuse" }) => {
+	seedRevisionIdsFromDoc(view.state.doc);
 	const applied = [];
 	const skipped = [];
 	const normalizations = [];
@@ -2116,7 +2121,7 @@ const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations: reques
 			id: operation.id,
 			reason: "unsupportedBlock"
 		})),
-		nextRevisionId: revisionIdSeed ?? revisionStamp?.idSeed ?? revisionIdCursor
+		nextRevisionId: revisionIdSeed ?? revisionStamp?.idSeed ?? nextRevisionId()
 	};
 	const liveBlocks = collectLiveBlocksByHash(view.state.doc);
 	const liveBlocksByParaId = collectLiveBlocksByParaId(view.state.doc);
@@ -2226,14 +2231,14 @@ const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations: reques
 		item,
 		operationId: item.operation.id,
 		target: getTableMutationPlanTarget(item)
-	})));
+	})), view.state.doc);
 	skipped.push(...tablePlan.skipped);
 	const executableResolved = tablePlan.executable;
 	if (executableResolved.length === 0) return {
 		applied,
 		skipped,
 		...normalizations.length > 0 && { normalizations },
-		nextRevisionId: revisionIdSeed ?? revisionStamp?.idSeed ?? revisionIdCursor
+		nextRevisionId: revisionIdSeed ?? revisionStamp?.idSeed ?? nextRevisionId()
 	};
 	const moveSideCounts = /* @__PURE__ */ new Map();
 	for (const { operation } of executableResolved) {
@@ -2268,17 +2273,20 @@ const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations: reques
 	const mergedPropertyTargets = [];
 	const deferredNoopFinalDeletions = /* @__PURE__ */ new Set();
 	const ownsSharedRevisionIdCursor = revisionIdSeed === void 0 && revisionStamp === void 0;
-	let revisionSeed = revisionIdSeed ?? revisionStamp?.idSeed ?? revisionIdCursor;
-	/**
-	* Claim the shared ids below `nextRevisionId` for this batch. A seeded or
-	* stamped batch allocates from its own range and claims nothing.
-	*/
-	const claimSharedRevisionIds = (nextRevisionId) => {
-		if (ownsSharedRevisionIdCursor) revisionIdCursor = Math.max(revisionIdCursor, nextRevisionId);
+	let revisionSeed = revisionIdSeed ?? revisionStamp?.idSeed ?? nextRevisionIdRange();
+	let claimedThrough = revisionSeed;
+	const claimSharedRevisionIds = (next) => {
+		if (revisionIdSeed !== void 0) return;
+		if (ownsSharedRevisionIdCursor) claimRevisionIds(claimedThrough, next);
+		else reserveRevisionIds(claimedThrough, next);
+		claimedThrough = next;
 	};
-	/** Continue past any shared id a batch the host started meanwhile claimed. */
+	/** Continue past ids a reentrant callback allocated in this realm. */
 	const continueSharedRevisionIds = () => {
-		if (ownsSharedRevisionIdCursor) revisionSeed = Math.max(revisionSeed, revisionIdCursor);
+		if (ownsSharedRevisionIdCursor && nextRevisionId() !== claimedThrough) {
+			revisionSeed = nextRevisionIdRange();
+			claimedThrough = revisionSeed;
+		}
 	};
 	const date = revisionStamp?.date ?? (/* @__PURE__ */ new Date()).toISOString();
 	const insertedColumnCounts = /* @__PURE__ */ new Map();
@@ -3738,7 +3746,7 @@ const previewFolioAIEditOperationsWithResult = (options) => {
 			applied: result.applied.map(({ id }) => ({ id })),
 			skipped: result.skipped,
 			...result.normalizations !== void 0 && { normalizations: result.normalizations },
-			nextRevisionId: options.revisionStamp?.idSeed ?? revisionIdCursor
+			nextRevisionId: options.revisionStamp?.idSeed ?? nextRevisionId()
 		},
 		doc: previewView.state.doc,
 		commentIds

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

@@ -179,7 +179,7 @@ type FolioDocxComparisonStoryProjection = {
 type FolioDocxComparisonProjection = {
   stories: readonly FolioDocxComparisonStoryProjection[];
   revisions: {
-    highestId: number;
+    ids: readonly number[];
     present: boolean;
   };
 };
@@ -350,7 +350,6 @@ declare class FolioDocxReviewer {
   private readonly importedFooters;
   private readonly resolvedStoryExpectations;
   private readonly createdComments;
-  private readonly usedCommentIds;
   /** Comments the body anchored when it was loaded, read as the editor projects it. */
   private readonly loadedMainCommentIds;
   private readonly documentOperationUndoEntries;

package/dist/ai-edits/headless.js

@@ -7,6 +7,7 @@ import { applyReplyThreadMarkers } from "../docx/commentReplyMarkers.js";
 import { rebindDrawingImageRelationship } from "../docx/drawingRelationships.js";
 import { getEndnoteText, getFootnoteText, isSeparatorEndnote, isSeparatorFootnote } from "../docx/footnoteParser.js";
 import { getHeaderFooterText } from "../docx/headerFooterParser.js";
+import { createNumberingIdAllocator } from "../docx/numberingIds.js";
 import { getCachedNumberingMap } from "../docx/numberingParser.js";
 import { recreateProseNodeWithParagraphPropertySource, transferProseParagraphPropertySource } from "../docx/paragraphPropertySource.js";
 import { parseDocx } from "../docx/parser.js";
@@ -20,6 +21,7 @@ import { captureSectionReferenceInventory, resolvedSectionReferenceLosses, withS
 import { expectCharacterStyleMarkAttrs, expectFootnoteRefMarkAttrs } from "../prosemirror/attrs/index.js";
 import { acceptAIEditRevision, acceptSuggestion, getSuggestions, rejectAIEditRevision, rejectAllSuggestions, rejectSuggestion, resolveAllChangesInHeadlessState, suggestionIdOfRevision } from "../prosemirror/commands/comments.js";
 import { sectionRejectProperties } from "../prosemirror/commands/propertyChangeScope.js";
+import { allocateCommentId, createCommentIdAllocator, seedCommentAllocator } from "../prosemirror/commentIdAllocator.js";
 import { proseDocToBlocks, updateDocumentContent } from "../prosemirror/conversion/fromProseDoc.js";
 import { footnoteToProseDoc, headerFooterToProseDoc, toProseDoc } from "../prosemirror/conversion/toProseDoc.js";
 import { ensureBaseDirectionInState } from "../prosemirror/extensions/features/AutoBidiDetectionExtension.js";
@@ -68,14 +70,6 @@ import JSZip from "jszip";
 *
 * Scope: main, header, footer, footnote, and endnote blocks.
 */
-/**
-* Standalone comment-id allocator for the reviewer. The React editor uses
-* `Date.now()`-seeded ids from `commentsHelpers`; that module is DOM-bound
-* (`EditorView`, `findBodyPmAnchors`) and unimportable here, so the reviewer
-* mints its own. Seeded once per realm and incremented so ids stay unique
-* across reviewers created within the same millisecond.
-*/
-let commentIdCursor = Date.now();
 let undoHandleCursor = Date.now();
 const createReviewerComment = ({ id, text, author, date }) => ({
 	id,
@@ -399,7 +393,6 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 	importedFooters = /* @__PURE__ */ new Map();
 	resolvedStoryExpectations = /* @__PURE__ */ new Map();
 	createdComments = [];
-	usedCommentIds;
 	/** Comments the body anchored when it was loaded, read as the editor projects it. */
 	loadedMainCommentIds;
 	documentOperationUndoEntries = [];
@@ -418,7 +411,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 		this.originalBuffer = args.originalBuffer;
 		this.state = args.state;
 		this.author = args.author;
-		this.usedCommentIds = new Set((args.baseDocument.package.document.comments ?? []).map(({ id }) => id));
+		seedCommentAllocator(createCommentIdAllocator(), args.baseDocument.package.document.comments, { state: args.state });
 		this.loadedMainCommentIds = anchoredCommentIdsInProseDoc(args.state.doc);
 		comparisonAccessByReviewer.set(this, Object.freeze({
 			stageTerminalTableReviewCarrier: (target) => this.stageTerminalTableReviewCarrier(target),
@@ -571,8 +564,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 		const targetAbstracts = new Map(target.abstractNums.map((entry) => [entry.abstractNumId, entry]));
 		const levelsByNumId = referencedNumberingLevelsByNumId({ references });
 		const importedAbstractIds = /* @__PURE__ */ new Map();
-		let nextAbstractId = 0;
-		for (const id of abstracts.keys()) nextAbstractId = Math.max(nextAbstractId, id + 1);
+		const abstractIds = createNumberingIdAllocator("abstract", [...abstracts.keys(), ...targetAbstracts.keys()]);
 		for (const numId of levelsByNumId.keys()) {
 			const targetNum = targetNums.get(numId);
 			if (!targetNum) return "conflict";
@@ -592,8 +584,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 			if (abstractNumId === void 0) {
 				abstractNumId = targetAbstract.abstractNumId;
 				const collision = abstracts.get(abstractNumId);
-				if (collision && canonicalJson(collision) !== canonicalJson(targetAbstract)) abstractNumId = nextAbstractId++;
-				nextAbstractId = Math.max(nextAbstractId, abstractNumId + 1);
+				if (collision && canonicalJson(collision) !== canonicalJson(targetAbstract)) abstractNumId = abstractIds.next();
 				importedAbstractIds.set(targetAbstract.abstractNumId, abstractNumId);
 				abstracts.set(abstractNumId, {
 					...targetAbstract,
@@ -628,9 +619,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 		const targetNums = new Map(target.nums.map((entry) => [entry.numId, entry]));
 		const targetAbstracts = new Map(target.abstractNums.map((entry) => [entry.abstractNumId, entry]));
 		const levelsByNumId = referencedNumberingLevelsByNumId({ references });
-		let nextNumId = 0;
-		for (const id of nums.keys()) nextNumId = Math.max(nextNumId, id + 1);
-		for (const id of targetNums.keys()) nextNumId = Math.max(nextNumId, id + 1);
+		const numberingIds = createNumberingIdAllocator("num", [...nums.keys(), ...targetNums.keys()]);
 		const remapped = /* @__PURE__ */ new Map();
 		for (const numId of levelsByNumId.keys()) {
 			const targetNum = targetNums.get(numId);
@@ -642,7 +631,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 				target,
 				numId,
 				levelsByNumId
-			})) remapped.set(numId, nextNumId++);
+			})) remapped.set(numId, numberingIds.next());
 		}
 		return remapped;
 	}
@@ -759,18 +748,18 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 	}
 	projectComparisonStoriesInternal(mode) {
 		const handles = this.listStoryHandlesInternal();
-		let highestId = 0;
+		const ids = /* @__PURE__ */ new Set();
 		let present = false;
 		if (mode === "with-revision-census") {
 			for (const change of this.currentFinalSectionProperties()?.propertyChanges ?? []) {
-				highestId = Math.max(highestId, change.info.id);
+				ids.add(change.info.id);
 				present = true;
 			}
 			for (const handle of handles) {
 				const state = this.getEditableStoryState(handle);
 				if (!state) continue;
 				const stats = getTrackedChangeStatsFromDoc(state.doc);
-				highestId = Math.max(highestId, stats.highestId);
+				for (const id of stats.ids) ids.add(id);
 				present ||= stats.present;
 			}
 		}
@@ -785,7 +774,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 		return {
 			stories,
 			revisions: {
-				highestId,
+				ids: [...ids],
 				present
 			}
 		};
@@ -1231,7 +1220,6 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 		});
 		if (!reply) return null;
 		this.createdComments.push(reply);
-		this.usedCommentIds.add(reply.id);
 		this.anchorReplyInEditor({
 			parentId: reply.parentId ?? parentId,
 			replyId: reply.id
@@ -1907,6 +1895,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 		const source = story.type === "header" || story.type === "footer" ? this.getHeaderFooterStory(story) : this.getNoteStory(story);
 		if (!source) return null;
 		const conversionOptions = {
+			...this.baseDocument.package.numbering !== void 0 && { numbering: this.baseDocument.package.numbering },
 			...this.baseDocument.package.styles !== void 0 && { styles: this.baseDocument.package.styles },
 			...this.baseDocument.package.theme !== void 0 && { theme: this.baseDocument.package.theme }
 		};
@@ -2186,10 +2175,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 	}
 	/** Allocate outside every parsed or newly-created comment and reply id. */
 	nextCommentId() {
-		while (this.usedCommentIds.has(commentIdCursor)) commentIdCursor += 1;
-		const id = commentIdCursor++;
-		this.usedCommentIds.add(id);
-		return id;
+		return allocateCommentId();
 	}
 	/**
 	* Drive a ProseMirror command against the reviewer's headless state via the

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

@@ -76,6 +76,7 @@ declare const getTrackedChangeGroupIdsFromDoc: (doc: Node, id: number) => number
 declare const getTrackedChangeStatsFromDoc: (doc: Node) => {
   highestId: number;
   present: boolean;
+  ids: readonly number[];
 };
 /**
  * The comment anchors present in the body, read from the `comment` mark the

package/dist/ai-edits/read.js

@@ -313,11 +313,16 @@ const getTrackedChangeGroupIdsFromDoc = (doc, id) => getTrackedChangeGroupsFromP
 /** @internal Read revision statistics without paying for an unrelated block projection. */
 const getTrackedChangeStatsFromDoc = (doc) => {
 	let highestId = 0;
+	const revisionIds = /* @__PURE__ */ new Set();
 	const groups = getTrackedChangeGroupsFromProjectedDoc(doc, null);
-	for (const { ids } of groups) for (const id of ids) highestId = Math.max(highestId, id);
+	for (const { ids } of groups) for (const id of ids) {
+		highestId = Math.max(highestId, id);
+		revisionIds.add(id);
+	}
 	return {
 		highestId,
-		present: groups.length > 0
+		present: groups.length > 0,
+		ids: [...revisionIds]
 	};
 };
 /**

package/dist/ai-edits/table-mutation-plan.d.ts

@@ -1,3 +1,4 @@
+import { Node } from "prosemirror-model";
 //#region src/ai-edits/table-mutation-plan.d.ts
 type TableRectangle = {
   left: number;
@@ -32,7 +33,7 @@ type TableMutationPlan<T> = {
   executable: T[];
   skipped: TableMutationPlanSkip[];
 };
-declare const planTableMutations: <T>(candidates: readonly TableMutationPlanCandidate<T>[]) => TableMutationPlan<T>;
+declare const planTableMutations: <T>(candidates: readonly TableMutationPlanCandidate<T>[], doc: Node) => TableMutationPlan<T>;
 declare const tableRectanglesEqual: (left: TableRectangle, right: TableRectangle) => boolean;
 //#endregion
 export { TableMutationPlanTarget, TableRectangle, planTableMutations, tableRectanglesEqual };

package/dist/ai-edits/table-mutation-plan.js

@@ -1,5 +1,7 @@
+import { panic } from "better-result";
+import { TableMap } from "prosemirror-tables";
 //#region src/ai-edits/table-mutation-plan.ts
-const planTableMutations = (candidates) => {
+const planTableMutations = (candidates, doc) => {
 	const tableStructureMutations = /* @__PURE__ */ new Set();
 	const mergeTables = /* @__PURE__ */ new Set();
 	const splitTables = /* @__PURE__ */ new Set();
@@ -44,6 +46,17 @@ const planTableMutations = (candidates) => {
 				});
 				continue;
 			}
+			if (claimedRectangles.length > 0 && mergesRemoveRow({
+				doc,
+				tablePosition: target.tablePosition,
+				rectangles: [...claimedRectangles, target.rectangle]
+			})) {
+				skipped.push({
+					id: candidate.operationId,
+					reason: "unsupportedBlock"
+				});
+				continue;
+			}
 			claimedRectangles.push(target.rectangle);
 			mergeRectanglesByTable.set(target.tablePosition, claimedRectangles);
 			executable.push(candidate.item);
@@ -84,6 +97,31 @@ const planTableMutations = (candidates) => {
 		skipped
 	};
 };
+/**
+* Disjoint merges can still share a row's survival. Direct merging closes a
+* row left without cells, invalidating other rectangles' original row indices;
+* tracked merging cannot record that removal. Keep a row-removing merge alone
+* and refuse the later merge when their combined folded cells empty a row.
+*/
+const mergesRemoveRow = ({ doc, tablePosition, rectangles }) => {
+	const table = doc.nodeAt(tablePosition);
+	if (table?.type.spec["tableRole"] !== "table") return panic("A planned cell merge lost its table", { position: tablePosition });
+	const map = TableMap.get(table);
+	const folded = /* @__PURE__ */ new Set();
+	for (const rectangle of rectangles) {
+		const kept = map.map[rectangle.top * map.width + rectangle.left];
+		for (const position of map.cellsInRect(rectangle)) if (position !== kept) folded.add(position);
+	}
+	let removesRow = false;
+	table.forEach((row, rowOffset) => {
+		let remaining = row.childCount;
+		row.forEach((_cell, cellOffset) => {
+			if (folded.has(rowOffset + 1 + cellOffset)) remaining--;
+		});
+		if (row.childCount > 0 && remaining === 0) removesRow = true;
+	});
+	return removesRow;
+};
 const tableRectanglesOverlap = (left, right) => left.left < right.right && right.left < left.right && left.top < right.bottom && right.top < left.bottom;
 const tableRectanglesEqual = (left, right) => left.left === right.left && left.top === right.top && left.right === right.right && left.bottom === right.bottom;
 //#endregion

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

@@ -6,7 +6,7 @@ type ApplyResult = {
   stale: string[];
 };
 type ApplyOptions = {
-  view: EditorView;
+  view: Pick<EditorView, "state" | "dispatch">;
   suggestions: AISuggestion[];
   mode: AISuggestionApplyMode;
   author: string;

package/dist/ai-suggestions/apply.js

@@ -1,3 +1,4 @@
+import { mintRevisionId, seedRevisionIdsFromDoc } from "../prosemirror/plugins/revisionIds.js";
 import { resolveSuggestionAnchor } from "./conflict.js";
 //#region src/ai-suggestions/apply.ts
 function applySuggestions(options) {
@@ -39,10 +40,10 @@ function applySuggestions(options) {
 			stale: [...stale, ...resolved.map((r) => r.suggestion.id)]
 		};
 		const date = (/* @__PURE__ */ new Date()).toISOString();
-		let revisionSeed = Date.now();
+		seedRevisionIdsFromDoc(view.state.doc);
 		for (const { suggestion, from, to } of resolved) {
 			const attrs = {
-				revisionId: revisionSeed++,
+				revisionId: mintRevisionId(),
 				author,
 				date
 			};

package/dist/compare/compare.js

@@ -10,6 +10,7 @@ import { isAltChunkMarkup } from "../docx/altChunk.js";
 import { isOpaqueNestedRowMarkup, opaqueRevisionCarrierName } from "../docx/opaqueCarrier.js";
 import { sectionReferenceHistory } from "../docx/sectionReferenceHistory.js";
 import { sameCanonicalInlinePresentation } from "../internal/compare/inline-presentation.js";
+import { revisionIdSeedAbove } from "../prosemirror/plugins/revisionIds.js";
 import { createStyleResolver } from "../prosemirror/styles/styleResolver.js";
 import { canonicalJson } from "../utils/canonicalJson.js";
 import { createContentComparisonWorkSession } from "./content.js";
@@ -386,7 +387,7 @@ const parseComparison = async (base, target, options) => {
 		reviewer,
 		revisionStamp: {
 			date: options.timestamp,
-			idSeed: baseProjection.revisions.highestId + 1
+			idSeed: revisionIdSeedAbove(baseProjection.revisions.ids)
 		},
 		packageDate,
 		pairs: comparisonPairs,

package/dist/compare/content-types.d.ts

@@ -83,14 +83,9 @@ type FolioContentTableLocation = {
  */
 type FolioContentParagraphAlignment = document_d_exports.ParagraphAlignment;
 /** Line-height interpretation understood by the neutral comparison model. */
-type FolioContentLineSpacingRule = "auto" | "exact" | "atLeast";
+type FolioContentLineSpacingRule = NonNullable<document_d_exports.ParagraphFormatting["lineSpacingRule"]>;
 /** The complete modeled attribute set of direct paragraph indentation. */
-type FolioContentParagraphIndentation = {
-  indentLeft?: number;
-  indentRight?: number;
-  indentFirstLine?: number;
-  hangingIndent?: boolean;
-};
+type FolioContentParagraphIndentation = Pick<document_d_exports.ParagraphFormatting, "indentLeft" | "indentRight" | "indentFirstLine" | "hangingIndent">;
 /** A concrete numbering instance and its zero-based level. */
 type FolioContentListReference = {
   numId: number;
@@ -100,14 +95,7 @@ type FolioContentListReference = {
  * The complete modeled attribute set of direct paragraph spacing. Optional
  * fields distinguish an absent attribute from an explicit zero or false value.
  */
-type FolioContentParagraphSpacing = {
-  spaceBefore?: number;
-  spaceAfter?: number;
-  lineSpacing?: number;
-  lineSpacingRule?: FolioContentLineSpacingRule;
-  beforeAutospacing?: boolean;
-  afterAutospacing?: boolean;
-};
+type FolioContentParagraphSpacing = Pick<document_d_exports.ParagraphFormatting, "spaceBefore" | "spaceAfter" | "lineSpacing" | "lineSpacingRule" | "beforeAutospacing" | "afterAutospacing">;
 /** A representation-neutral block in one ordered document story. */
 type FolioContentBlock<Kind extends string = string> = {
   id: string;

package/dist/controller/canonicalComposition.d.ts

@@ -0,0 +1,36 @@
+import { EditorState, Transaction } from "prosemirror-state";
+import { EditorView } from "prosemirror-view";
+//#region src/controller/canonicalComposition.d.ts
+type CompositionOptions = {
+  begin: () => boolean;
+  end: () => void;
+  replace: (input: {
+    from: number;
+    to: number;
+    text: string;
+    semantic: "composition";
+  }) => void;
+  refuse: (reason: string) => void;
+};
+type CompositionState = {
+  type: "committed";
+} | {
+  type: "provisional" | "refused";
+  baseline: EditorState;
+  phase: "active" | "ended";
+};
+/** Native IME owns the provisional view; the captured canonical projection stays unchanged. */
+declare const createCanonicalComposition: (options: CompositionOptions) => {
+  readonly status: CompositionState["type"];
+  readonly active: boolean;
+  start: (view: EditorView) => void;
+  ended: (view: EditorView) => void;
+  authorizeNative: (view: EditorView) => void;
+  flushed: (view: EditorView) => void;
+  recover: (view: EditorView) => void;
+  cancel: (view: EditorView) => void;
+  reset: () => void;
+  accept: (view: EditorView, transaction: Transaction) => boolean;
+};
+//#endregion
+export { createCanonicalComposition };