@stll/folio-core 0.5.0 → 0.6.1

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

@@ -1,6 +1,6 @@
 import { FolioAIBlock, FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditOperation, FolioAIEditSnapshot } from "./types.js";
 import { document_d_exports } from "../types/document.js";
-import { FolioDocumentOperationBatch, FolioDocumentOperationResult } from "../document-operations.js";
+import { FolioDocumentOperationBatch, FolioDocumentOperationResult, FolioDocumentOperationUndoHandle, FolioDocumentOperationUndoResult } from "../document-operations.js";
 import { FolioReviewChange, FolioReviewChangeKind } from "./read.js";
 
 //#region src/ai-edits/headless.d.ts
@@ -98,6 +98,7 @@ declare class FolioDocxReviewer {
   private readonly originalBuffer;
   private state;
   private readonly createdComments;
+  private readonly documentOperationUndoEntries;
   /**
    * Resolved-state overrides recorded by {@link resolveComment}, keyed by
    * comment id. Applied on read ({@link getComments}) and on write
@@ -128,6 +129,9 @@ declare class FolioDocxReviewer {
    * edit semantics.
    */
   applyDocumentOperations(batch: FolioDocumentOperationBatch, options?: FolioApplyDocumentOperationsOptions): FolioDocumentOperationResult;
+  private applyDocumentOperationsInternal;
+  /** Undo the latest unchanged document-operation batch and its created comments. */
+  undoDocumentOperations(undoHandle: FolioDocumentOperationUndoHandle): FolioDocumentOperationUndoResult;
   /**
    * The body blocks with their stable ids, in document order — the same
    * `FolioAIBlock` shape {@link snapshot} builds, reused verbatim so the ids

package/dist/ai-edits/headless.js

@@ -44,6 +44,7 @@ import { EditorState } from "prosemirror-state";
 * across reviewers created within the same millisecond.
 */
 let commentIdCursor = Date.now();
+let undoHandleCursor = Date.now();
 /**
 * Build the note-free comment thread the apply layer references by id.
 * Mirrors `commentsHelpers.createComment` (a pure object literal there) so a
@@ -162,6 +163,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 	originalBuffer;
 	state;
 	createdComments = [];
+	documentOperationUndoEntries = [];
 	/**
 	* Resolved-state overrides recorded by {@link resolveComment}, keyed by
 	* comment id. Applied on read ({@link getComments}) and on write
@@ -210,11 +212,11 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 	* (including any comments) is retained for {@link toBuffer}.
 	*/
 	applyOperations(operations, options = {}) {
-		const { applied, skipped } = this.applyDocumentOperations({
+		const { applied, skipped } = this.applyDocumentOperationsInternal({
 			version: 1,
 			operations,
 			mode: options.mode ?? "tracked-changes"
-		}, { ...options.snapshot !== void 0 && { snapshot: options.snapshot } });
+		}, { ...options.snapshot !== void 0 && { snapshot: options.snapshot } }, false);
 		return {
 			applied,
 			skipped
@@ -227,6 +229,11 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 	* edit semantics.
 	*/
 	applyDocumentOperations(batch, options = {}) {
+		return this.applyDocumentOperationsInternal(batch, options, true);
+	}
+	applyDocumentOperationsInternal(batch, options, createUndoEntry) {
+		const beforeState = this.state;
+		const createdCommentsLengthBefore = this.createdComments.length;
 		const view = {
 			state: this.state,
 			dispatch: (transaction) => {
@@ -242,11 +249,54 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 				const comment = createReviewerComment(text, this.author);
 				this.createdComments.push(comment);
 				return comment.id;
-			}
+			},
+			...createUndoEntry && { createUndoHandle: () => ({
+				type: "documentOperationUndo",
+				id: `headless-${String(undoHandleCursor++)}`
+			}) }
 		});
 		this.state = view.state;
+		if (result.undoHandle !== null) this.documentOperationUndoEntries.push({
+			undoHandle: result.undoHandle,
+			beforeState,
+			afterState: this.state,
+			createdCommentsLengthBefore,
+			createdCommentsLengthAfter: this.createdComments.length
+		});
 		return result;
 	}
+	/** Undo the latest unchanged document-operation batch and its created comments. */
+	undoDocumentOperations(undoHandle) {
+		const entryIndex = this.documentOperationUndoEntries.findIndex((entry) => entry.undoHandle.type === undoHandle.type && entry.undoHandle.id === undoHandle.id);
+		if (entryIndex === -1) return {
+			status: "rejected",
+			undoHandle,
+			reason: "unknownHandle"
+		};
+		if (entryIndex !== this.documentOperationUndoEntries.length - 1) return {
+			status: "rejected",
+			undoHandle,
+			reason: "notLatest"
+		};
+		const entry = this.documentOperationUndoEntries.at(-1);
+		if (!entry) return {
+			status: "rejected",
+			undoHandle,
+			reason: "unknownHandle"
+		};
+		if (this.state !== entry.afterState || this.createdComments.length !== entry.createdCommentsLengthAfter) return {
+			status: "rejected",
+			undoHandle,
+			reason: "documentChanged"
+		};
+		this.state = entry.beforeState;
+		this.createdComments.length = entry.createdCommentsLengthBefore;
+		this.documentOperationUndoEntries.pop();
+		return {
+			status: "undone",
+			undoHandle
+		};
+	}
 	/**
 	* The body blocks with their stable ids, in document order — the same
 	* `FolioAIBlock` shape {@link snapshot} builds, reused verbatim so the ids

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

@@ -1,10 +1,10 @@
 import { FolioAIBlock, FolioAIBlockAnchor, FolioAIBlockKind, FolioAIBlockPreviewRun, FolioAIComment, FolioAIEditAppliedOperation, FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditOperation, FolioAIEditPrecondition, FolioAIEditReviewMeta, FolioAIEditSeverity, FolioAIEditSkipReason, FolioAIEditSkippedOperation, FolioAIEditSnapshot, FolioAIInlineFormatting, FolioAISignatureParty, FolioAITextRangeHandle } from "./types.js";
 import { FolioAIEditView, applyFolioAIEditOperations } from "./apply.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, FolioDocumentOperationType, 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, FolioDocumentOperationStatus, 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 { FolioDocumentStory, FolioDocumentStoryHandle } from "./headless.js";
 import { createFolioAIEditSnapshot, createFolioAITextRangeHandle, hashFolioAIBlockText, normalizeFolioAIBlockText } from "./snapshot.js";
 import { getFolioParaIdFromBlockId } from "../types/block-id.js";
 import { WordDiffSegment, diffWordSegments } from "./word-diff.js";
-export { type 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, 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 FolioCommentAnchor, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationStatus, type FolioDocumentOperationType, type FolioDocumentStory, type FolioDocumentStoryHandle, type FolioReviewChange, type FolioReviewChangeKind, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, type WordDiffSegment, applyFolioAIEditOperations, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, buildAnnotatedBlockText, createFolioAIEditSnapshot, createFolioAITextRangeHandle, diffWordSegments, getCommentAnchorsFromDoc, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getTrackedChangesFromDoc, hashFolioAIBlockText, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch };
+export { type 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, 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 FolioCommentAnchor, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationStatus, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type FolioDocumentStory, type FolioDocumentStoryHandle, type FolioReviewChange, type FolioReviewChangeKind, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, type WordDiffSegment, applyFolioAIEditOperations, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, buildAnnotatedBlockText, createFolioAIEditSnapshot, createFolioAITextRangeHandle, diffWordSegments, getCommentAnchorsFromDoc, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getTrackedChangesFromDoc, hashFolioAIBlockText, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch };

package/dist/compat/eigenpal.d.ts

@@ -1,7 +1,7 @@
 import { FolioAIBlock, FolioAIBlockAnchor, FolioAIBlockKind, FolioAIBlockPreviewRun, FolioAIComment, FolioAIEditAppliedOperation, FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditOperation, FolioAIEditPrecondition, FolioAIEditReviewMeta, FolioAIEditSeverity, FolioAIEditSkipReason, FolioAIEditSkippedOperation, FolioAIEditSnapshot, FolioAISignatureParty } from "../ai-edits/types.js";
 import { applyFolioAIEditOperations } from "../ai-edits/apply.js";
 import { document_d_exports } from "../types/document.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, FolioDocumentOperationType, 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, FolioDocumentOperationStatus, FolioDocumentOperationType, FolioDocumentOperationUndoFailureReason, FolioDocumentOperationUndoHandle, FolioDocumentOperationUndoResult, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch } from "../document-operations.js";
 import { createFolioAIEditSnapshot, hashFolioAIBlockText, normalizeFolioAIBlockText } from "../ai-edits/snapshot.js";
 import { DeriveBlockIdInput, FolioBlockId, deriveBlockId, getFolioParaIdFromBlockId, isFolioBlockId, isSequentialFolioBlockId } from "../types/block-id.js";
 import { WordDiffSegment, diffWordSegments } from "../ai-edits/word-diff.js";
@@ -27,4 +27,4 @@ import { toMarkdown, toMarkdownResult } from "../markdown/index.js";
 import { EmbeddedFont, EmbeddedFontParts, extractEmbeddedFonts, getEmbeddedFontFaces } from "../fonts/embeddedFonts.js";
 import { getGoogleFontsEnabled, setGoogleFontsEnabled } from "../utils/fontResolver.js";
 type Document = document_d_exports.Document;
-export { type AIBarStatus, type AIChatMode, type AICitation, type AICitationRange, type AICitationSource, type AIGenerateInput, type AISuggestion, type AISuggestionApplyMode, type AISuggestionPreset, type AISuggestionSeverity, type AISuggestionStatus, type AcceptAutocompleteResult, type AnonymizationMatch, type AnonymizationTerm, type ApplyFolioDocumentOperationsOptions, type ApplyResult, type AutocompleteSuggestionPluginOptions, type AutocompleteSuggestionState, type AutocompleteSuggestionStatus, type AutocompleteTriggerCheck, type AutocompleteTriggerOptions, type AutocompleteTriggerSkipReason, type CreateEmptyDocumentOptions, DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, type DeriveBlockIdInput, type DirectiveKind, type DirectiveRange, type Document, type DocxCompatibility, type EmbeddedFont, type EmbeddedFontParts, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIComment, type FolioAIEditAppliedOperation, type FolioAIEditApplyMode, type FolioAIEditApplyResult, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditReviewMeta, type FolioAIEditSeverity, type FolioAIEditSkipReason, type FolioAIEditSkippedOperation, type FolioAIEditSnapshot, type FolioAISignatureParty, type FolioBlockId, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationStatus, type FolioDocumentOperationType, type ImageMeta, type ImageRef, InvalidFolioDocumentOperationBatchError, type MarkdownOptions, type MarkdownResult, type PositionalText, type ResolvedAnchor, type TemplatePreviewSpan, type TemplatePreviewValue, type TemplatePreviewValues, type TemplateSlashMenuKeyAction, type TemplateSlashMenuState, UnsupportedFolioDocumentOperationVersionError, type WordDiffSegment, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, deriveBlockId, diffWordSegments, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };
+export { type AIBarStatus, type AIChatMode, type AICitation, type AICitationRange, type AICitationSource, type AIGenerateInput, type AISuggestion, type AISuggestionApplyMode, type AISuggestionPreset, type AISuggestionSeverity, type AISuggestionStatus, type AcceptAutocompleteResult, type AnonymizationMatch, type AnonymizationTerm, type ApplyFolioDocumentOperationsOptions, type ApplyResult, type AutocompleteSuggestionPluginOptions, type AutocompleteSuggestionState, type AutocompleteSuggestionStatus, type AutocompleteTriggerCheck, type AutocompleteTriggerOptions, type AutocompleteTriggerSkipReason, type CreateEmptyDocumentOptions, DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, type DeriveBlockIdInput, type DirectiveKind, type DirectiveRange, type Document, type DocxCompatibility, type EmbeddedFont, type EmbeddedFontParts, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIComment, type FolioAIEditAppliedOperation, type FolioAIEditApplyMode, type FolioAIEditApplyResult, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditReviewMeta, type FolioAIEditSeverity, type FolioAIEditSkipReason, type FolioAIEditSkippedOperation, type FolioAIEditSnapshot, type FolioAISignatureParty, type FolioBlockId, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationStatus, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type ImageMeta, type ImageRef, InvalidFolioDocumentOperationBatchError, type MarkdownOptions, type MarkdownResult, type PositionalText, type ResolvedAnchor, type TemplatePreviewSpan, type TemplatePreviewValue, type TemplatePreviewValues, type TemplateSlashMenuKeyAction, type TemplateSlashMenuState, UnsupportedFolioDocumentOperationVersionError, type WordDiffSegment, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applyFolioDocumentOperations, applySuggestions, assertSupportedFolioDocumentOperationVersion, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, deriveBlockId, diffWordSegments, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, isFolioBlockId, isFolioDocumentOperationModeSupported, isSequentialFolioBlockId, isSuggestionStale, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };

package/dist/controller/layoutPipeline.js

@@ -1,6 +1,8 @@
 import "../layout-engine/types.js";
 import { renderPages } from "../layout-painter/renderPage.js";
 import { templatePreviewValuesKey } from "../prosemirror/plugins/templatePreviewValues.js";
+import { getMargins, getPageSize, twipsToPixels } from "../paged-layout/sectionGeometry.js";
+import { getColumns } from "../layout-bridge/sectionColumns.js";
 import { toFlowBlocks } from "../layout-bridge/convert/toFlowBlocks.js";
 import { recordLayoutComplete, recordLayoutError, recordLayoutPhase, recordLayoutStart } from "../layout-engine/layoutInstrumentation.js";
 import { buildBookmarkPageMap } from "../fields/bookmarkPages.js";
@@ -15,7 +17,6 @@ import { layoutDocument } from "../layout-engine/index.js";
 import { measureBlocks, measureSingleBlockWithoutFloatingZones } from "../layout-engine/measure/measureBlocks.js";
 import { tryBuildIncrementalMeasures } from "../paged-layout/incrementalMeasure.js";
 import { computePerBlockMeasureInputs } from "../paged-layout/sectionBlockWidths.js";
-import { getMargins, getPageSize, twipsToPixels } from "../paged-layout/sectionGeometry.js";
 import { getDocumentWatermark } from "../watermark/index.js";
 //#region src/controller/layoutPipeline.ts
 function runLayoutPipeline(deps, state, options = {}) {
@@ -98,10 +99,17 @@ function runLayoutPipeline(deps, state, options = {}) {
 			margins
 		};
 		if (columns !== void 0) bodyLayoutConfig.columns = columns;
+		const finalSectionProperties = document?.package.document.sections?.at(-1)?.properties;
+		const finalLayoutConfig = finalSectionProperties ? {
+			pageSize: getPageSize(finalSectionProperties),
+			margins: getMargins(finalSectionProperties)
+		} : bodyLayoutConfig;
+		const finalColumns = getColumns(finalSectionProperties);
+		if (finalColumns !== void 0) finalLayoutConfig.columns = finalColumns;
 		const blockMeasureInputs = computePerBlockMeasureInputs({
 			blocks: newBlocks,
 			bodyConfig: bodyLayoutConfig,
-			finalConfig: bodyLayoutConfig
+			finalConfig: finalLayoutConfig
 		});
 		const blockWidths = blockMeasureInputs.widths;
 		const previousArtifacts = session.artifacts;
@@ -144,10 +152,13 @@ function runLayoutPipeline(deps, state, options = {}) {
 					top: headerBottom
 				};
 			}
-			const finalSection = document?.package.document.sections?.at(-1);
-			if (finalSection) {
-				nextLayoutOpts.finalPageSize = getPageSize(finalSection.properties);
-				nextLayoutOpts.finalMargins = getMargins(finalSection.properties);
+			if (finalSectionProperties) {
+				nextLayoutOpts.finalPageSize = finalLayoutConfig.pageSize;
+				nextLayoutOpts.finalMargins = finalLayoutConfig.margins;
+				nextLayoutOpts.finalColumns = finalLayoutConfig.columns ?? {
+					count: 1,
+					gap: 0
+				};
 			}
 			if (columns !== void 0) nextLayoutOpts.columns = columns;
 			if (bodyBreakType !== void 0) nextLayoutOpts.bodyBreakType = bodyBreakType;

package/dist/document-operations.d.ts

@@ -93,13 +93,28 @@ type FolioDocumentOperationReceipt = {
   operationIndex: number;
   affected: FolioDocumentOperationAffectedTarget[];
 };
+/** Opaque handle for undoing one committed document-operation batch. */
+type FolioDocumentOperationUndoHandle = {
+  type: "documentOperationUndo";
+  id: string;
+};
+type FolioDocumentOperationUndoFailureReason = "unknownHandle" | "notLatest" | "documentChanged";
+type FolioDocumentOperationUndoResult = {
+  status: "undone";
+  undoHandle: FolioDocumentOperationUndoHandle;
+} | {
+  status: "rejected";
+  undoHandle: FolioDocumentOperationUndoHandle;
+  reason: FolioDocumentOperationUndoFailureReason;
+};
 type FolioDocumentOperationResult = {
   version: typeof FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION;
   status: FolioDocumentOperationStatus;
   applied: FolioAIEditAppliedOperation[];
   skipped: FolioAIEditSkippedOperation[];
   issues: FolioDocumentOperationIssue[]; /** Successful effects in input-operation order; skipped operations are omitted. */
-  receipts: FolioDocumentOperationReceipt[];
+  receipts: FolioDocumentOperationReceipt[]; /** Present when the execution surface can undo this committed batch. */
+  undoHandle: FolioDocumentOperationUndoHandle | null;
 };
 declare const getFolioDocumentOperationIssues: (operations: readonly FolioDocumentOperation[], skipped: readonly FolioAIEditSkippedOperation[]) => FolioDocumentOperationIssue[];
 /** Build deterministic affected-target receipts from operations and their applied entries. */
@@ -110,13 +125,15 @@ type ApplyFolioDocumentOperationsOptions = {
   batch: FolioDocumentOperationBatch;
   author?: string;
   createCommentId?: (text: string) => number;
+  createUndoHandle?: () => FolioDocumentOperationUndoHandle;
 };
 declare const applyFolioDocumentOperations: ({
   view,
   snapshot,
   batch,
   author,
-  createCommentId
+  createCommentId,
+  createUndoHandle
 }: ApplyFolioDocumentOperationsOptions) => FolioDocumentOperationResult;
 //#endregion
-export { 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, FolioDocumentOperationType, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch };
+export { 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, FolioDocumentOperationType, FolioDocumentOperationUndoFailureReason, FolioDocumentOperationUndoHandle, FolioDocumentOperationUndoResult, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch };

package/dist/document-operations.js

@@ -515,7 +515,7 @@ const getFolioDocumentOperationReceipts = (operations, applied) => {
 	});
 	return receipts;
 };
