@stll/folio-core 0.37.0 → 0.37.2

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

@@ -1,3 +1,4 @@
+import { FolioAIEditSnapshot } from "./types.js";
 import { FolioNodeRevisionKind } from "../prosemirror/revisionCarriers.js";
 import { Node } from "prosemirror-model";
 //#region src/ai-edits/read.d.ts
@@ -56,6 +57,8 @@ type FolioCommentAnchor = {
   /** The document text the comment is anchored to. */
   quote: string;
 };
+/** Read revisions from the exact immutable document that produced a snapshot. */
+declare const getTrackedChangesFromSnapshot: (snapshot: FolioAIEditSnapshot) => FolioReviewChange[];
 /**
  * The tracked changes present in the body, read from inline marks and
  * structural node attributes. Runs of one inline revision within a block fold
@@ -66,6 +69,11 @@ type FolioCommentAnchor = {
  * fold into the row's entry rather than reporting a second time.
  */
 declare const getTrackedChangesFromDoc: (doc: Node) => FolioReviewChange[];
+/** @internal Read revision statistics without paying for an unrelated block projection. */
+declare const getTrackedChangeStatsFromDoc: (doc: Node) => {
+  highestId: number;
+  present: boolean;
+};
 /**
  * The comment anchors present in the body, read from the `comment` mark the
  * editor renders. Each entry carries the anchored text and containing block id;
@@ -73,4 +81,4 @@ declare const getTrackedChangesFromDoc: (doc: Node) => FolioReviewChange[];
  */
 declare const getCommentAnchorsFromDoc: (doc: Node) => FolioCommentAnchor[];
 //#endregion
-export { FOLIO_REVIEW_CHANGE_KINDS, FolioCommentAnchor, FolioReviewChange, FolioReviewChangeKind, getCommentAnchorsFromDoc, getTrackedChangesFromDoc };
+export { FOLIO_REVIEW_CHANGE_KINDS, FolioCommentAnchor, FolioReviewChange, FolioReviewChangeKind, getCommentAnchorsFromDoc, getTrackedChangeStatsFromDoc, getTrackedChangesFromDoc, getTrackedChangesFromSnapshot };

package/dist/ai-edits/read.js

@@ -2,7 +2,7 @@ import { expectRunPropertyChangeMarkAttrs } from "../prosemirror/attrs/index.js"
 import { getFolioNodeRevisionCarriers } from "../prosemirror/revisionCarriers.js";
 import { expandRunFormattingCarrier, runFormattingCarrierReviewText, runFormattingInlineAtomDisposition } from "../prosemirror/runFormattingInlineCarriers.js";
 import { getTableCellMergeChange } from "../prosemirror/tableCellMergeRevision.js";
