@stll/folio-core 0.32.2 → 0.33.1

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

@@ -50,9 +50,13 @@ declare const resolvePassageRange: ({ blockId, text, doc, snapshot }: ResolvePas
  * server's `seq-NNNN`: the direct anchor lookup misses, and a
  * paraId-based live lookup can't match either (no node carries a
  * `seq-` paraId). The seq number is the block's 1-based position in
- * the same non-empty-block walk the server extractor and
- * `createFolioAIEditSnapshot` share, so it indexes the snapshot's
- * ordered `blocks` directly.
+ * the non-empty-block walk the server extractor and
+ * `createFolioAIEditSnapshot` share.
+ *
+ * That walk is not the snapshot's `blocks` array: `blocks` also holds
+ * the document's blank paragraphs, which the seq sequence does not
+ * count. So the position is counted here over the blocks that carry
+ * text, which is what the number means.
  */
 declare const resolveSequentialBlockAnchor: (blockId: string, snapshot: FolioAIEditSnapshot) => FolioAIBlockAnchor | undefined;
 /**

package/dist/ai-edits/blockRange.js

@@ -1,7 +1,7 @@
 import { findParagraphByParaId } from "../prosemirror/utils/findParagraphByParaId.js";
 import { getFolioParaIdFromBlockId, getSequentialFolioBlockIdIndex } from "../types/block-id.js";
 import { buildCleanBlockText } from "./clean-text.js";
-import { createFolioAIEditSnapshot, hashFolioAIBlockText } from "./snapshot.js";
+import { createFolioAIEditSnapshot, hashFolioAIBlockText, isFolioAIContentBlock } from "./snapshot.js";
 //#region src/ai-edits/blockRange.ts
 const resolveFolioAIBlockRange = ({ blockId, doc, snapshot }) => {
 	const paraId = getFolioParaIdFromBlockId(blockId);
@@ -113,15 +113,23 @@ const matchPassage = (haystack, needleSource) => {
 * server's `seq-NNNN`: the direct anchor lookup misses, and a
 * paraId-based live lookup can't match either (no node carries a
 * `seq-` paraId). The seq number is the block's 1-based position in
-* the same non-empty-block walk the server extractor and
-* `createFolioAIEditSnapshot` share, so it indexes the snapshot's
-* ordered `blocks` directly.
+* the non-empty-block walk the server extractor and
+* `createFolioAIEditSnapshot` share.
+*
+* That walk is not the snapshot's `blocks` array: `blocks` also holds
+* the document's blank paragraphs, which the seq sequence does not
+* count. So the position is counted here over the blocks that carry
+* text, which is what the number means.
 */
 const resolveSequentialBlockAnchor = (blockId, snapshot) => {
 	const index = getSequentialFolioBlockIdIndex(blockId);
 	if (index === null) return;
-	const block = snapshot.blocks.at(index - 1);
-	return block ? snapshot.anchors[block.id] : void 0;
+	let remaining = index;
+	for (const block of snapshot.blocks) {
+		if (!isFolioAIContentBlock(block)) continue;
+		remaining -= 1;
+		if (remaining === 0) return snapshot.anchors[block.id];
+	}
 };
 /**
 * Clamp a `{from, to}` pair so both endpoints fit inside a document of

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

@@ -1,4 +1,5 @@
 import { FolioAIBlock, FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditOperation, FolioAIEditSnapshot } from "./types.js";
+import { FolioRevisionStamp, FolioWordDiffOptions } from "./apply.js";
 import { document_d_exports } from "../types/document.js";
 import { FolioDocumentOperationBatch, FolioDocumentOperationResult, FolioDocumentOperationUndoHandle, FolioDocumentOperationUndoResult } from "../document-operations.js";
 import { FolioReviewChange, FolioReviewChangeKind } from "./read.js";
@@ -20,6 +21,10 @@ type FolioApplyOperationsOptions = {
    * `snapshot()` -> build ops -> `applyOperations()` on the same reviewer.
    */
   snapshot?: FolioAIEditSnapshot;
+  /** Omit to stamp revisions from the wall clock and the shared id cursor. */
+  revisionStamp?: FolioRevisionStamp;
+  /** Token size a replacement's redline is cut at. Word-level by default. */
+  wordDiff?: FolioWordDiffOptions;
 };
 /** Options for {@link FolioDocxReviewer.applyDocumentOperations}. */
 type FolioApplyDocumentOperationsOptions = Omit<FolioApplyOperationsOptions, "mode">;
@@ -52,6 +57,17 @@ type FolioDocumentStoryHandle = {
   noteId: number;
 };
 type FolioEditableDocumentStoryHandle = FolioDocumentStoryHandle;