-const applyFolioDocumentOperations = ({ view, snapshot, batch, author, createCommentId }) => {
+const applyFolioDocumentOperations = ({ view, snapshot, batch, author, createCommentId, createUndoHandle }) => {
 	const parsedBatch = parseFolioDocumentOperationBatch(batch);
 	const apply = ({ targetView, targetCreateCommentId = createCommentId, preview = false }) => {
 		return (preview ? previewFolioAIEditOperations : applyFolioAIEditOperations)({
@@ -543,7 +543,8 @@ const applyFolioDocumentOperations = ({ view, snapshot, batch, author, createCom
 			applied: [],
 			skipped,
 			issues: getFolioDocumentOperationIssues(parsedBatch.operations, skipped),
-			receipts: []
+			receipts: [],
+			undoHandle: null
 		};
 	};
 	if (parsedBatch.dryRun === true) {
@@ -555,7 +556,8 @@ const applyFolioDocumentOperations = ({ view, snapshot, batch, author, createCom
 			applied: previewResult.applied.map(({ id }) => ({ id })),
 			skipped: previewResult.skipped,
 			issues: getFolioDocumentOperationIssues(parsedBatch.operations, previewResult.skipped),
-			receipts: getFolioDocumentOperationReceipts(parsedBatch.operations, previewResult.applied)
+			receipts: getFolioDocumentOperationReceipts(parsedBatch.operations, previewResult.applied),
+			undoHandle: null
 		};
 	}
 	if (parsedBatch.atomic === true) {
@@ -568,7 +570,8 @@ const applyFolioDocumentOperations = ({ view, snapshot, batch, author, createCom
 		status: "committed",
 		...result,
 		issues: getFolioDocumentOperationIssues(parsedBatch.operations, result.skipped),
-		receipts: getFolioDocumentOperationReceipts(parsedBatch.operations, result.applied)
+		receipts: getFolioDocumentOperationReceipts(parsedBatch.operations, result.applied),
+		undoHandle: result.applied.length > 0 && createUndoHandle !== void 0 ? createUndoHandle() : null
 	};
 };
 //#endregion

package/dist/docx/blockContentParser.js

@@ -1,9 +1,9 @@
-import { elementToXml, findChild, findDeep, getChildElements, getLocalName, mergeXmlnsDeclarations } from "./xmlParser.js";
+import { elementToXml, findChild, getChildElements, getLocalName, mergeXmlnsDeclarations } from "./xmlParser.js";
 import { parseBookmarkEnd, parseBookmarkStart } from "./bookmarkParser.js";
-import { getTextBoxContentElement, isTextBoxDrawing, parseTextBox, parseTextBoxContent } from "./textBoxParser.js";
 import { parseSdtProperties } from "./sdtProperties.js";
 import { parseParagraph } from "./paragraphParser.js";
 import { appendBookmarkMarkerToLastParagraphInBlocks, prependBookmarkMarkersToFirstParagraphInBlocks } from "./bookmarkPlacement.js";
+import { enrichParagraphTextBoxes } from "./paragraphTextBoxEnrichment.js";
 import { parseTable } from "./tableParser.js";
 import { padDecimal } from "./numberingParser.js";
 import { convertBulletToUnicode } from "./bulletMarkers.js";
@@ -100,104 +100,6 @@ const computeListMarker = (paragraph, numbering, listCounters, abstractCounters)
 	}
 	listRendering.marker = computedMarker;
 };
-const enrichParagraphTextBoxes = (paragraph, paraXml, styles, theme, numbering, rels, media) => {
-	const xmlChildren = getChildElements(paraXml);
-	let parsedIndex = 0;
-	let lastConsumedRun;
-	for (const xmlChild of xmlChildren) {
-		if (getLocalName(xmlChild.name ?? "") !== "r") {
-			if (parsedIndex < paragraph.content.length && paragraph.content[parsedIndex]?.type !== "run") parsedIndex += 1;
-			continue;
-		}
-		const { textBoxDrawings, hasNonTextBoxContent } = scanRunForTextBoxDrawings(xmlChild);
-		const parsedContent = paragraph.content[parsedIndex];
-		const parsedRun = parsedContent?.type === "run" ? parsedContent : void 0;
-		const targetRun = parsedRun ?? (hasNonTextBoxContent ? lastConsumedRun : void 0);
-		for (const runEl of textBoxDrawings) {
-			const textBox = parseTextBox(runEl);
-			if (!textBox) continue;
-			const wsp = findDeep(runEl, "wps", "wsp");
-			if (wsp) {
-				const txbxContentEl = getTextBoxContentElement(wsp);
-				if (txbxContentEl) textBox.content = parseTextBoxContent(txbxContentEl, parseParagraph, null, styles, theme, numbering, rels ?? void 0, media ?? void 0);
-			}
-			const shape = {
-				type: "shape",
-				shapeType: "textBox",
-				size: textBox.size,
-				...textBox.position !== void 0 ? { position: textBox.position } : {},
-				...textBox.wrap !== void 0 ? { wrap: textBox.wrap } : {},
-				...textBox.fill !== void 0 ? { fill: textBox.fill } : {},
-				...textBox.outline !== void 0 ? { outline: textBox.outline } : {},
-				textBody: {
-					content: textBox.content,
-					...textBox.margins !== void 0 ? { margins: textBox.margins } : {}
-				}
-			};
-			if (textBox.id) shape.id = textBox.id;
-			const shapeContent = {
-				type: "shape",
-				shape
-			};
-			if (targetRun && hasNonTextBoxContent) targetRun.content.push(shapeContent);
-			else {
-				const newRun = {
-					type: "run",
-					content: [shapeContent]
-				};
-				paragraph.content.splice(parsedIndex, 0, newRun);
-				lastConsumedRun = newRun;
-				parsedIndex += 1;
-			}
-		}
-		if (hasNonTextBoxContent && parsedRun) {
-			lastConsumedRun = parsedRun;
-			parsedIndex += 1;
-		}
-	}
-};
-const scanRunForTextBoxDrawings = (xmlRun) => {
-	const textBoxDrawings = [];
-	let hasNonTextBoxContent = false;
-	const visitDrawing = (drawingEl) => {
-		if (isTextBoxDrawing(drawingEl)) {
-			textBoxDrawings.push(drawingEl);
-			return;
-		}
-		hasNonTextBoxContent = true;
-	};
-	for (const el of getChildElements(xmlRun)) {
-		const name = getLocalName(el.name ?? "");
-		if (name === "rPr") continue;
-		if (name === "drawing") {
-			visitDrawing(el);
-			continue;
-		}
-		if (name === "AlternateContent") {
-			const branches = getChildElements(el);
-			const choice = branches.find((branch) => getLocalName(branch.name ?? "") === "Choice");
-			const fallback = branches.find((branch) => getLocalName(branch.name ?? "") === "Fallback");
-			const tryBranch = (branch) => {
-				if (!branch) return false;
-				let found = false;
-				for (const innerEl of getChildElements(branch)) if (getLocalName(innerEl.name ?? "") === "drawing") {
-					visitDrawing(innerEl);
-					found = true;
-				}
-				return found;
-			};
-			let foundInBranch = tryBranch(choice);
-			if (!foundInBranch) foundInBranch = tryBranch(fallback);
-			if (!foundInBranch) hasNonTextBoxContent = true;
-			continue;
-		}
-		hasNonTextBoxContent = true;
-	}
-	return {
-		textBoxDrawings,
-		hasNonTextBoxContent
-	};
-};
 const parseBlockContent = (parent, styles, theme, numbering, rels, media, options) => parseBlockContentWithState(parent, styles, theme, numbering, rels, media, {
 	listCounters: /* @__PURE__ */ new Map(),
 	abstractCounters: /* @__PURE__ */ new Map(),

package/dist/docx/paragraphTextBoxEnrichment.d.ts

@@ -0,0 +1,9 @@
+import { document_d_exports } from "../types/document.js";
+import { NumberingMap } from "./numberingParser.js";
+import { StyleMap } from "./styleParser.js";
+import { XmlElement } from "./xmlParser.js";
+
+//#region src/docx/paragraphTextBoxEnrichment.d.ts
+declare const enrichParagraphTextBoxes: (paragraph: document_d_exports.Paragraph, paraXml: XmlElement, styles: StyleMap | null, theme: document_d_exports.Theme | null, numbering: NumberingMap | null, rels: document_d_exports.RelationshipMap | null, media: Map<string, document_d_exports.MediaFile> | null) => void;
+//#endregion
+export { enrichParagraphTextBoxes };

package/dist/docx/paragraphTextBoxEnrichment.js

@@ -0,0 +1,104 @@
+import { findDeep, getChildElements, getLocalName } from "./xmlParser.js";
+import { getTextBoxContentElement, isTextBoxDrawing, parseTextBox, parseTextBoxContent } from "./textBoxParser.js";
+import { parseParagraph } from "./paragraphParser.js";
+//#region src/docx/paragraphTextBoxEnrichment.ts
+const enrichParagraphTextBoxes = (paragraph, paraXml, styles, theme, numbering, rels, media) => {
+	const xmlChildren = getChildElements(paraXml);
+	let parsedIndex = 0;
+	let lastConsumedRun;
+	for (const xmlChild of xmlChildren) {
+		if (getLocalName(xmlChild.name ?? "") !== "r") {
+			if (parsedIndex < paragraph.content.length && paragraph.content[parsedIndex]?.type !== "run") parsedIndex += 1;
+			continue;
+		}
+		const { textBoxDrawings, hasNonTextBoxContent } = scanRunForTextBoxDrawings(xmlChild);
+		const parsedContent = paragraph.content[parsedIndex];
+		const parsedRun = parsedContent?.type === "run" ? parsedContent : void 0;
+		const targetRun = parsedRun ?? (hasNonTextBoxContent ? lastConsumedRun : void 0);
+		for (const runEl of textBoxDrawings) {
+			const textBox = parseTextBox(runEl);
+			if (!textBox) continue;
+			const wsp = findDeep(runEl, "wps", "wsp");
+			if (wsp) {
+				const txbxContentEl = getTextBoxContentElement(wsp);
+				if (txbxContentEl) textBox.content = parseTextBoxContent(txbxContentEl, parseParagraph, null, styles, theme, numbering, rels ?? void 0, media ?? void 0);
+			}
+			const shape = {
+				type: "shape",
+				shapeType: "textBox",
+				size: textBox.size,
+				...textBox.position !== void 0 ? { position: textBox.position } : {},
+				...textBox.wrap !== void 0 ? { wrap: textBox.wrap } : {},
+				...textBox.fill !== void 0 ? { fill: textBox.fill } : {},
+				...textBox.outline !== void 0 ? { outline: textBox.outline } : {},
+				textBody: {
+					content: textBox.content,
+					...textBox.margins !== void 0 ? { margins: textBox.margins } : {}
+				}
+			};
+			if (textBox.id) shape.id = textBox.id;
+			const shapeContent = {
+				type: "shape",
+				shape
+			};
+			if (targetRun && hasNonTextBoxContent) targetRun.content.push(shapeContent);
+			else {
+				const newRun = {
+					type: "run",
+					content: [shapeContent]
+				};
+				paragraph.content.splice(parsedIndex, 0, newRun);
+				lastConsumedRun = newRun;
+				parsedIndex += 1;
+			}
+		}
+		if (hasNonTextBoxContent && parsedRun) {
+			lastConsumedRun = parsedRun;
+			parsedIndex += 1;
+		}
+	}
+};
+const scanRunForTextBoxDrawings = (xmlRun) => {
+	const textBoxDrawings = [];
+	let hasNonTextBoxContent = false;
+	const visitDrawing = (drawingEl) => {
+		if (isTextBoxDrawing(drawingEl)) {
+			textBoxDrawings.push(drawingEl);
+			return;
+		}
+		hasNonTextBoxContent = true;
+	};
+	for (const el of getChildElements(xmlRun)) {
+		const name = getLocalName(el.name ?? "");
+		if (name === "rPr") continue;
+		if (name === "drawing") {
+			visitDrawing(el);
+			continue;
+		}
+		if (name === "AlternateContent") {
+			const branches = getChildElements(el);
+			const choice = branches.find((branch) => getLocalName(branch.name ?? "") === "Choice");
+			const fallback = branches.find((branch) => getLocalName(branch.name ?? "") === "Fallback");
+			const tryBranch = (branch) => {
+				if (!branch) return false;
+				let found = false;
+				for (const innerEl of getChildElements(branch)) if (getLocalName(innerEl.name ?? "") === "drawing") {
+					visitDrawing(innerEl);
+					found = true;
+				}
+				return found;
+			};
+			let foundInBranch = tryBranch(choice);
+			if (!foundInBranch) foundInBranch = tryBranch(fallback);
+			if (!foundInBranch) hasNonTextBoxContent = true;
+			continue;
+		}
+		hasNonTextBoxContent = true;
+	}
+	return {
+		textBoxDrawings,
+		hasNonTextBoxContent
+	};
+};
+//#endregion
+export { enrichParagraphTextBoxes };

package/dist/docx/tableParser.js

@@ -3,6 +3,7 @@ import { parseBookmarkEnd, parseBookmarkStart } from "./bookmarkParser.js";
 import { BorderStyleSchema, FloatingTableXSpecSchema, FloatingTableYSpecSchema, ShadingPatternSchema, TableCellTextDirectionSchema, ThemeColorSlotSchema, narrowEnum } from "./parserEnums.js";
 import { parseParagraph } from "./paragraphParser.js";
 import { appendBookmarkMarkerToLastParagraphInBlocks, appendBookmarkMarkerToLastParagraphInCells, prependBookmarkMarkersToFirstParagraphInBlocks, prependBookmarkMarkersToFirstParagraphInCell } from "./bookmarkPlacement.js";
+import { enrichParagraphTextBoxes } from "./paragraphTextBoxEnrichment.js";
 //#region src/docx/tableParser.ts
 /**
 * Parse a table measurement (width, height, etc.)
@@ -489,6 +490,7 @@ function parseCellContent(tcElement, styles, theme, numbering, rels, media, opti
 		const localName = getLocalName(child.name);
 		if (localName === "p") {
 			const para = parseParagraph(child, styles, theme, numbering, rels, media, options);
+			enrichParagraphTextBoxes(para, child, styles, theme, numbering, rels, media);
 			prependPendingBookmarkMarkers(para, pendingBookmarkMarkers);
 			content.push(para);
 		} else if (localName === "tbl") {