-import { createFolioAIEditSnapshot } from "./snapshot.js";
+import { createFolioAIEditSnapshot, sourceDocumentOf } from "./snapshot.js";
 //#region src/ai-edits/read.ts
 /**
 * Runtime census of every tracked-change discriminator the reviewer exposes.
@@ -31,11 +31,16 @@ const FOLIO_REVIEW_CHANGE_KINDS = Object.freeze({
 });
 /** Map each snapshot block's start position to its stable id. */
 const blockStartIdsFromDoc = (doc) => {
+	return blockStartIdsFromSnapshot(createFolioAIEditSnapshot(doc));
+};
+/** Map an existing snapshot's block starts without projecting its document again. */
+const blockStartIdsFromSnapshot = (snapshot) => {
 	const starts = /* @__PURE__ */ new Map();
-	for (const anchor of Object.values(createFolioAIEditSnapshot(doc).anchors)) starts.set(anchor.from, anchor.id);
+	for (const anchor of Object.values(snapshot.anchors)) starts.set(anchor.from, anchor.id);
 	return starts;
 };
 const firstBlockIdWithin = ({ node, nodePos, blockStarts }) => {
+	if (!blockStarts) return null;
 	let blockId = null;
 	node.descendants((child, relativePos) => {
 		if (blockId !== null || !child.isTextblock) return blockId === null;
@@ -51,19 +56,10 @@ const firstBlockIdWithin = ({ node, nodePos, blockStarts }) => {
 * matches neither and keeps its own entry.
 */
 const belongsToRowRevision = (scope, revision) => revision.id === scope.change.id || revision.author === scope.change.author && revision.date === scope.change.date;
-/**
-* The tracked changes present in the body, read from inline marks and
-* structural node attributes. Runs of one inline revision within a block fold
-* into a single entry.
-*
-* A tracked row insertion or deletion marks the row AND every run in its
-* cells, the way Word writes it. Both halves are one change, so the run marks
-* fold into the row's entry rather than reporting a second time.
-*/
-const getTrackedChangesFromDoc = (doc) => {
+/** Shared revision interpreter; a null block map omits unrelated block-id projection. */
+const getTrackedChangesFromProjectedDoc = (doc, blockStarts) => {
 	const insertionType = doc.type.schema.marks["insertion"];
 	const deletionType = doc.type.schema.marks["deletion"];
-	const blockStarts = blockStartIdsFromDoc(doc);
 	const grouped = /* @__PURE__ */ new Map();
 	const structuralChangeCellPositions = /* @__PURE__ */ new Map();
 	const rowRevisionScopes = [];
@@ -73,7 +69,7 @@ const getTrackedChangesFromDoc = (doc) => {
 		while (pos >= (rowRevisionScopes.at(-1)?.end ?? Number.POSITIVE_INFINITY)) rowRevisionScopes.pop();
 		const nodeRevisionCarriers = getFolioNodeRevisionCarriers(node, pos);
 		if (nodeRevisionCarriers.length > 0) {
-			const blockId = node.isTextblock ? blockStarts.get(pos) ?? null : firstBlockIdWithin({
+			const blockId = node.isTextblock ? blockStarts?.get(pos) ?? null : firstBlockIdWithin({
 				node,
 				nodePos: pos,
 				blockStarts
@@ -171,7 +167,7 @@ const getTrackedChangesFromDoc = (doc) => {
 			}
 		}
 		if (node.isTextblock) {
-			currentBlockId = blockStarts.get(pos) ?? null;
+			currentBlockId = blockStarts?.get(pos) ?? null;
 			return true;
 		}
 		if (!node.isInline) return;
@@ -244,6 +240,28 @@ const getTrackedChangesFromDoc = (doc) => {
 	});
 	return [...grouped.values()];
 };
+/** Read revisions from the exact immutable document that produced a snapshot. */
+const getTrackedChangesFromSnapshot = (snapshot) => getTrackedChangesFromProjectedDoc(sourceDocumentOf(snapshot), blockStartIdsFromSnapshot(snapshot));
+/**
+* The tracked changes present in the body, read from inline marks and
+* structural node attributes. Runs of one inline revision within a block fold
+* into a single entry.
+*
+* A tracked row insertion or deletion marks the row AND every run in its
+* cells, the way Word writes it. Both halves are one change, so the run marks
+* fold into the row's entry rather than reporting a second time.
+*/
+const getTrackedChangesFromDoc = (doc) => getTrackedChangesFromProjectedDoc(doc, blockStartIdsFromDoc(doc));
+/** @internal Read revision statistics without paying for an unrelated block projection. */
+const getTrackedChangeStatsFromDoc = (doc) => {
+	let highestId = 0;
+	const changes = getTrackedChangesFromProjectedDoc(doc, null);
+	for (const change of changes) highestId = Math.max(highestId, change.id);
+	return {
+		highestId,
+		present: changes.length > 0
+	};
+};
 /**
 * The comment anchors present in the body, read from the `comment` mark the
 * editor renders. Each entry carries the anchored text and containing block id;
@@ -281,4 +299,4 @@ const getCommentAnchorsFromDoc = (doc) => {
 	return [...anchors.values()];
 };
 //#endregion
-export { FOLIO_REVIEW_CHANGE_KINDS, getCommentAnchorsFromDoc, getTrackedChangesFromDoc };
+export { FOLIO_REVIEW_CHANGE_KINDS, getCommentAnchorsFromDoc, getTrackedChangeStatsFromDoc, getTrackedChangesFromDoc, getTrackedChangesFromSnapshot };

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

@@ -5,6 +5,10 @@ import { Node } from "prosemirror-model";
 //#region src/ai-edits/snapshot.d.ts
 /** @internal Numbering references collected during the snapshot's document walk. */
 declare const numberingReferenceKeysOf: (snapshot: FolioAIEditSnapshot) => readonly string[];
+/** @internal Tables collected during the snapshot's document walk. */
+declare const storyTablesOf: (snapshot: FolioAIEditSnapshot) => readonly FolioStoryTable[];
+/** @internal The immutable ProseMirror document that produced this snapshot. */
+declare const sourceDocumentOf: (snapshot: FolioAIEditSnapshot) => Node;
 declare const normalizeFolioAIBlockText: (text: string) => string;
 /**
  * Whether a block carries text a reader would see.
@@ -70,14 +74,12 @@ type FolioStoryTable = {
  * Every table of one story in document order, nested tables included and
  * hidden rows' subtrees excluded.
  *
- * The single place a story's tables are numbered. `table.tableIndex` on a
- * block, the geometry a comparison copies out of the target and the geometry
- * it checks its own work against all read this list, so no second walk can
- * number the same document differently.
+ * Uses the same traversal classification as the snapshot's integrated census,
+ * so both surfaces skip and number the same nodes in the same order.
  */
 declare const folioStoryTables: (doc: Node) => FolioStoryTable[];
 declare const createFolioAIEditSnapshot: (doc: Node) => FolioAIEditSnapshot;
 /** @internal Use for an EditorState that owns the document's style resolver. */
 declare const createFolioAIEditSnapshotWithStyleResolver: (doc: Node, styleResolver: RunStyleResolver | null) => FolioAIEditSnapshot;
 //#endregion
-export { FolioStoryTable, createFolioAIEditSnapshot, createFolioAIEditSnapshotWithStyleResolver, createFolioAITextRangeHandle, folioStoryTables, hashFolioAIBlockStructuralBoundaries, hashFolioAIBlockText, isFolioAIContentBlock, isHiddenTableRow, normalizeFolioAIBlockText, numberingReferenceKeysOf, projectFolioAIBlockStructuralBoundaries, trailingBodyBlockId };
+export { FolioStoryTable, createFolioAIEditSnapshot, createFolioAIEditSnapshotWithStyleResolver, createFolioAITextRangeHandle, folioStoryTables, hashFolioAIBlockStructuralBoundaries, hashFolioAIBlockText, isFolioAIContentBlock, isHiddenTableRow, normalizeFolioAIBlockText, numberingReferenceKeysOf, projectFolioAIBlockStructuralBoundaries, sourceDocumentOf, storyTablesOf, trailingBodyBlockId };

package/dist/ai-edits/snapshot.js

@@ -9,9 +9,14 @@ import { buildCleanBlockText } from "./clean-text.js";
 import { panic } from "better-result";
 import { TableMap } from "prosemirror-tables";
 //#region src/ai-edits/snapshot.ts
-const numberingReferenceKeysBySnapshot = /* @__PURE__ */ new WeakMap();
+const metadataBySnapshot = /* @__PURE__ */ new WeakMap();
+const metadataOf = (snapshot) => metadataBySnapshot.get(snapshot) ?? panic("Metadata was requested for a snapshot that did not record it");
 /** @internal Numbering references collected during the snapshot's document walk. */
-const numberingReferenceKeysOf = (snapshot) => numberingReferenceKeysBySnapshot.get(snapshot) ?? panic("A numbering census was requested for a snapshot that did not record one");
+const numberingReferenceKeysOf = (snapshot) => metadataOf(snapshot).numberingReferenceKeys;
+/** @internal Tables collected during the snapshot's document walk. */
+const storyTablesOf = (snapshot) => metadataOf(snapshot).storyTables;
+/** @internal The immutable ProseMirror document that produced this snapshot. */
+const sourceDocumentOf = (snapshot) => metadataOf(snapshot).sourceDocument;
 const normalizeFolioAIBlockText = (text) => text.replace(/\s+/gu, " ").trim();
 /**
 * Whether a block carries text a reader would see.
@@ -96,21 +101,28 @@ const TABLE_ROLE_ROW = "row";
 * whole subtree, so a table nested inside a hidden row is hidden with it.
 */
 const isHiddenTableRow = (node) => node.type.name === TABLE_ROW_NODE_NAME && node.attrs["hidden"] === true;
+const STORY_TABLE_CONTAINER = "container";
+const STORY_TABLE_HIDDEN_SUBTREE = "hidden-subtree";
+const STORY_TABLE = "table";
+/** Shared visibility and table-role rule for both story projection walks. */
+const classifyNonTextblockStoryTableNode = (node) => {
+	if (isHiddenTableRow(node)) return STORY_TABLE_HIDDEN_SUBTREE;
+	return node.type.spec["tableRole"] === TABLE_ROLE_TABLE ? STORY_TABLE : STORY_TABLE_CONTAINER;
+};
 /**
 * Every table of one story in document order, nested tables included and
 * hidden rows' subtrees excluded.
 *
-* The single place a story's tables are numbered. `table.tableIndex` on a
-* block, the geometry a comparison copies out of the target and the geometry
-* it checks its own work against all read this list, so no second walk can
-* number the same document differently.
+* Uses the same traversal classification as the snapshot's integrated census,
+* so both surfaces skip and number the same nodes in the same order.
 */
 const folioStoryTables = (doc) => {
 	const tables = [];
 	doc.descendants((node, pos) => {
 		if (node.isTextblock) return false;
-		if (isHiddenTableRow(node)) return false;
-		if (node.type.spec["tableRole"] === TABLE_ROLE_TABLE) tables.push({
+		const disposition = classifyNonTextblockStoryTableNode(node);
+		if (disposition === STORY_TABLE_HIDDEN_SUBTREE) return false;
+		if (disposition === STORY_TABLE) tables.push({
 			index: tables.length,
 			start: pos,
 			node
@@ -154,14 +166,25 @@ const createFolioAIEditSnapshotInternal = (doc, styleResolver) => {
 	const hashCounts = /* @__PURE__ */ new Map();
 	const usedBlockIds = /* @__PURE__ */ new Set();
 	const numberingReferenceKeys = /* @__PURE__ */ new Set();
-	const tableIndexByStart = new Map(folioStoryTables(doc).map(({ start, index }) => [start, index]));
+	const tables = [];
+	const tableIndexByStart = /* @__PURE__ */ new Map();
 	const path = [];
 	let blockIndex = 0;
 	let blankIndex = 0;
 	doc.descendants((node, pos, _parent, index) => {
 		while (pos >= (path.at(-1)?.end ?? Number.POSITIVE_INFINITY)) path.pop();
 		if (!node.isTextblock) {
-			if (isHiddenTableRow(node)) return false;
+			const disposition = classifyNonTextblockStoryTableNode(node);
+			if (disposition === STORY_TABLE_HIDDEN_SUBTREE) return false;
+			if (disposition === STORY_TABLE) {
+				const tableIndex = tables.length;
+				tables.push({
+					index: tableIndex,
+					start: pos,
+					node
+				});
+				tableIndexByStart.set(pos, tableIndex);
+			}
 			if (!node.isLeaf) path.push({
 				node,
 				start: pos,
@@ -254,7 +277,11 @@ const createFolioAIEditSnapshotInternal = (doc, styleResolver) => {
 		blocks,
 		anchors
 	};
-	numberingReferenceKeysBySnapshot.set(snapshot, [...numberingReferenceKeys]);
+	metadataBySnapshot.set(snapshot, {
+		numberingReferenceKeys: [...numberingReferenceKeys],
+		sourceDocument: doc,
+		storyTables: tables
+	});
 	return snapshot;
 };
 const createFolioAIEditSnapshot = (doc) => createFolioAIEditSnapshotInternal(doc, null);
@@ -479,4 +506,4 @@ const isEmptyPreviewRunStyle = ({ bold, italic, underline, strike, fontFamily, f
 const sameDirectFormatting = (left, right) => left === void 0 && isEmptyPreviewRunStyle(right) || left !== void 0 && left.bold === right.bold && left.italic === right.italic && left.underline === right.underline && left.strike === right.strike && left.fontFamily === right.fontFamily && left.fontSizePt === right.fontSizePt && left.color === right.color;
 const isUnstyledPreviewRun = ({ bold, italic, underline, strike, fontFamily, fontSizePt, color }) => bold === void 0 && italic === void 0 && underline === void 0 && strike === void 0 && fontFamily === void 0 && fontSizePt === void 0 && color === void 0;
 //#endregion
-export { createFolioAIEditSnapshot, createFolioAIEditSnapshotWithStyleResolver, createFolioAITextRangeHandle, folioStoryTables, hashFolioAIBlockStructuralBoundaries, hashFolioAIBlockText, isFolioAIContentBlock, isHiddenTableRow, normalizeFolioAIBlockText, numberingReferenceKeysOf, projectFolioAIBlockStructuralBoundaries, trailingBodyBlockId };
+export { createFolioAIEditSnapshot, createFolioAIEditSnapshotWithStyleResolver, createFolioAITextRangeHandle, folioStoryTables, hashFolioAIBlockStructuralBoundaries, hashFolioAIBlockText, isFolioAIContentBlock, isHiddenTableRow, normalizeFolioAIBlockText, numberingReferenceKeysOf, projectFolioAIBlockStructuralBoundaries, sourceDocumentOf, storyTablesOf, trailingBodyBlockId };

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

@@ -312,6 +312,16 @@ type FolioAIEditOperation = FolioAIEditReviewMeta & {
    */
   separator?: string;
   blockId: string;
+  /**
+   * Paragraph properties for the first result. Omitted properties keep
+   * the source paragraph's value.
+   */
+  firstParagraphProperties?: FolioAIBlockParagraphProperties;
+  /**
+   * Paragraph properties for the second result. Omitted properties keep
+   * the source paragraph's value.
+   */
+  secondParagraphProperties?: FolioAIBlockParagraphProperties;
 } |
 /**
  * Add a whole table next to the anchor block, its rows marked inserted in
@@ -377,6 +387,11 @@ type FolioAIEditOperation = FolioAIEditReviewMeta & {
    */
   separator?: string;
   blockId: string;
+  /**
+   * Paragraph properties for the joined result. Omitted properties keep
+   * the first paragraph's value.
+   */
+  mergedParagraphProperties?: FolioAIBlockParagraphProperties;
 } | {
   id: string;
   type: "commentOnBlock";

package/dist/compare/compare.d.ts

@@ -31,7 +31,6 @@ type ParsedComparison = {
   baseBuffer: ArrayBuffer;
   baseCarriedRevisions: boolean;
   reviewer: FolioDocxReviewer;
-  targetReviewer: FolioDocxReviewer;
   revisionStamp: FolioRevisionStamp;
   packageDate: Date;
   pairs: readonly ComparedStoryPair[];
@@ -50,7 +49,7 @@ type PlannedStoryComparison = {
  * Stage 2: align every paired story and derive its operations. Pure — no
  * parsing, no serialization, no clock.
  */
-declare const planComparison: ({ pairs, targetReviewer }: ParsedComparison) => Result<readonly PlannedStoryComparison[], CompareDocxOperationLimitError>;
+declare const planComparison: ({ pairs }: ParsedComparison) => Result<readonly PlannedStoryComparison[], CompareDocxOperationLimitError>;
 declare const getCompareSkipDisposition: (reason: FolioAIEditSkipReason) => "fatal" | "unwritable";
 /** What stage 3 produced: the change list, whether it was proven, and whether it wrote anything. */
 type AppliedComparison = {
@@ -77,7 +76,7 @@ type AppliedComparison = {
  * what you could not represent" and "give me nothing unless you can prove it"
  * are both legitimate asks and only the caller knows which one it is making.
  */
-declare const applyComparison: ({ reviewer, targetReviewer, revisionStamp, granularity, numberingChanges }: ParsedComparison, planned: readonly PlannedStoryComparison[]) => Result<AppliedComparison, CompareDocxApplyError>;
+declare const applyComparison: ({ reviewer, revisionStamp, granularity, numberingChanges }: ParsedComparison, planned: readonly PlannedStoryComparison[]) => Result<AppliedComparison, CompareDocxApplyError>;
 /**
  * Stage 4: the result package, with every ZIP entry date pinned.
  *

package/dist/compare/compare.js

@@ -1,5 +1,5 @@
-import { FolioDocxReviewer } from "../ai-edits/headless.js";
-import { numberingReferenceKeysOf } from "../ai-edits/snapshot.js";
+import { FolioDocxReviewer, getFolioDocxComparisonAccess } from "../ai-edits/headless.js";
+import { numberingReferenceKeysOf, storyTablesOf } from "../ai-edits/snapshot.js";
 import { projectTableGeometry } from "../ai-edits/table-geometry.js";
 import { tableTemplateCanCrossPackageLosslessly } from "../ai-edits/table-template.js";
 import { createScopedWordDiffOptions } from "../ai-edits/word-diff.js";
@@ -60,25 +60,6 @@ const parseSide = async (buffer, side, author) => await Result.tryPromise({
 		cause
 	})
 });
-/** Read before either side is resolved, so it describes the package as it arrived. */
-const existingRevisionsOf = (reviewer) => {
-	let highest = 0;
-	let present = false;
-	for (const { handle } of reviewer.listStories()) {
-		const story = reviewer.readReviewedStory({
-			story: handle,
-			view: "current-markup"
-		});
-		for (const change of story?.changes ?? []) {
-			highest = Math.max(highest, change.id);
-			present = true;
-		}
-	}
-	return {
-		idSeed: highest + 1,
-		present
-	};
-};
 /** Verify formatting only where the plan claims a text-equal formatting change. */
 const formattingRoundTripFailure = ({ invariant, story, changes, actualBlocks, expectedBlocks, expectedBlockId }) => {
 	const expectedIndexById = new Map(expectedBlocks.map(({ id }, index) => [id, index]));
@@ -146,15 +127,20 @@ const parseComparison = async (base, target, options) => {
 	if (targetParse.isErr()) return Result.err(targetParse.error);
 	const reviewer = baseParse.value;
 	const targetReviewer = targetParse.value;
-	const existing = existingRevisionsOf(reviewer);
-	for (const { handle } of reviewer.listStories()) reviewer.resolveReviewedStory({
-		story: handle,
-		view: "final"
-	});
-	for (const { handle } of targetReviewer.listStories()) targetReviewer.resolveReviewedStory({
-		story: handle,
-		view: "final"
-	});
+	const baseProjection = getFolioDocxComparisonAccess(reviewer).projectStories("with-revision-census");
+	const targetProjection = getFolioDocxComparisonAccess(targetReviewer).projectStories("without-revision-census");
+	const baseStories = [];
+	const targetStories = [];
+	const baseSnapshots = /* @__PURE__ */ new Map();
+	const targetSnapshots = /* @__PURE__ */ new Map();
+	for (const { handle, snapshot } of baseProjection.stories) {
+		baseStories.push(handle);
+		baseSnapshots.set(handle, snapshot);
+	}
+	for (const { handle, snapshot } of targetProjection.stories) {
+		targetStories.push(handle);
+		targetSnapshots.set(handle, snapshot);
+	}
 	const pairs = [];
 	const unsupported = [];
 	const referencedNumberingLevels = /* @__PURE__ */ new Set();
@@ -162,10 +148,10 @@ const parseComparison = async (base, target, options) => {
 		if (!snapshot) return;
 		for (const referenceKey of numberingReferenceKeysOf(snapshot)) referencedNumberingLevels.add(referenceKey);
 	};
-	for (const { baseStory, revisedStory: targetStory } of pairFolioDocumentStories(reviewer.listStories().map(({ handle }) => handle), targetReviewer.listStories().map(({ handle }) => handle))) {
+	for (const { baseStory, revisedStory: targetStory } of pairFolioDocumentStories(baseStories, targetStories)) {
 		if (!baseStory) {
 			if (!targetStory) panic("A story pair contained neither a base nor a target story");
-			collectNumberingReferences(targetReviewer.snapshotStory(targetStory));
+			collectNumberingReferences(targetSnapshots.get(targetStory));
 			unsupported.push({
 				reason: "story-missing-in-base",
 				baseStory: null,
@@ -174,7 +160,7 @@ const parseComparison = async (base, target, options) => {
 			continue;
 		}
 		if (!targetStory) {
-			collectNumberingReferences(reviewer.snapshotStory(baseStory));
+			collectNumberingReferences(baseSnapshots.get(baseStory));
 			unsupported.push({
 				reason: "story-missing-in-target",
 				baseStory,
@@ -182,8 +168,8 @@ const parseComparison = async (base, target, options) => {
 			});
 			continue;
 		}
-		const baseSnapshot = reviewer.snapshotStory(baseStory);
-		const targetSnapshot = targetReviewer.snapshotStory(targetStory);
+		const baseSnapshot = baseSnapshots.get(baseStory);
+		const targetSnapshot = targetSnapshots.get(targetStory);
 		collectNumberingReferences(baseSnapshot);
 		collectNumberingReferences(targetSnapshot);
 		if (!baseSnapshot || !targetSnapshot) {
@@ -204,12 +190,11 @@ const parseComparison = async (base, target, options) => {
 	return Result.ok({
 		granularity: options.granularity ?? "word",
 		baseBuffer: base,
-		baseCarriedRevisions: existing.present,
+		baseCarriedRevisions: baseProjection.revisions.present,
 		reviewer,
-		targetReviewer,
 		revisionStamp: {
 			date: options.timestamp,
-			idSeed: existing.idSeed
+			idSeed: baseProjection.revisions.highestId + 1
 		},
 		packageDate,
 		pairs,
@@ -217,8 +202,8 @@ const parseComparison = async (base, target, options) => {
 		unsupported
 	});
 };
-const planCopiesNonPortableWholeTable = (targetReviewer, pair, plan) => {
-	const targetTables = new Map(targetReviewer.storyTables({ story: pair.targetStory }).map(({ index, node }) => [index, node]));
+const planCopiesNonPortableWholeTable = (pair, plan) => {
+	const targetTables = new Map(storyTablesOf(pair.targetSnapshot).map(({ index, node }) => [index, node]));
 	return plan.tableTemplates.some(({ targetRowIndex, targetTableIndex }) => {
 		if (targetRowIndex !== void 0) return false;
 		const table = targetTables.get(targetTableIndex);
@@ -229,7 +214,7 @@ const planCopiesNonPortableWholeTable = (targetReviewer, pair, plan) => {
 * Stage 2: align every paired story and derive its operations. Pure — no
 * parsing, no serialization, no clock.
 */
-const planComparison = ({ pairs, targetReviewer }) => {
+const planComparison = ({ pairs }) => {
 	const planned = [];
 	const workSession = createContentComparisonWorkSession();
 	let remainingOperations = MAX_COMPARE_OPERATIONS;
@@ -246,7 +231,7 @@ const planComparison = ({ pairs, targetReviewer }) => {
 			wholeTableReplacement: "allow",
 			workSession
 		});
-		if (plan && planCopiesNonPortableWholeTable(targetReviewer, pair, plan)) {
+		if (plan && planCopiesNonPortableWholeTable(pair, plan)) {
 			workSession.alignment.remainingLcsCells = remainingLcsCells;
 			workSession.alignment.remainingStructuralTokenLookups = remainingStructuralTokenLookups;
 			workSession.remainingMoveComparisons = remainingMoveComparisons;
@@ -343,7 +328,8 @@ const resolveTableTemplates = (targetTables, requests) => {
 * what you could not represent" and "give me nothing unless you can prove it"
 * are both legitimate asks and only the caller knows which one it is making.
 */
-const applyComparison = ({ reviewer, targetReviewer, revisionStamp, granularity, numberingChanges }, planned) => {
+const applyComparison = ({ reviewer, revisionStamp, granularity, numberingChanges }, planned) => {
+	const comparisonAccess = getFolioDocxComparisonAccess(reviewer);
 	const changes = [...numberingChanges];
 	const failures = [];
 	let idSeed = revisionStamp.idSeed;
@@ -352,12 +338,9 @@ const applyComparison = ({ reviewer, targetReviewer, revisionStamp, granularity,
 	for (const { pair, plan } of planned) {
 		changes.push(...plan.changes);
 		if (plan.operations.length === 0 && plan.tableGeometryPairings.length === 0) continue;
-		const baseBefore = reviewer.readReviewedStory({
-			story: pair.baseStory,
-			view: "final"
-		})?.snapshot.blocks ?? [];
-		const baseBeforeGeometry = projectTableGeometry(reviewer.storyTables({ story: pair.baseStory }));
-		const targetTables = new Map(targetReviewer.storyTables({ story: pair.targetStory }).map(({ index, node }) => [index, node]));
+		const baseBefore = pair.baseSnapshot.blocks;
+		const baseBeforeGeometry = projectTableGeometry(storyTablesOf(pair.baseSnapshot));
+		const targetTables = new Map(storyTablesOf(pair.targetSnapshot).map(({ index, node }) => [index, node]));
 		const afterGeometry = reviewer.matchStoryTableGeometry({
 			story: pair.baseStory,
 			targetTables,
@@ -396,14 +379,14 @@ const applyComparison = ({ reviewer, targetReviewer, revisionStamp, granularity,
 				skipped: refused
 			}));
 		}
-		const acceptedStory = reviewer.readReviewedStory({
+		const acceptedSnapshot = comparisonAccess.snapshotReviewedStory({
 			story: pair.baseStory,
 			view: "final"
 		});
 		const acceptFailure = classifyProjectionMismatch({
 			invariant: "accept-reproduces-target",
 			story: pair.baseStory,
-			actual: acceptedStory?.snapshot.blocks ?? [],
+			actual: acceptedSnapshot?.blocks ?? [],
 			expected: pair.targetSnapshot.blocks
 		});
 		if (acceptFailure) failures.push(acceptFailure);
@@ -412,20 +395,20 @@ const applyComparison = ({ reviewer, targetReviewer, revisionStamp, granularity,
 				invariant: "accept-reproduces-target",
 				story: pair.baseStory,
 				changes: plan.changes,
-				actualBlocks: acceptedStory?.snapshot.blocks ?? [],
+				actualBlocks: acceptedSnapshot?.blocks ?? [],
 				expectedBlocks: pair.targetSnapshot.blocks,
 				expectedBlockId: ({ targetBlockId }) => targetBlockId
 			});
 			if (formattingFailure) failures.push(formattingFailure);
 		}
-		const rejectedStory = reviewer.readReviewedStory({
+		const rejectedSnapshot = comparisonAccess.snapshotReviewedStory({
 			story: pair.baseStory,
 			view: "original"
 		});
 		const rejectFailure = classifyProjectionMismatch({
 			invariant: "reject-reproduces-base",
 			story: pair.baseStory,
-			actual: rejectedStory?.snapshot.blocks ?? [],
+			actual: rejectedSnapshot?.blocks ?? [],
 			expected: baseBefore
 		});
 		if (rejectFailure) failures.push(rejectFailure);
@@ -434,7 +417,7 @@ const applyComparison = ({ reviewer, targetReviewer, revisionStamp, granularity,
 				invariant: "reject-reproduces-base",
 				story: pair.baseStory,
 				changes: plan.changes,
-				actualBlocks: rejectedStory?.snapshot.blocks ?? [],
+				actualBlocks: rejectedSnapshot?.blocks ?? [],
 				expectedBlocks: pair.baseSnapshot.blocks,
 				expectedBlockId: ({ baseBlockId }) => baseBlockId
 			});
@@ -443,20 +426,14 @@ const applyComparison = ({ reviewer, targetReviewer, revisionStamp, granularity,
 		const geometryAcceptFailure = classifyGeometryMismatch({
 			invariant: "accept-reproduces-target",
 			story: pair.baseStory,
-			actual: projectTableGeometry(reviewer.storyTables({
-				story: pair.baseStory,
-				view: "final"
-			})),
-			expected: projectTableGeometry(targetReviewer.storyTables({ story: pair.targetStory }))
+			actual: projectTableGeometry(acceptedSnapshot ? storyTablesOf(acceptedSnapshot) : []),
+			expected: projectTableGeometry(storyTablesOf(pair.targetSnapshot))
 		});
 		if (geometryAcceptFailure) failures.push(geometryAcceptFailure);
 		const geometryRejectFailure = classifyGeometryMismatch({
 			invariant: "reject-reproduces-base",
 			story: pair.baseStory,
-			actual: projectTableGeometry(reviewer.storyTables({
-				story: pair.baseStory,
-				view: "original"
-			})),
+			actual: projectTableGeometry(rejectedSnapshot ? storyTablesOf(rejectedSnapshot) : []),
 			expected: baseBeforeGeometry
 		});
 		if (geometryRejectFailure) failures.push(geometryRejectFailure);

package/dist/compare/content-alignment.js

@@ -601,7 +601,6 @@ const trustedContentSequencePairs = ({ exactPairs, stablePairs, revisedLength, p
 	return [...primary, ...secondary].toSorted((left, right) => left.baseIndex - right.baseIndex || left.revisedIndex - right.revisedIndex);
 };
 const persistedContentSequencePairs = ({ base, revised, anchors, canPair }) => {
-	if (anchors.length === 0) return /* @__PURE__ */ new Set();
 	const uniqueIndexesByFirstId = (items) => {
 		const indexes = /* @__PURE__ */ new Map();
 		items.forEach(({ profile }, itemIndex) => {

package/dist/compare/plan.js

@@ -612,6 +612,10 @@ const planStoryCompare = ({ story, baseSnapshot, targetSnapshot, maxOperations,
 		const paragraphMarkPlan = paragraphMarkPlans.get(stepIndex);
 		if (paragraphMarkPlan?.type === "split") {
 			const { baseBlock, revisedBlocks: splitInto, offset, separator } = paragraphMarkPlan;
+			const firstParagraphFormatting = changedFolioContentParagraphFormatting(baseBlock, splitInto[0]);
+			const secondParagraphFormatting = changedFolioContentParagraphFormatting(baseBlock, splitInto[1]);
+			const firstParagraphProperties = firstParagraphFormatting ? toFolioAIBlockParagraphProperties(firstParagraphFormatting) : void 0;
+			const secondParagraphProperties = secondParagraphFormatting ? toFolioAIBlockParagraphProperties(secondParagraphFormatting) : void 0;
 			changes.push({
 				kind: "split",
 				location: locationOf(story, baseBlock),
@@ -619,17 +623,35 @@ const planStoryCompare = ({ story, baseSnapshot, targetSnapshot, maxOperations,
 				targetBlockIds: splitInto.map(({ id }) => id),
 				text: baseBlock.text
 			});
+			if (firstParagraphProperties) changes.push({
+				kind: "paragraph-format",
+				location: locationOf(story, baseBlock),
+				baseBlockId: baseBlock.id,
+				targetBlockId: splitInto[0].id,
+				properties: firstParagraphProperties
+			});
+			if (secondParagraphProperties) changes.push({
+				kind: "paragraph-format",
+				location: locationOf(story, baseBlock),
+				baseBlockId: baseBlock.id,
+				targetBlockId: splitInto[1].id,
+				properties: secondParagraphProperties
+			});
 			operations.push({
 				id: nextOperationId(),
 				type: "splitBlock",
 				blockId: baseBlock.id,
 				offset,
-				...separator.length > 0 && { separator }
+				...separator.length > 0 && { separator },
+				...firstParagraphProperties && { firstParagraphProperties },
+				...secondParagraphProperties && { secondParagraphProperties }
 			});
 			continue;
 		}
 		if (paragraphMarkPlan?.type === "merge") {
 			const { baseBlocks, revisedBlock: targetBlock, separator } = paragraphMarkPlan;
+			const mergedParagraphFormatting = changedFolioContentParagraphFormatting(baseBlocks[0], targetBlock);
+			const mergedParagraphProperties = mergedParagraphFormatting ? toFolioAIBlockParagraphProperties(mergedParagraphFormatting) : void 0;
 			changes.push({
 				kind: "merge",
 				location: locationOf(story, baseBlocks[0]),
@@ -637,11 +659,19 @@ const planStoryCompare = ({ story, baseSnapshot, targetSnapshot, maxOperations,
 				targetBlockId: targetBlock.id,
 				text: targetBlock.text
 			});
+			if (mergedParagraphProperties) changes.push({
+				kind: "paragraph-format",
+				location: locationOf(story, baseBlocks[0]),
+				baseBlockId: baseBlocks[0].id,
+				targetBlockId: targetBlock.id,
+				properties: mergedParagraphProperties
+			});
 			operations.push({
 				id: nextOperationId(),
 				type: "mergeBlockWithNext",
 				blockId: baseBlocks[0].id,
-				...separator.length > 0 && { separator }
+				...separator.length > 0 && { separator },
+				...mergedParagraphProperties && { mergedParagraphProperties }
 			});
 			continue;
 		}