@stll/folio-core 0.10.0 → 0.12.0

package/dist/ai-edits/block-identity.d.ts

@@ -0,0 +1,4 @@
+//#region src/ai-edits/block-identity.d.ts
+declare const stripBlockIdentityAttrs: (attrs: Record<string, unknown>) => Record<string, unknown>;
+//#endregion
+export { stripBlockIdentityAttrs };

package/dist/ai-edits/block-identity.js

@@ -0,0 +1,9 @@
+//#region src/ai-edits/block-identity.ts
+const IDENTITY_BLOCK_ATTRS = /* @__PURE__ */ new Set(["paraId", "textId"]);
+const stripBlockIdentityAttrs = (attrs) => {
+	const next = {};
+	for (const [key, value] of Object.entries(attrs)) next[key] = IDENTITY_BLOCK_ATTRS.has(key) ? null : value;
+	return next;
+};
+//#endregion
+export { stripBlockIdentityAttrs };

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

@@ -27,6 +27,33 @@ declare const resolveFolioAITextRange: ({
   doc,
   snapshot
 }: ResolveFolioAITextRangeOptions) => DocPositionRange | null;
+type ResolvePassageRangeOptions = {
+  blockId: string;
+  text: string;
+  doc: Node;
+  snapshot?: FolioAIEditSnapshot | null | undefined;
+};
+/**
+ * Resolve a free-text passage inside a block to a `{ from, to }` PM range.
+ *
+ * First resolves the block the same way {@link resolveFolioAIBlockRange} does
+ * (live paraId lookup, then snapshot/seq fallback). Then matches `text` against
+ * the block's post-tracked-changes clean text (so the offsets it finds still
+ * map back to live PM positions on a doc with pending redlines) and maps the
+ * match back through the clean-text `offsets`.
+ *
+ * Matching normalizes whitespace runs in the needle to `\s+` (typography inserts
+ * non-breaking / narrow spaces that the caller's quoted text won't reproduce
+ * exactly) and tries case-sensitive first, then case-insensitive; the first
+ * match wins. Returns null when the block does not resolve, is not a textblock,
+ * the needle is empty, or the text does not occur in the block.
+ */
+declare const resolvePassageRange: ({
+  blockId,
+  text,
+  doc,
+  snapshot
+}: ResolvePassageRangeOptions) => DocPositionRange | null;
 /**
  * Clamp a `{from, to}` pair so both endpoints fit inside a document of
  * `docSize` (in PM content positions). Block-boundary snapshots and stale
@@ -41,4 +68,4 @@ declare const resolveFolioAITextRange: ({
  */
 declare function clampRangeToDocSize(docSize: number, range: DocPositionRange): DocPositionRange;
 //#endregion
-export { DocPositionRange, clampRangeToDocSize, resolveFolioAIBlockRange, resolveFolioAITextRange };
+export { DocPositionRange, clampRangeToDocSize, resolveFolioAIBlockRange, resolveFolioAITextRange, resolvePassageRange };

package/dist/ai-edits/blockRange.js