+/**
+ * One numbering level as a reader meets it: which list, which depth, and the
+ * format and template that produce the label.
+ */
+type FolioNumberingLevel = {
+  numId: number;
+  level: number;
+  format: string;
+  levelText: string;
+  start?: number;
+};
 type FolioDocumentStory = {
   handle: FolioDocumentStoryHandle;
   text: string;
@@ -169,6 +185,18 @@ declare class FolioDocxReviewer {
    * the anchor map the apply layer resolves operations against.
    */
   snapshot(): FolioAIEditSnapshot;
+  /**
+   * The package's numbering, flattened to what a reader sees: one entry per
+   * numbering instance and level, with the format and level text that produce
+   * its labels.
+   *
+   * Labels are rendered from these definitions rather than stored on the
+   * paragraphs, so nothing in a block projection changes when a list is
+   * renumbered — which is right for an insertion that renumbers the items
+   * below it, and wrong for a list whose FORMAT changed. Sorted so two
+   * packages can be compared entry by entry.
+   */
+  readNumberingDefinitions(): FolioNumberingLevel[];
   /** Return parsed package metadata without exposing the mutable document model. */
   getDocumentProperties(): Readonly<NonNullable<document_d_exports.Document["package"]["properties"]>> | null;
   /** Snapshot one editable story into stable, operation-ready blocks. */
@@ -191,7 +219,7 @@ declare class FolioDocxReviewer {
    */
   applyDocumentOperations(batch: FolioDocumentOperationBatch, options?: FolioApplyDocumentOperationsOptions): FolioDocumentOperationResult;
   /** Apply a versioned operation batch to one editable document story. */
-  applyDocumentOperationsToStory({ story, batch, snapshot }: FolioApplyDocumentOperationsToStoryOptions): FolioDocumentOperationResult;
+  applyDocumentOperationsToStory({ story, batch, snapshot, revisionStamp, wordDiff }: FolioApplyDocumentOperationsToStoryOptions): FolioDocumentOperationResult;
   private applyDocumentOperationsInternal;
   /** Undo the latest unchanged document-operation batch and its created comments. */
   undoDocumentOperations(undoHandle: FolioDocumentOperationUndoHandle): FolioDocumentOperationUndoResult;
@@ -276,12 +304,17 @@ declare class FolioDocxReviewer {
    */
   rejectChange(target: FolioReviewChange | number): boolean;
   /**
-   * Accept every tracked change in the body. Returns the number of changes
-   * present before the sweep. Note-body changes are out of scope.
+   * Accept every tracked change in the package. Returns the number of changes
+   * present before the sweep.
+   *
+   * Every story, not just the body: a revision in a header or a footnote is
+   * one a reviewer meant to resolve, and leaving it behind means an accepted
+   * document still carries a redline nobody can see from the body.
    */
   acceptAll(): number;
-  /** Reject every tracked change in the body. See {@link acceptAll}. */
+  /** Reject every tracked change in the package. See {@link acceptAll}. */
   rejectAll(): number;
+  private resolveEveryStory;
   /** The current document model with edits merged back in. */
   toDocument(): document_d_exports.Document;
   /**
@@ -320,6 +353,7 @@ declare class FolioDocxReviewer {
    * resulting state for {@link toBuffer}.
    */
   private runCommand;
+  private runStoryCommand;
 }
 /** Options for {@link applyFolioAIEditsToBuffer}. */
 type ApplyFolioAIEditsToBufferOptions = {
@@ -348,4 +382,4 @@ type ApplyFolioAIEditsToBufferResult = FolioAIEditApplyResult & {
  */
 declare const applyFolioAIEditsToBuffer: (buffer: ArrayBuffer, operations: FolioAIEditOperation[], options?: ApplyFolioAIEditsToBufferOptions) => Promise<ApplyFolioAIEditsToBufferResult>;
 //#endregion
-export { ApplyFolioAIEditsToBufferOptions, ApplyFolioAIEditsToBufferResult, FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FolioApplyDocumentOperationsOptions, FolioApplyDocumentOperationsToStoryOptions, FolioApplyOperationsOptions, FolioDocumentStory, FolioDocumentStoryHandle, FolioDocumentStoryNotFoundError, FolioDocxReviewer, FolioDocxReviewerOptions, FolioEditableDocumentStoryHandle, FolioGetContentAsTextOptions, FolioReadReviewedStoryOptions, FolioResolveReviewedStoryOptions, FolioResolvedReviewedView, type FolioReviewChange, FolioReviewChangeFilter, type FolioReviewChangeKind, FolioReviewComment, FolioReviewCommentFilter, FolioReviewCommentReply, FolioReviewReplyInput, FolioReviewedStory, FolioReviewedView, UnsupportedFolioReviewedViewError, applyFolioAIEditsToBuffer, isFolioResolvedReviewedView, isFolioReviewedView };
+export { ApplyFolioAIEditsToBufferOptions, ApplyFolioAIEditsToBufferResult, FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FolioApplyDocumentOperationsOptions, FolioApplyDocumentOperationsToStoryOptions, FolioApplyOperationsOptions, FolioDocumentStory, FolioDocumentStoryHandle, FolioDocumentStoryNotFoundError, FolioDocxReviewer, FolioDocxReviewerOptions, FolioEditableDocumentStoryHandle, FolioGetContentAsTextOptions, FolioNumberingLevel, FolioReadReviewedStoryOptions, FolioResolveReviewedStoryOptions, FolioResolvedReviewedView, type FolioReviewChange, FolioReviewChangeFilter, type FolioReviewChangeKind, FolioReviewComment, FolioReviewCommentFilter, FolioReviewCommentReply, FolioReviewReplyInput, FolioReviewedStory, FolioReviewedView, type FolioRevisionStamp, UnsupportedFolioReviewedViewError, applyFolioAIEditsToBuffer, isFolioResolvedReviewedView, isFolioReviewedView };

package/dist/ai-edits/headless.js

@@ -14,7 +14,7 @@ import { schema, singletonManager } from "../prosemirror/schema/index.js";
 import { deterministicHexId } from "../utils/hexId.js";
 import { buildAnnotatedBlockText } from "./clean-text.js";
 import { getCommentAnchorsFromDoc, getTrackedChangesFromDoc } from "./read.js";
-import { createFolioAIEditSnapshot, normalizeFolioAIBlockText } from "./snapshot.js";
+import { createFolioAIEditSnapshot, isFolioAIContentBlock, normalizeFolioAIBlockText } from "./snapshot.js";
 import { TaggedError } from "better-result";
 import { Fragment } from "prosemirror-model";
 import { EditorState } from "prosemirror-state";
@@ -154,12 +154,19 @@ const resolveReviewedState = (state, view) => {
 };
 const formatStoryStateForLLM = (state, annotated) => {
 	const snapshot = createFolioAIEditSnapshot(state.doc);
-	if (!annotated) return snapshot.blocks.map(formatBlockForLLM).join("\n");
+	const blocks = snapshot.blocks.filter(isFolioAIContentBlock);
+	if (!annotated) return blocks.map(formatBlockForLLM).join("\n");
+	const nodeByStart = /* @__PURE__ */ new Map();
+	state.doc.descendants((node, pos) => {
+		if (!node.isTextblock) return true;
+		nodeByStart.set(pos, node);
+		return false;
+	});
 	const startById = /* @__PURE__ */ new Map();
 	for (const anchor of Object.values(snapshot.anchors)) startById.set(anchor.id, anchor.from);
-	return snapshot.blocks.map((block) => {
+	return blocks.map((block) => {
 		const from = startById.get(block.id);
-		const node = from === void 0 ? null : state.doc.nodeAt(from);
+		const node = from === void 0 ? void 0 : nodeByStart.get(from);
 		const text = node ? buildAnnotatedBlockText(node) : block.text;
 		return formatBlockLine(block, text);
 	}).join("\n");
@@ -260,6 +267,38 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 	snapshot() {
 		return createFolioAIEditSnapshot(this.state.doc);
 	}
+	/**
+	* The package's numbering, flattened to what a reader sees: one entry per
+	* numbering instance and level, with the format and level text that produce
+	* its labels.
+	*
+	* Labels are rendered from these definitions rather than stored on the
+	* paragraphs, so nothing in a block projection changes when a list is
+	* renumbered — which is right for an insertion that renumbers the items
+	* below it, and wrong for a list whose FORMAT changed. Sorted so two
+	* packages can be compared entry by entry.
+	*/
+	readNumberingDefinitions() {
+		const numbering = this.baseDocument.package.numbering;
+		if (!numbering) return [];
+		const levelsByAbstractId = new Map(numbering.abstractNums.map((abstractNum) => [abstractNum.abstractNumId, abstractNum.levels]));
+		const levels = [];
+		for (const instance of numbering.nums) {
+			const overrides = new Map((instance.levelOverrides ?? []).map((override) => [override.ilvl, override]));
+			for (const level of levelsByAbstractId.get(instance.abstractNumId) ?? []) {
+				const override = overrides.get(level.ilvl);
+				const resolved = override?.lvl ?? level;
+				levels.push({
+					numId: instance.numId,
+					level: resolved.ilvl,
+					format: resolved.numFmt,
+					levelText: resolved.lvlText,
+					...(override?.startOverride ?? resolved.start) !== void 0 ? { start: override?.startOverride ?? resolved.start } : {}
+				});
+			}
+		}
+		return levels.toSorted((left, right) => left.numId - right.numId || left.level - right.level);
+	}
 	/** Return parsed package metadata without exposing the mutable document model. */
 	getDocumentProperties() {
 		const properties = this.baseDocument.package.properties;
@@ -325,6 +364,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 				mode: options.mode ?? "tracked-changes"
 			},
 			...options.snapshot !== void 0 && { snapshot: options.snapshot },
+			...options.revisionStamp !== void 0 && { revisionStamp: options.revisionStamp },
 			createUndoEntry: false
 		});
 		return {
@@ -343,19 +383,22 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 			story: MAIN_STORY,
 			batch,
 			...options.snapshot !== void 0 && { snapshot: options.snapshot },
+			...options.revisionStamp !== void 0 && { revisionStamp: options.revisionStamp },
 			createUndoEntry: true
 		});
 	}
 	/** Apply a versioned operation batch to one editable document story. */
-	applyDocumentOperationsToStory({ story, batch, snapshot }) {
+	applyDocumentOperationsToStory({ story, batch, snapshot, revisionStamp, wordDiff }) {
 		return this.applyDocumentOperationsInternal({
 			story,
 			batch,
 			...snapshot !== void 0 && { snapshot },
+			...revisionStamp !== void 0 && { revisionStamp },
+			...wordDiff !== void 0 && { wordDiff },
 			createUndoEntry: true
 		});
 	}
-	applyDocumentOperationsInternal({ story, batch, snapshot, createUndoEntry }) {
+	applyDocumentOperationsInternal({ story, batch, snapshot, revisionStamp, wordDiff, createUndoEntry }) {
 		const beforeState = this.requireEditableStoryState(story);
 		const createdCommentsLengthBefore = this.createdComments.length;
 		const view = {
@@ -370,6 +413,8 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 			batch,
 			story: story.type === "main" ? "main" : story,
 			author: this.author,
+			...revisionStamp !== void 0 && { revisionStamp },
+			...wordDiff !== void 0 && { wordDiff },
 			createCommentId: (text) => {
 				const comment = createReviewerComment(this.nextCommentId(), text, this.author);
 				this.createdComments.push(comment);
@@ -658,18 +703,28 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 		return this.runCommand(rejectAIEditRevision(revisionIdOf(target)));
 	}
 	/**
-	* Accept every tracked change in the body. Returns the number of changes
-	* present before the sweep. Note-body changes are out of scope.
+	* Accept every tracked change in the package. Returns the number of changes
+	* present before the sweep.
+	*
+	* Every story, not just the body: a revision in a header or a footnote is
+	* one a reviewer meant to resolve, and leaving it behind means an accepted
+	* document still carries a redline nobody can see from the body.
 	*/
 	acceptAll() {
-		const count = this.getChanges().length;
-		this.runCommand(acceptAllChanges());
-		return count;
+		return this.resolveEveryStory(acceptAllChanges());
 	}
-	/** Reject every tracked change in the body. See {@link acceptAll}. */
+	/** Reject every tracked change in the package. See {@link acceptAll}. */
 	rejectAll() {
-		const count = this.getChanges().length;
-		this.runCommand(rejectAllChanges());
+		return this.resolveEveryStory(rejectAllChanges());
+	}
+	resolveEveryStory(command) {
+		let count = 0;
+		for (const { handle } of this.listStories()) {
+			const state = this.getEditableStoryState(handle);
+			if (!state) continue;
+			count += getTrackedChangesFromDoc(state.doc).length;
+			this.runStoryCommand(command, handle);
+		}
 		return count;
 	}
 	/** The current document model with edits merged back in. */
@@ -898,15 +953,19 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 	* resulting state for {@link toBuffer}.
 	*/
 	runCommand(command) {
-		this.resolvedStoryExpectations.delete("main");
+		return this.runStoryCommand(command, MAIN_STORY);
+	}
+	runStoryCommand(command, story) {
+		const state = this.getEditableStoryState(story);
+		if (!state) return false;
 		const view = {
-			state: this.state,
+			state,
 			dispatch: (transaction) => {
 				view.state = view.state.apply(transaction);
 			}
 		};
 		const handled = command(view.state, view.dispatch);
-		this.state = view.state;
+		this.setEditableStoryState(story, view.state);
 		return handled;
 	}
 };

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

@@ -1,12 +1,12 @@
-import { FolioAIBlock, FolioAIBlockAnchor, FolioAIBlockKind, FolioAIBlockPreviewRun, FolioAIComment, FolioAIEditAppliedOperation, FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditNormalization, FolioAIEditNormalizationCode, FolioAIEditOperation, FolioAIEditPrecondition, FolioAIEditReviewMeta, FolioAIEditSeverity, FolioAIEditSkipReason, FolioAIEditSkippedOperation, FolioAIEditSnapshot, FolioAIInlineFormatting, FolioAISignatureParty, FolioAITextRangeHandle, FolioDocumentNavigationTarget, FolioDocumentOutline, FolioDocumentOutlineEntry, FolioDocumentSection, FolioDocumentSectionHandle, FolioDocumentSectionReadResult } from "./types.js";
-import { FolioAIEditView, applyFolioAIEditOperations } from "./apply.js";
+import { FolioAIBlock, FolioAIBlockAnchor, FolioAIBlockKind, FolioAIBlockPreviewRun, FolioAIBlockTableLocation, FolioAIComment, FolioAIEditAppliedOperation, FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditNormalization, FolioAIEditNormalizationCode, FolioAIEditOperation, FolioAIEditPrecondition, FolioAIEditReviewMeta, FolioAIEditSeverity, FolioAIEditSkipReason, FolioAIEditSkippedOperation, FolioAIEditSnapshot, FolioAIInlineFormatting, FolioAISignatureParty, FolioAITextRangeHandle, FolioDocumentNavigationTarget, FolioDocumentOutline, FolioDocumentOutlineEntry, FolioDocumentSection, FolioDocumentSectionHandle, FolioDocumentSectionReadResult } from "./types.js";
+import { WORD_DIFF_GRANULARITIES, WordDiffGranularity, WordDiffNormalization, WordDiffOptions, WordDiffSegment, diffWordSegments } from "./word-diff.js";
+import { FolioAIEditApplyOutcome, FolioAIEditView, FolioRevisionStamp, FolioWordDiffOptions, applyFolioAIEditOperations } from "./apply.js";
 import { DocPositionRange, clampRangeToDocSize, resolveFolioAIBlockRange, resolveFolioAITextRange, resolvePassageRange } from "./blockRange.js";
 import { buildAnnotatedBlockText } from "./clean-text.js";
-import { ApplyFolioDocumentOperationsOptions, 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, FolioDocumentOperation, FolioDocumentOperationAffectedTarget, FolioDocumentOperationBatch, FolioDocumentOperationCapabilities, FolioDocumentOperationIssue, FolioDocumentOperationMode, FolioDocumentOperationPrecondition, FolioDocumentOperationReceipt, FolioDocumentOperationRecovery, FolioDocumentOperationResult, FolioDocumentOperationStatus, FolioDocumentOperationStory, FolioDocumentOperationType, FolioDocumentOperationUndoFailureReason, FolioDocumentOperationUndoHandle, FolioDocumentOperationUndoResult, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch } from "../document-operations.js";
+import { ApplyFolioDocumentOperationsOptions, 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, FolioDocumentOperation, FolioDocumentOperationAffectedTarget, FolioDocumentOperationBatch, FolioDocumentOperationCapabilities, FolioDocumentOperationIssue, FolioDocumentOperationMode, FolioDocumentOperationPrecondition, FolioDocumentOperationReceipt, FolioDocumentOperationRecovery, FolioDocumentOperationResult, FolioDocumentOperationResultBase, FolioDocumentOperationStatus, FolioDocumentOperationStory, FolioDocumentOperationType, FolioDocumentOperationUndoFailureReason, FolioDocumentOperationUndoHandle, FolioDocumentOperationUndoResult, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch } from "../document-operations.js";
 import { FolioCommentAnchor, FolioReviewChange, FolioReviewChangeKind, getCommentAnchorsFromDoc, getTrackedChangesFromDoc } from "./read.js";
 import { FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FolioApplyDocumentOperationsToStoryOptions, FolioDocumentStory, FolioDocumentStoryHandle, FolioDocumentStoryNotFoundError, FolioEditableDocumentStoryHandle, FolioReadReviewedStoryOptions, FolioResolveReviewedStoryOptions, FolioResolvedReviewedView, FolioReviewedStory, FolioReviewedView, UnsupportedFolioReviewedViewError, isFolioResolvedReviewedView, isFolioReviewedView } from "./headless.js";
-import { createFolioAIEditSnapshot, createFolioAITextRangeHandle, hashFolioAIBlockText, normalizeFolioAIBlockText } from "./snapshot.js";
+import { createFolioAIEditSnapshot, createFolioAITextRangeHandle, hashFolioAIBlockText, isFolioAIContentBlock, normalizeFolioAIBlockText } from "./snapshot.js";
 import { getFolioDocumentOutline, readFolioDocumentSection } from "./scoped-reading.js";
 import { getFolioParaIdFromBlockId } from "../types/block-id.js";
-import { WordDiffSegment, diffWordSegments } from "./word-diff.js";
-export { type ApplyFolioDocumentOperationsOptions, type DocPositionRange, 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, FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIComment, type FolioAIEditAppliedOperation, type FolioAIEditApplyMode, type FolioAIEditApplyResult, type FolioAIEditNormalization, type FolioAIEditNormalizationCode, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditReviewMeta, type FolioAIEditSeverity, type FolioAIEditSkipReason, type FolioAIEditSkippedOperation, type FolioAIEditSnapshot, type FolioAIEditView, type FolioAIInlineFormatting, type FolioAISignatureParty, type FolioAITextRangeHandle, type FolioApplyDocumentOperationsToStoryOptions, type FolioCommentAnchor, type FolioDocumentNavigationTarget, 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 FolioDocumentOutline, type FolioDocumentOutlineEntry, type FolioDocumentSection, type FolioDocumentSectionHandle, type FolioDocumentSectionReadResult, type FolioDocumentStory, type FolioDocumentStoryHandle, FolioDocumentStoryNotFoundError, type FolioEditableDocumentStoryHandle, type FolioReadReviewedStoryOptions, type FolioResolveReviewedStoryOptions, type FolioResolvedReviewedView, type FolioReviewChange, type FolioReviewChangeKind, type FolioReviewedStory, type FolioReviewedView, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioReviewedViewError, type WordDiffSegment, applyFolioAIEditOperations, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, buildAnnotatedBlockText, clampRangeToDocSize, createFolioAIEditSnapshot, createFolioAITextRangeHandle, diffWordSegments, getCommentAnchorsFromDoc, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, getTrackedChangesFromDoc, hashFolioAIBlockText, isFolioDocumentOperationModeSupported, isFolioResolvedReviewedView, isFolioReviewedView, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, readFolioDocumentSection, resolveFolioAIBlockRange, resolveFolioAITextRange, resolvePassageRange };
+export { type ApplyFolioDocumentOperationsOptions, type DocPositionRange, 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, FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIBlockTableLocation, type FolioAIComment, type FolioAIEditAppliedOperation, type FolioAIEditApplyMode, type FolioAIEditApplyOutcome, type FolioAIEditApplyResult, type FolioAIEditNormalization, type FolioAIEditNormalizationCode, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditReviewMeta, type FolioAIEditSeverity, type FolioAIEditSkipReason, type FolioAIEditSkippedOperation, type FolioAIEditSnapshot, type FolioAIEditView, type FolioAIInlineFormatting, type FolioAISignatureParty, type FolioAITextRangeHandle, type FolioApplyDocumentOperationsToStoryOptions, type FolioCommentAnchor, type FolioDocumentNavigationTarget, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationResultBase, type FolioDocumentOperationStatus, type FolioDocumentOperationStory, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type FolioDocumentOutline, type FolioDocumentOutlineEntry, type FolioDocumentSection, type FolioDocumentSectionHandle, type FolioDocumentSectionReadResult, type FolioDocumentStory, type FolioDocumentStoryHandle, FolioDocumentStoryNotFoundError, type FolioEditableDocumentStoryHandle, type FolioReadReviewedStoryOptions, type FolioResolveReviewedStoryOptions, type FolioResolvedReviewedView, type FolioReviewChange, type FolioReviewChangeKind, type FolioReviewedStory, type FolioReviewedView, type FolioRevisionStamp, type FolioWordDiffOptions, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioReviewedViewError, WORD_DIFF_GRANULARITIES, type WordDiffGranularity, type WordDiffNormalization, type WordDiffOptions, type WordDiffSegment, applyFolioAIEditOperations, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, buildAnnotatedBlockText, clampRangeToDocSize, createFolioAIEditSnapshot, createFolioAITextRangeHandle, diffWordSegments, getCommentAnchorsFromDoc, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, getTrackedChangesFromDoc, hashFolioAIBlockText, isFolioAIContentBlock, isFolioDocumentOperationModeSupported, isFolioResolvedReviewedView, isFolioReviewedView, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, readFolioDocumentSection, resolveFolioAIBlockRange, resolveFolioAITextRange, resolvePassageRange };

package/dist/ai-edits/index.js

@@ -6,6 +6,6 @@ import { buildAnnotatedBlockText } from "./clean-text.js";
 import { FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FolioDocumentStoryNotFoundError, UnsupportedFolioReviewedViewError, isFolioResolvedReviewedView, isFolioReviewedView } from "./headless.js";
 import { getCommentAnchorsFromDoc, getTrackedChangesFromDoc } from "./read.js";
 import { getFolioDocumentOutline, readFolioDocumentSection } from "./scoped-reading.js";
-import { createFolioAIEditSnapshot, createFolioAITextRangeHandle, hashFolioAIBlockText, normalizeFolioAIBlockText } from "./snapshot.js";
-import { diffWordSegments } from "./word-diff.js";
-export { 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, FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FolioDocumentStoryNotFoundError, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioReviewedViewError, applyFolioAIEditOperations, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, buildAnnotatedBlockText, clampRangeToDocSize, createFolioAIEditSnapshot, createFolioAITextRangeHandle, diffWordSegments, getCommentAnchorsFromDoc, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, getTrackedChangesFromDoc, hashFolioAIBlockText, isFolioDocumentOperationModeSupported, isFolioResolvedReviewedView, isFolioReviewedView, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, readFolioDocumentSection, resolveFolioAIBlockRange, resolveFolioAITextRange, resolvePassageRange };
+import { createFolioAIEditSnapshot, createFolioAITextRangeHandle, hashFolioAIBlockText, isFolioAIContentBlock, normalizeFolioAIBlockText } from "./snapshot.js";
+import { WORD_DIFF_GRANULARITIES, diffWordSegments } from "./word-diff.js";
+export { 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, FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FolioDocumentStoryNotFoundError, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioReviewedViewError, WORD_DIFF_GRANULARITIES, applyFolioAIEditOperations, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, buildAnnotatedBlockText, clampRangeToDocSize, createFolioAIEditSnapshot, createFolioAITextRangeHandle, diffWordSegments, getCommentAnchorsFromDoc, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, getTrackedChangesFromDoc, hashFolioAIBlockText, isFolioAIContentBlock, isFolioDocumentOperationModeSupported, isFolioResolvedReviewedView, isFolioReviewedView, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, readFolioDocumentSection, resolveFolioAIBlockRange, resolveFolioAITextRange, resolvePassageRange };

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

@@ -60,6 +60,10 @@ type FolioCommentAnchor = {
  * 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.
  */
 declare const getTrackedChangesFromDoc: (doc: Node) => FolioReviewChange[];
 /**

package/dist/ai-edits/read.js

@@ -44,9 +44,20 @@ const firstBlockIdWithin = ({ node, nodePos, blockStarts }) => {
 	return blockId;
 };
 /**
+* Whether a run's revision inside a marked row is that row's own. Folio writes
+* both halves under one revision id; Word mints a fresh `w:id` per element, so
+* an author + timestamp match counts too. A third party's edit inside the row
+* 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) => {
 	const insertionType = doc.type.schema.marks["insertion"];
@@ -54,8 +65,10 @@ const getTrackedChangesFromDoc = (doc) => {
 	const blockStarts = blockStartIdsFromDoc(doc);
 	const grouped = /* @__PURE__ */ new Map();
 	const structuralChangeCellPositions = /* @__PURE__ */ new Map();
+	const rowRevisionScopes = [];
 	let currentBlockId = null;
 	doc.descendants((node, pos) => {
+		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({
@@ -80,7 +93,7 @@ const getTrackedChangesFromDoc = (doc) => {
 			const revisionId = marker.revisionId;
 			const author = "author" in marker ? marker.author : void 0;
 			const date = "date" in marker ? marker.date : void 0;
-			grouped.set(`row:${kind}:${revisionId}:${String(pos)}`, {
+			const change = {
 				id: revisionId,
 				type: kind,
 				author: typeof author === "string" ? author : "",
@@ -91,6 +104,12 @@ const getTrackedChangesFromDoc = (doc) => {
 					nodePos: pos,
 					blockStarts
 				})
+			};
+			grouped.set(`row:${kind}:${revisionId}:${String(pos)}`, change);
+			rowRevisionScopes.push({
+				end: pos + node.nodeSize,
+				kind: kind === "rowInserted" ? "insertion" : "deletion",
+				change
 			});
 		}
 		if (node.type.name === "tableCell" || node.type.name === "tableHeader") {
@@ -182,19 +201,24 @@ const getTrackedChangesFromDoc = (doc) => {
 			else if (mark.type === deletionType) kind = "deletion";
 			else continue;
 			const revisionId = mark.attrs["revisionId"];
+			const author = mark.attrs["author"];
+			const date = mark.attrs["date"];
+			const revision = {
+				id: revisionId,
+				author: typeof author === "string" ? author : "",
+				date: typeof date === "string" ? date : null
+			};
+			const rowScope = rowRevisionScopes.at(-1);
+			if (rowScope?.kind === kind && belongsToRowRevision(rowScope, revision)) continue;
 			const key = `${currentBlockId ?? ""}:${kind}:${revisionId}`;
 			const existing = grouped.get(key);
 			if (existing) {
 				existing.text += text;
 				continue;
 			}
-			const author = mark.attrs["author"];
-			const date = mark.attrs["date"];
 			grouped.set(key, {
-				id: revisionId,
+				...revision,
 				type: kind,
-				author: typeof author === "string" ? author : "",
-				date: typeof date === "string" ? date : null,
 				text,
 				blockId: currentBlockId
 			});

package/dist/ai-edits/scoped-reading.js

@@ -1,3 +1,4 @@
+import { isFolioAIContentBlock } from "./snapshot.js";
 //#region src/ai-edits/scoped-reading.ts
 const toSectionHandle = (snapshot, headingBlockId, headingLevel) => {
 	const headingTextHash = snapshot.anchors[headingBlockId]?.textHash;
@@ -15,7 +16,7 @@ const getFolioDocumentOutline = (snapshot) => {
 	const sections = [];
 	const parentStack = [];
 	for (const block of snapshot.blocks) {
-		if (block.headingLevel === void 0) continue;
+		if (block.headingLevel === void 0 || !isFolioAIContentBlock(block)) continue;
 		const handle = toSectionHandle(snapshot, block.id, block.headingLevel);
 		if (handle === null) continue;
 		while ((parentStack.at(-1)?.level ?? 0) >= block.headingLevel) parentStack.pop();
@@ -42,7 +43,7 @@ const readFolioDocumentSection = (snapshot, handle) => {
 	let endIndex = snapshot.blocks.length;
 	for (let index = startIndex + 1; index < snapshot.blocks.length; index++) {
 		const block = snapshot.blocks.at(index);
-		if (block?.headingLevel !== void 0 && block.headingLevel <= heading.level) {
+		if (block !== void 0 && block.headingLevel !== void 0 && block.headingLevel <= heading.level && isFolioAIContentBlock(block)) {
 			endIndex = index;
 			break;
 		}
@@ -52,7 +53,7 @@ const readFolioDocumentSection = (snapshot, handle) => {
 		section: {
 			handle,
 			heading,
-			blocks: snapshot.blocks.slice(startIndex, endIndex)
+			blocks: snapshot.blocks.slice(startIndex, endIndex).filter(isFolioAIContentBlock)
 		}
 	};
 };

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

@@ -1,7 +1,39 @@
-import { FolioAIEditSnapshot, FolioAITextRangeHandle } from "./types.js";
+import { FolioAIBlock, FolioAIEditSnapshot, FolioAITextRangeHandle } from "./types.js";
 import { Node } from "prosemirror-model";
 //#region src/ai-edits/snapshot.d.ts
 declare const normalizeFolioAIBlockText: (text: string) => string;
+/**
+ * Whether a block carries text a reader would see.
+ *
+ * The snapshot holds every paragraph, blank ones included: an empty cell is
+ * part of a table's shape, an empty row is a row, and a comparison that cannot
+ * address them cannot describe what changed around them. A reading surface
+ * wants the opposite — a model shown a document should see its content, not a
+ * line per blank paragraph.
+ *
+ * So the two needs are split here rather than in the walk: the snapshot is
+ * complete, and every surface that reads it for a person or a model states
+ * that it wants content by calling this. One helper, so "what counts as
+ * content" has a single answer; five inline emptiness checks would drift.
+ */
+declare const isFolioAIContentBlock: ({ text }: Pick<FolioAIBlock, "text">) => boolean;
+/**
+ * The block that content appended to the end of a story hangs from: the last
+ * paragraph at body level.
+ *
+ * Not simply the last block. A story's last block is often inside a table, and
+ * a paragraph cannot be appended after one: the insertion escapes to the
+ * table's boundary, where the block it was anchored to is not adjacent to it
+ * and its paragraph mark ends a different container's paragraph. Neither
+ * container-edge rule then applies and the addition cannot be rejected
+ * cleanly.
+ *
+ * A body always ends with a paragraph — a table may not be the last child of a
+ * body or a cell, so a package that ends in a table carries a trailing, often
+ * empty, paragraph after it — so this is only `null` for a story with no
+ * body-level paragraph at all, which is a malformed document.
+ */
+declare const trailingBodyBlockId: ({ blocks }: FolioAIEditSnapshot) => string | null;
 declare const hashFolioAIBlockText: (text: string) => string;
 type CreateFolioAITextRangeHandleOptions = {
   blockId: string;
@@ -10,6 +42,14 @@ type CreateFolioAITextRangeHandleOptions = {
   endOffset: number;
 };
 declare const createFolioAITextRangeHandle: ({ blockId, text, startOffset, endOffset }: CreateFolioAITextRangeHandleOptions) => FolioAITextRangeHandle | null;
+/**
+ * True for a `tableRow` marked `hidden` (OOXML `w:trPr/w:hidden` — Word never
+ * renders the row). Nothing inside such a row may 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. The walk skips the row's
+ * whole subtree, so a table nested inside a hidden row is hidden with it.
+ */
+declare const isHiddenTableRow: (node: Node) => boolean;
 declare const createFolioAIEditSnapshot: (doc: Node) => FolioAIEditSnapshot;
 //#endregion
-export { createFolioAIEditSnapshot, createFolioAITextRangeHandle, hashFolioAIBlockText, normalizeFolioAIBlockText };
+export { createFolioAIEditSnapshot, createFolioAITextRangeHandle, hashFolioAIBlockText, isFolioAIContentBlock, isHiddenTableRow, normalizeFolioAIBlockText, trailingBodyBlockId };