@@ -38,6 +38,72 @@ const resolveFolioAITextRange = ({ range, doc, snapshot }) => {
 	});
 };
 /**
+* Resolve a free-text passage inside a block to a `{ from, to }` PM range.
+*
+* First resolves the block the same way {@link resolveFolioAIBlockRange} does
+* (live paraId lookup, then snapshot/seq fallback). Then matches `text` against
+* the block's post-tracked-changes clean text (so the offsets it finds still
+* map back to live PM positions on a doc with pending redlines) and maps the
+* match back through the clean-text `offsets`.
+*
+* Matching normalizes whitespace runs in the needle to `\s+` (typography inserts
+* non-breaking / narrow spaces that the caller's quoted text won't reproduce
+* exactly) and tries case-sensitive first, then case-insensitive; the first
+* match wins. Returns null when the block does not resolve, is not a textblock,
+* the needle is empty, or the text does not occur in the block.
+*/
+const resolvePassageRange = ({ blockId, text, doc, snapshot }) => {
+	const blockRange = resolveFolioAIBlockRange({
+		blockId,
+		doc,
+		snapshot
+	});
+	if (blockRange === null) return null;
+	const blockNode = doc.nodeAt(blockRange.from);
+	if (!blockNode?.isTextblock) return null;
+	const needleSource = buildPassageNeedleSource(text);
+	if (needleSource === null) return null;
+	const cleanBlock = buildCleanBlockText(blockNode, blockRange.from);
+	const match = matchPassage(cleanBlock.text, needleSource);
+	if (match === null) return null;
+	const from = cleanBlock.offsets[match.start];
+	const to = cleanBlock.offsets[match.end];
+	if (from === void 0 || to === void 0) return null;
+	return clampRangeToDocSize(doc.content.size, {
+		from,
+		to
+	});
+};
+/**
+* Turn a caller-supplied passage into a regex source that tolerates whitespace
+* variance. The needle is trimmed first (quoted passages routinely carry
+* accidental leading/trailing whitespace that the block text won't reproduce),
+* then regex metacharacters are escaped so the literal text matches, then
+* whitespace runs collapse to `\s+` (mirrors the anonymization matcher).
+* Returns null for empty / whitespace-only input so an empty needle can never
+* match at offset 0 and paint a zero-width highlight.
+*/
+const buildPassageNeedleSource = (text) => {
+	const trimmed = text.trim();
+	if (trimmed.length === 0) return null;
+	return trimmed.replaceAll(/[\\^$.*+?()[\]{}|]/gu, "\\$&").replaceAll(/\s+/gu, "\\s+");
+};
+/**
+* Case-sensitive match first, then case-insensitive fallback. The first hit in
+* each pass wins; `index` and length are clean-text offsets the caller maps back
+* through `offsets`.
+*/
+const matchPassage = (haystack, needleSource) => {
+	for (const flags of ["u", "iu"]) {
+		const match = new RegExp(needleSource, flags).exec(haystack);
+		if (match !== null) return {
+			start: match.index,
+			end: match.index + match[0].length
+		};
+	}
+	return null;
+};
+/**
 * Resolve a `seq-NNNN` fallback id by document position.
 *
 * A sequential id is only minted for a paragraph the source DOCX left
@@ -76,4 +142,4 @@ function clampRangeToDocSize(docSize, range) {
 	};
 }
 //#endregion
-export { clampRangeToDocSize, resolveFolioAIBlockRange, resolveFolioAITextRange };
+export { clampRangeToDocSize, resolveFolioAIBlockRange, resolveFolioAITextRange, resolvePassageRange };

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

@@ -222,10 +222,10 @@ declare class FolioDocxReviewer {
   /** Read one discovered story; returns null when its handle is no longer present. */
   readStory(handle: FolioDocumentStoryHandle): FolioDocumentStory | null;
   /**
-   * The tracked changes (insertions and deletions) present in the body, read
-   * from the same `insertion` / `deletion` marks the editor renders. Each
-   * carries the revision id {@link acceptChange} / {@link rejectChange} resolve
-   * against. Runs of one revision within a block fold into a single entry.
+   * The tracked changes present in the body, including inline and structural
+   * revisions. Each carries the revision id {@link acceptChange} /
+   * {@link rejectChange} resolve against. Related revision sites fold into one
+   * entry where the document model identifies them as one authored change.
    */
   getChanges(filter?: FolioReviewChangeFilter): FolioReviewChange[];
   /**

package/dist/ai-edits/headless.js

@@ -1,19 +1,19 @@
+import { proseDocToBlocks, updateDocumentContent } from "../prosemirror/conversion/fromProseDoc.js";
 import { buildAnnotatedBlockText } from "./clean-text.js";
 import { createFolioAIEditSnapshot, normalizeFolioAIBlockText } from "./snapshot.js";
+import { getChangedParagraphIds, hasStructuralChanges, hasUntrackedChanges, ignoreTrackedChanges } from "../prosemirror/extensions/features/ParagraphChangeTrackerExtension.js";
+import { deterministicHexId } from "../utils/hexId.js";
+import { schema, singletonManager } from "../prosemirror/schema/index.js";
+import { footnoteToProseDoc, headerFooterToProseDoc, toProseDoc } from "../prosemirror/conversion/toProseDoc.js";
 import { applyFolioDocumentOperations } from "../document-operations.js";
 import { getEndnoteText, getFootnoteText, isSeparatorEndnote, isSeparatorFootnote } from "../docx/footnoteParser.js";
 import { getHeaderFooterText } from "../docx/headerFooterParser.js";
 import { parseDocx } from "../docx/parser.js";
-import { deterministicHexId } from "../utils/hexId.js";
 import { repackDocx } from "../docx/rezip.js";
 import { getCommentAnchorsFromDoc, getTrackedChangesFromDoc } from "./read.js";
 import { createReply } from "../docx/replyToComment.js";
 import { attemptSelectiveSave } from "../docx/selectiveSave.js";
 import { acceptAIEditRevision, acceptAllChanges, rejectAIEditRevision, rejectAllChanges } from "../prosemirror/commands/comments.js";
-import { proseDocToBlocks, updateDocumentContent } from "../prosemirror/conversion/fromProseDoc.js";
-import { getChangedParagraphIds, hasStructuralChanges, hasUntrackedChanges, ignoreTrackedChanges } from "../prosemirror/extensions/features/ParagraphChangeTrackerExtension.js";
-import { schema, singletonManager } from "../prosemirror/schema/index.js";
-import { footnoteToProseDoc, headerFooterToProseDoc, toProseDoc } from "../prosemirror/conversion/toProseDoc.js";
 import { TaggedError } from "better-result";
 import { EditorState } from "prosemirror-state";
 //#region src/ai-edits/headless.ts
@@ -522,10 +522,10 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 		return stories.find(({ handle: candidate }) => (candidate.type === "footnote" || candidate.type === "endnote") && candidate.type === handle.type && candidate.noteId === handle.noteId) ?? null;
 	}
 	/**
-	* The tracked changes (insertions and deletions) present in the body, read
-	* from the same `insertion` / `deletion` marks the editor renders. Each
-	* carries the revision id {@link acceptChange} / {@link rejectChange} resolve
-	* against. Runs of one revision within a block fold into a single entry.
+	* The tracked changes present in the body, including inline and structural
+	* revisions. Each carries the revision id {@link acceptChange} /
+	* {@link rejectChange} resolve against. Related revision sites fold into one
+	* entry where the document model identifies them as one authored change.
 	*/
 	getChanges(filter) {
 		const changes = getTrackedChangesFromDoc(this.state.doc);

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

@@ -1,6 +1,6 @@
 import { FolioAIBlock, FolioAIBlockAnchor, FolioAIBlockKind, FolioAIBlockPreviewRun, FolioAIComment, FolioAIEditAppliedOperation, FolioAIEditApplyMode, FolioAIEditApplyResult, 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 { DocPositionRange, clampRangeToDocSize, resolveFolioAIBlockRange, resolveFolioAITextRange } from "./blockRange.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 { FolioCommentAnchor, FolioReviewChange, FolioReviewChangeKind, getCommentAnchorsFromDoc, getTrackedChangesFromDoc } from "./read.js";
@@ -9,4 +9,4 @@ import { createFolioAIEditSnapshot, createFolioAITextRangeHandle, hashFolioAIBlo
 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 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 };
+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 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 };

package/dist/ai-edits/index.js

@@ -4,8 +4,8 @@ import { createFolioAIEditSnapshot, createFolioAITextRangeHandle, hashFolioAIBlo
 import { diffWordSegments } from "./word-diff.js";
 import { applyFolioAIEditOperations } from "./apply.js";
 import { FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch } from "../document-operations.js";
-import { clampRangeToDocSize, resolveFolioAIBlockRange, resolveFolioAITextRange } from "./blockRange.js";
+import { clampRangeToDocSize, resolveFolioAIBlockRange, resolveFolioAITextRange, resolvePassageRange } from "./blockRange.js";
 import { getCommentAnchorsFromDoc, getTrackedChangesFromDoc } from "./read.js";
 import { getFolioDocumentOutline, readFolioDocumentSection } from "./scoped-reading.js";
 import { FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FolioDocumentStoryNotFoundError, UnsupportedFolioReviewedViewError, isFolioResolvedReviewedView, isFolioReviewedView } from "./headless.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 };
+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 };

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

@@ -1,18 +1,18 @@
 import { Node } from "prosemirror-model";
 
 //#region src/ai-edits/read.d.ts
-type FolioReviewChangeKind = "insertion" | "deletion";
-/** A tracked change (insertion or deletion) discovered in the document body. */
+type FolioReviewChangeKind = "insertion" | "deletion" | "formatting" | "rowInserted" | "rowDeleted" | "cellInserted" | "cellDeleted" | "cellMerged";
+/** A tracked change discovered in the document body. */
 type FolioReviewChange = {
   /**
    * The tracked-change revision id — the OOXML `w:id` carried on the
-   * insertion / deletion mark. A replace produces two changes (a deletion side
+   * revision marker. A text replacement produces two changes (a deletion side
    * and an insertion side) with distinct ids.
    */
   id: number;
   type: FolioReviewChangeKind;
   author: string; /** ISO date the change was authored, or `null` when the source omitted it. */
-  date: string | null; /** Inserted text for insertions, removed text for deletions. */
+  date: string | null; /** Affected text, including row or cell content for structural revisions. */
   text: string;
   /**
    * Stable id of the containing body block (Word `w14:paraId` or `seq-NNNN`).
@@ -28,9 +28,9 @@ type FolioCommentAnchor = {
   quote: string;
 };
 /**
- * The tracked changes (insertions and deletions) present in the body, read from
- * the `insertion` / `deletion` marks the editor renders. Runs of one revision
- * within a block fold into a single entry.
+ * 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.
  */
 declare const getTrackedChangesFromDoc: (doc: Node) => FolioReviewChange[];
 /**

package/dist/ai-edits/read.js

@@ -1,4 +1,6 @@
+import { expectRunPropertyChangeMarkAttrs } from "../prosemirror/attrs/index.js";
 import { createFolioAIEditSnapshot } from "./snapshot.js";
+import { getTableCellMergeChange } from "../prosemirror/tableCellMergeRevision.js";
 //#region src/ai-edits/read.ts
 /** Map each snapshot block's start position to its stable id. */
 const blockStartIdsFromDoc = (doc) => {
@@ -6,18 +8,103 @@ const blockStartIdsFromDoc = (doc) => {
 	for (const anchor of Object.values(createFolioAIEditSnapshot(doc).anchors)) starts.set(anchor.from, anchor.id);
 	return starts;
 };
+const firstBlockIdWithin = ({ node, nodePos, blockStarts }) => {
+	let blockId = null;
+	node.descendants((child, relativePos) => {
+		if (blockId !== null || !child.isTextblock) return blockId === null;
+		blockId = blockStarts.get(nodePos + 1 + relativePos) ?? null;
+		return false;
+	});
+	return blockId;
+};
 /**
-* The tracked changes (insertions and deletions) present in the body, read from
-* the `insertion` / `deletion` marks the editor renders. Runs of one revision
-* within a block fold into a single entry.
+* 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.
 */
 const getTrackedChangesFromDoc = (doc) => {
 	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();
 	let currentBlockId = null;
 	doc.descendants((node, pos) => {
+		if (node.type.name === "tableRow") for (const [attrName, kind] of [["trIns", "rowInserted"], ["trDel", "rowDeleted"]]) {
+			const marker = node.attrs[attrName];
+			if (typeof marker !== "object" || marker === null || !("revisionId" in marker) || typeof marker.revisionId !== "number") continue;
+			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)}`, {
+				id: revisionId,
+				type: kind,
+				author: typeof author === "string" ? author : "",
+				date: typeof date === "string" ? date : null,
+				text: node.textContent,
+				blockId: firstBlockIdWithin({
+					node,
+					nodePos: pos,
+					blockStarts
+				})
+			});
+		}
+		if (node.type.name === "tableCell" || node.type.name === "tableHeader") {
+			const marker = node.attrs["cellMarker"];
+			if (typeof marker === "object" && marker !== null && "kind" in marker && (marker.kind === "ins" || marker.kind === "del" || marker.kind === "merge") && "info" in marker && typeof marker.info === "object" && marker.info !== null && "revisionId" in marker.info && typeof marker.info.revisionId === "number") {
+				const revisionId = marker.info.revisionId;
+				const author = "author" in marker.info ? marker.info.author : void 0;
+				const date = "date" in marker.info ? marker.info.date : void 0;
+				let kind = "cellMerged";
+				if (marker.kind === "ins") kind = "cellInserted";
+				else if (marker.kind === "del") kind = "cellDeleted";
+				const key = `cell:${kind}:${revisionId}`;
+				const text = node.textContent;
+				const blockId = firstBlockIdWithin({
+					node,
+					nodePos: pos,
+					blockStarts
+				});
+				const existing = grouped.get(key);
+				const cellPositions = structuralChangeCellPositions.get(key) ?? /* @__PURE__ */ new Set();
+				const shouldAppendText = existing !== void 0 && !cellPositions.has(pos);
+				grouped.set(key, {
+					id: revisionId,
+					type: kind,
+					author: typeof author === "string" ? author : "",
+					date: typeof date === "string" ? date : null,
+					text: shouldAppendText && existing.text.length > 0 && text.length > 0 ? `${existing.text}\n${text}` : existing?.text || text,
+					blockId: existing?.blockId ?? blockId
+				});
+				cellPositions.add(pos);
+				structuralChangeCellPositions.set(key, cellPositions);
+			}
+			const continuationCells = node.attrs["_docxVMergeContinuationCells"];
+			if (Array.isArray(continuationCells)) for (const continuationCell of continuationCells) {
+				const change = getTableCellMergeChange(continuationCell);
+				if (!change) continue;
+				const revisionId = change.info.id;
+				const key = `cell:cellMerged:${revisionId}`;
+				const existing = grouped.get(key);
+				const text = node.textContent;
+				const cellPositions = structuralChangeCellPositions.get(key) ?? /* @__PURE__ */ new Set();
+				const shouldAppendText = existing !== void 0 && !cellPositions.has(pos);
+				grouped.set(key, {
+					id: revisionId,
+					type: "cellMerged",
+					author: change.info.author,
+					date: change.info.date ?? null,
+					text: shouldAppendText && existing.text.length > 0 && text.length > 0 ? `${existing.text}\n${text}` : existing?.text || text,
+					blockId: existing?.blockId ?? firstBlockIdWithin({
+						node,
+						nodePos: pos,
+						blockStarts
+					})
+				});
+				cellPositions.add(pos);
+				structuralChangeCellPositions.set(key, cellPositions);
+			}
+		}
 		if (node.isTextblock) {
 			currentBlockId = blockStarts.get(pos) ?? null;
 			return true;
@@ -25,6 +112,26 @@ const getTrackedChangesFromDoc = (doc) => {
 		if (!node.isInline || node.text === void 0) return;
 		const text = node.text;
 		for (const mark of node.marks) {
+			if (mark.type.name === "runPropertyChange") {
+				const { changes } = expectRunPropertyChangeMarkAttrs(mark);
+				for (const change of changes) {
+					const key = `${currentBlockId ?? ""}:formatting:${String(change.info.id)}`;
+					const existing = grouped.get(key);
+					if (existing) {
+						existing.text += text;
+						continue;
+					}
+					grouped.set(key, {
+						id: change.info.id,
+						type: "formatting",
+						author: change.info.author,
+						date: change.info.date ?? null,
+						text,
+						blockId: currentBlockId
+					});
+				}
+				continue;
+			}
 			if (typeof mark.attrs["revisionId"] !== "number") continue;
 			let kind;
 			if (mark.type === insertionType) kind = "insertion";

package/dist/ai-edits/table-cell-mutations.d.ts

@@ -0,0 +1,48 @@
+import { TableRectangle } from "./table-mutation-plan.js";
+import { Transaction } from "prosemirror-state";
+import { Node } from "prosemirror-model";
+
+//#region src/ai-edits/table-cell-mutations.d.ts
+type TableCellRectangleMutationOptions = {
+  tr: Transaction;
+  tablePosition: number;
+  table: Node;
+  rectangle: TableRectangle;
+};
+type TrackedTableCellRectangleMutationOptions = TableCellRectangleMutationOptions & {
+  revisionId: number;
+  author: string;
+  date: string;
+};
+declare const mergeTableRectangle: ({
+  tr,
+  tablePosition,
+  table,
+  rectangle
+}: TableCellRectangleMutationOptions) => Transaction | null;
+declare const mergeTrackedVerticalTableCells: ({
+  tr,
+  tablePosition,
+  table,
+  rectangle,
+  revisionId,
+  author,
+  date
+}: TrackedTableCellRectangleMutationOptions) => Transaction | null;
+declare const splitTableRectangle: ({
+  tr,
+  tablePosition,
+  table,
+  rectangle
+}: TableCellRectangleMutationOptions) => Transaction | null;
+declare const splitTrackedVerticalTableCell: ({
+  tr,
+  tablePosition,
+  table,
+  rectangle,
+  revisionId,
+  author,
+  date
+}: TrackedTableCellRectangleMutationOptions) => Transaction | null;
+//#endregion
+export { mergeTableRectangle, mergeTrackedVerticalTableCells, splitTableRectangle, splitTrackedVerticalTableCell };