@stll/folio-core 0.4.0 → 0.5.0

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

@@ -45,6 +45,27 @@ type FolioAIEditReviewMeta = {
   severity?: FolioAIEditSeverity;
   area?: string;
 };
+type FolioAIEditPrecondition = {
+  blockTextHash: string;
+};
+/**
+ * A serializable range over the visible, post-tracked-changes text of one
+ * block. Offsets are zero-based UTF-16 boundaries, matching JavaScript string
+ * slicing; `selectedTextHash` makes a shifted or changed selection fail stale.
+ */
+type FolioAITextRangeHandle = {
+  type: "textRange";
+  story: "main";
+  blockId: string;
+  startOffset: number;
+  endOffset: number;
+  selectedTextHash: string;
+};
+type FolioAIInlineFormatting = {
+  bold?: boolean;
+  italic?: boolean;
+  underline?: boolean;
+};
 /**
  * A party in an `insertSignatureTable` op. Mirrors the
  * `signatureTable` helper in `docx-core/legal-source/compile.ts`:
@@ -56,13 +77,31 @@ type FolioAISignatureParty = {
   signatory?: string;
   title?: string;
 };
-type FolioAIEditOperation = FolioAIEditReviewMeta & ({
+type FolioAIEditOperation = FolioAIEditReviewMeta & {
+  precondition?: FolioAIEditPrecondition;
+} & ({
   id: string;
   type: "replaceInBlock";
   blockId: string;
   find: string;
   replace: string;
   comment?: FolioAIComment;
+} | {
+  id: string;
+  type: "replaceRange";
+  range: FolioAITextRangeHandle;
+  replace: string;
+  comment?: FolioAIComment;
+} | {
+  id: string;
+  type: "commentOnRange";
+  range: FolioAITextRangeHandle;
+  comment: FolioAIComment;
+} | {
+  id: string;
+  type: "formatRange";
+  range: FolioAITextRangeHandle;
+  formatting: FolioAIInlineFormatting;
 } | {
   id: string;
   type: "insertAfterBlock" | "insertBeforeBlock";
@@ -116,7 +155,7 @@ type FolioAIEditOperation = FolioAIEditReviewMeta & ({
   comment?: FolioAIComment;
 });
 type FolioAIEditApplyMode = "direct" | "tracked-changes";
-type FolioAIEditSkipReason = "missingBlock" | "changedBlock" | "ambiguousFind" | "missingFind" | "unsupportedBlock" | "emptyOperation"
+type FolioAIEditSkipReason = "missingBlock" | "changedBlock" | "ambiguousFind" | "missingFind" | "unsupportedBlock" | "unsupportedMode" | "atomicBatchRejected" | "preconditionFailed" | "staleRange" | "emptyOperation"
 /**
  * The operation would not change the document — find equals
  * replace, or replaceBlock's `text` matches the live block.
@@ -153,4 +192,4 @@ type FolioAIEditApplyResult = {
   skipped: FolioAIEditSkippedOperation[];
 };
 //#endregion
-export { FolioAIBlock, FolioAIBlockAnchor, FolioAIBlockKind, FolioAIBlockPreviewRun, FolioAIComment, FolioAIEditAppliedOperation, FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditOperation, FolioAIEditReviewMeta, FolioAIEditSeverity, FolioAIEditSkipReason, FolioAIEditSkippedOperation, FolioAIEditSnapshot, FolioAISignatureParty };
+export { FolioAIBlock, FolioAIBlockAnchor, FolioAIBlockKind, FolioAIBlockPreviewRun, FolioAIComment, FolioAIEditAppliedOperation, FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditOperation, FolioAIEditPrecondition, FolioAIEditReviewMeta, FolioAIEditSeverity, FolioAIEditSkipReason, FolioAIEditSkippedOperation, FolioAIEditSnapshot, FolioAIInlineFormatting, FolioAISignatureParty, FolioAITextRangeHandle };

package/dist/compat/eigenpal.d.ts

@@ -1,6 +1,7 @@
-import { FolioAIBlock, FolioAIBlockAnchor, FolioAIBlockKind, FolioAIBlockPreviewRun, FolioAIComment, FolioAIEditAppliedOperation, FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditOperation, FolioAIEditReviewMeta, FolioAIEditSeverity, FolioAIEditSkipReason, FolioAIEditSkippedOperation, FolioAIEditSnapshot, FolioAISignatureParty } from "../ai-edits/types.js";
+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 { 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";
@@ -26,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 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, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIComment, type FolioAIEditAppliedOperation, type FolioAIEditApplyMode, type FolioAIEditApplyResult, type FolioAIEditOperation, type FolioAIEditReviewMeta, type FolioAIEditSeverity, type FolioAIEditSkipReason, type FolioAIEditSkippedOperation, type FolioAIEditSnapshot, type FolioAISignatureParty, type FolioBlockId, type ImageMeta, type ImageRef, type MarkdownOptions, type MarkdownResult, type PositionalText, type ResolvedAnchor, type TemplatePreviewSpan, type TemplatePreviewValue, type TemplatePreviewValues, type TemplateSlashMenuKeyAction, type TemplateSlashMenuState, type WordDiffSegment, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applySuggestions, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, deriveBlockId, diffWordSegments, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, isFolioBlockId, isSequentialFolioBlockId, isSuggestionStale, normalizeFolioAIBlockText, 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 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/compat/eigenpal.js

@@ -1,13 +1,14 @@
+import { deriveBlockId, getFolioParaIdFromBlockId, isFolioBlockId, isSequentialFolioBlockId } from "../types/block-id.js";
+import { createFolioAIEditSnapshot, hashFolioAIBlockText, normalizeFolioAIBlockText } from "../ai-edits/snapshot.js";
+import { diffWordSegments } from "../ai-edits/word-diff.js";
+import { applyFolioAIEditOperations } from "../ai-edits/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 { createEmptyDocument } from "../utils/createDocument.js";
 import { createDocx } from "../docx/rezip.js";
-import { deriveBlockId, getFolioParaIdFromBlockId, isFolioBlockId, isSequentialFolioBlockId } from "../types/block-id.js";
 import { DEFAULT_AI_SUGGESTION_PRESETS } from "../ai-suggestions/types.js";
 import { buildPositionalText } from "../ai-suggestions/text-positions.js";
 import { isSuggestionStale, resolveSuggestionAnchor } from "../ai-suggestions/conflict.js";
 import { applySuggestions } from "../ai-suggestions/apply.js";
-import { createFolioAIEditSnapshot, hashFolioAIBlockText, normalizeFolioAIBlockText } from "../ai-edits/snapshot.js";
-import { diffWordSegments } from "../ai-edits/word-diff.js";
-import { applyFolioAIEditOperations } from "../ai-edits/apply.js";
 import { setAISuggestionsMeta, setFocusedSuggestionMeta } from "../prosemirror/plugins/aiSuggestionDecorations.js";
 import { getGoogleFontsEnabled, setGoogleFontsEnabled } from "../utils/fontResolver.js";
 import { scrollFolioPositionIntoView } from "../paged-layout/scrollToPmPosition.js";
@@ -21,4 +22,4 @@ import { DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, acceptAutocompleteSuggestion, acc
 import { fromMarkdown } from "../markdown/fromMarkdown.js";
 import { toMarkdown, toMarkdownResult } from "../markdown/index.js";
 import { extractEmbeddedFonts, getEmbeddedFontFaces } from "../fonts/embeddedFonts.js";
-export { DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, acceptAutocompleteSuggestion, acceptAutocompleteWord, anonymizationDecorationsKey, appendAutocompleteToken, applyFolioAIEditOperations, applySuggestions, autocompleteSuggestionKey, autocompleteSuggestionPlugin, buildPositionalText, clearAutocompleteSuggestion, clearTemplateSlashMenu, consumeTemplateSlashQuery, createAICitationDecorationsPlugin, createDocx, createEmptyDocument, createFolioAIEditSnapshot, deriveBlockId, diffWordSegments, extractEmbeddedFonts, finishAutocompleteSuggestion, fromMarkdown, getAnonymizationMatches, getAutocompleteSuggestion, getEmbeddedFontFaces, getFolioCaretViewportRect, getFolioParaIdFromBlockId, getFolioSelectionViewportRect, getGoogleFontsEnabled, getTemplateDirectives, getTemplateSlashMenu, hashFolioAIBlockText, isFolioBlockId, isSequentialFolioBlockId, isSuggestionStale, normalizeFolioAIBlockText, resetTemplateSlashQuery, resolveSuggestionAnchor, scanDirectives, scrollFolioPositionIntoView, setAICitationsMeta, setAISuggestionsMeta, setActiveCitationMeta, setAnonymizationTermsMeta, setFocusedSuggestionMeta, setGoogleFontsEnabled, setTemplatePreviewValues, shouldTriggerAutocomplete, startAutocompleteSuggestion, templateSlashMenuKey, toMarkdown, toMarkdownResult };
+export { DEFAULT_AI_SUGGESTION_PRESETS, DEFAULT_AUTOCOMPLETE_DEAD_ZONE_NODES, 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, 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.d.ts

@@ -45,6 +45,7 @@ type LayoutPipelineDeps<THfPMs> = {
   sectionProperties: document_d_exports.SectionProperties | null | undefined;
   document: document_d_exports.Document | null;
   defaultTabStop: number | undefined;
+  mirrorMargins: boolean;
   styles: document_d_exports.StyleDefinitions | null | undefined;
   layout: Layout | null;
   hfPMs: THfPMs;

package/dist/controller/layoutPipeline.js

@@ -2,32 +2,24 @@ import "../layout-engine/types.js";
 import { renderPages } from "../layout-painter/renderPage.js";
 import { templatePreviewValuesKey } from "../prosemirror/plugins/templatePreviewValues.js";
 import { toFlowBlocks } from "../layout-bridge/convert/toFlowBlocks.js";
-import { recordLayoutComplete, recordLayoutError, recordLayoutPhase } from "../layout-engine/layoutInstrumentation.js";
+import { recordLayoutComplete, recordLayoutError, recordLayoutPhase, recordLayoutStart } from "../layout-engine/layoutInstrumentation.js";
 import { buildBookmarkPageMap } from "../fields/bookmarkPages.js";
 import { buildBookmarkText } from "../fields/bookmarkText.js";
 import { buildHeaderFooterFieldValues, fieldValuesEqual, resolveFieldValues } from "../fields/resolveFieldValues.js";
 import { buildSectionPageCounts } from "../fields/sectionPageCounts.js";
 import { buildSeqValues } from "../fields/seqValues.js";
 import { installCanvasMeasureProvider } from "../layout-engine/measure/measureContainer.js";
-import { buildFootnoteContentMap, collectFootnoteRefs } from "../layout-bridge/convert/footnoteLayout.js";
+import { buildFootnoteContentMap, collectEndnoteRefs, collectFootnoteRefs, computeNoteDisplayNumbers, remapNoteMarkerText } from "../layout-bridge/convert/footnoteLayout.js";
 import { applyTemplatePreviewToBlocks } from "../layout-bridge/convert/templatePreviewFlow.js";
 import { layoutDocument } from "../layout-engine/index.js";
 import { measureBlocks, measureSingleBlockWithoutFloatingZones } from "../layout-engine/measure/measureBlocks.js";
-import { computeFirstPageHeaderFooterMarginExtender, computeHeaderFooterMarginExtender, extendSectionBreakMargins } from "../paged-layout/headerFooterMargins.js";
 import { tryBuildIncrementalMeasures } from "../paged-layout/incrementalMeasure.js";
 import { computePerBlockMeasureInputs } from "../paged-layout/sectionBlockWidths.js";
-import { twipsToPixels } from "../paged-layout/sectionGeometry.js";
+import { getMargins, getPageSize, twipsToPixels } from "../paged-layout/sectionGeometry.js";
 import { getDocumentWatermark } from "../watermark/index.js";
 //#region src/controller/layoutPipeline.ts
-function pageMarginsEqual(left, right) {
-	return left.top === right.top && left.right === right.right && left.bottom === right.bottom && left.left === right.left && left.header === right.header && left.footer === right.footer;
-}
-function optionalPageMarginsEqual(left, right) {
-	if (left === void 0 || right === void 0) return left === right;
-	return pageMarginsEqual(left, right);
-}
 function runLayoutPipeline(deps, state, options = {}) {
-	const { contentWidth, columns, pageSize, margins, pageGap, syncCoordinator, headerContent, footerContent, firstPageHeaderContent, firstPageFooterContent, headerContentRId, footerContentRId, firstPageHeaderContentRId, firstPageFooterContentRId, sectionHeaderFooterRefs, theme: _theme, sectionProperties, document, defaultTabStop, styles, layout, hfPMs, painter, pagesContainer, session, renderHfFromContentOrPm, renderHeaderFooterContentByRId, documentFontsAreLoaded, buildFootnoteRenderItems, describeInvalidHighlightMarks, emptyTemplatePreviewEntries: EMPTY_TEMPLATE_PREVIEW_ENTRIES } = deps;
+	const { contentWidth, columns, pageSize, margins, pageGap, syncCoordinator, headerContent, footerContent, firstPageHeaderContent, firstPageFooterContent, headerContentRId, footerContentRId, firstPageHeaderContentRId, firstPageFooterContentRId, sectionHeaderFooterRefs, theme: _theme, sectionProperties, document, defaultTabStop, mirrorMargins, styles, layout, hfPMs, painter, pagesContainer, session, renderHfFromContentOrPm, renderHeaderFooterContentByRId, documentFontsAreLoaded, buildFootnoteRenderItems, describeInvalidHighlightMarks, emptyTemplatePreviewEntries: EMPTY_TEMPLATE_PREVIEW_ENTRIES } = deps;
 	let outcome = {};
 	let pendingArtifacts;
 	let pendingTemplatePreview;
@@ -37,6 +29,7 @@ function runLayoutPipeline(deps, state, options = {}) {
 		recordLayoutPhase(reason, phase, performance.now() - startedAt);
 	};
 	const currentEpoch = syncCoordinator.getStateSeq();
+	recordLayoutStart(reason);
 	syncCoordinator.onLayoutStart();
 	try {
 		let phaseStartedAt = performance.now();
@@ -61,6 +54,14 @@ function runLayoutPipeline(deps, state, options = {}) {
 		const footnoteRefs = collectFootnoteRefs(newBlocks);
 		const documentFootnotes = document?.package.footnotes;
 		const hasFootnotes = footnoteRefs.length > 0 && documentFootnotes !== void 0;
+		const footnoteDisplayNumbers = documentFootnotes ? computeNoteDisplayNumbers(documentFootnotes, footnoteRefs.map((ref) => ref.footnoteId)) : void 0;
+		const documentEndnotes = document?.package.endnotes;
+		const endnoteDisplayNumbers = documentEndnotes ? computeNoteDisplayNumbers(documentEndnotes, collectEndnoteRefs(newBlocks).map((ref) => ref.endnoteId)) : void 0;
+		newBlocks = remapNoteMarkerText(newBlocks, {
+			...footnoteDisplayNumbers ? { footnoteNumbers: footnoteDisplayNumbers } : {},
+			...endnoteDisplayNumbers ? { endnoteNumbers: endnoteDisplayNumbers } : {}
+		});
+		outcome.blocks = newBlocks;
 		const hfMetricsHeader = {
 			section: "header",
 			pageSize,
@@ -90,73 +91,19 @@ function runLayoutPipeline(deps, state, options = {}) {
 		let firstPageFooterForRender = hasTitlePg ? renderHfFromContentOrPm(firstPageFooterContent, firstPageFooterContentRId, hfPMs, contentWidth, hfMetricsFooter, hfOptions) : void 0;
 		let headerContentByRId = renderHeaderFooterContentByRId(document?.package.headers, hfPMs, contentWidth, hfMetricsHeader, hfOptions);
 		let footerContentByRId = renderHeaderFooterContentByRId(document?.package.footers, hfPMs, contentWidth, hfMetricsFooter, hfOptions);
-		const hfExtenderContent = {
-			headerContent: headerContentForRender,
-			footerContent: footerContentForRender,
-			firstPageHeaderContent: firstPageHeaderForRender,
-			firstPageFooterContent: firstPageFooterForRender
-		};
-		const buildSectionHfExtenderContent = () => {
-			if (!sectionHeaderFooterRefs) return;
-			return sectionHeaderFooterRefs.map((refs) => ({
-				headerContent: pickSectionHeaderFooterContent(headerContentByRId, refs.headerDefault, refs.evenAndOddHeaders === true ? refs.headerEven : void 0),
-				footerContent: pickSectionHeaderFooterContent(footerContentByRId, refs.footerDefault, refs.evenAndOddHeaders === true ? refs.footerEven : void 0),
-				firstPageHeaderContent: refs.titlePg === true ? headerContentByRId?.get(refs.headerFirst ?? "") : void 0,
-				firstPageFooterContent: refs.titlePg === true ? footerContentByRId?.get(refs.footerFirst ?? "") : void 0
-			}));
-		};
-		const hfWarn = (msg) => {
-			console.warn(`[PagedEditor] ${msg}`);
-		};
-		const extendForHfOverflow = computeHeaderFooterMarginExtender({
-			...hfExtenderContent,
-			pageSize,
-			warn: hfWarn
-		});
-		const extendForFirstPage = computeFirstPageHeaderFooterMarginExtender({
-			...hfExtenderContent,
-			pageSize,
-			warn: hfWarn
-		});
-		let effectiveMargins = extendForHfOverflow(margins);
-		let effectiveFirstPageMargins = hasTitlePg ? extendForFirstPage(margins) : void 0;
-		const sectionBreaks = newBlocks.filter((block) => block.kind === "sectionBreak");
-		const originalSectionBreakMargins = /* @__PURE__ */ new Map();
-		for (const sectionBreak of sectionBreaks) originalSectionBreakMargins.set(sectionBreak.id, sectionBreak.margins ? { ...sectionBreak.margins } : void 0);
-		const restoreSectionBreakMargins = () => {
-			for (const sectionBreak of sectionBreaks) {
-				const originalMargins = originalSectionBreakMargins.get(sectionBreak.id);
-				if (originalMargins === void 0) {
-					delete sectionBreak.margins;
-					continue;
-				}
-				sectionBreak.margins = { ...originalMargins };
-			}
-		};
-		const applySectionBreakMargins = (content, bodyMargins) => {
-			restoreSectionBreakMargins();
-			extendSectionBreakMargins(sectionBreaks, {
-				content,
-				sectionContent: buildSectionHfExtenderContent(),
-				bodyPageSize: pageSize,
-				bodyMargins,
-				warn: hfWarn
-			});
-		};
-		applySectionBreakMargins(hfExtenderContent, effectiveMargins);
 		recordPhaseDuration("header-footer", phaseStartedAt);
 		phaseStartedAt = performance.now();
-		let bodyLayoutConfig = {
+		const bodyLayoutConfig = {
 			pageSize,
-			margins: effectiveMargins
+			margins
 		};
 		if (columns !== void 0) bodyLayoutConfig.columns = columns;
-		let blockMeasureInputs = computePerBlockMeasureInputs({
+		const blockMeasureInputs = computePerBlockMeasureInputs({
 			blocks: newBlocks,
 			bodyConfig: bodyLayoutConfig,
 			finalConfig: bodyLayoutConfig
 		});
-		let blockWidths = blockMeasureInputs.widths;
+		const blockWidths = blockMeasureInputs.widths;
 		const previousArtifacts = session.artifacts;
 		const incrementalResult = options.dirtyRange && !options.forceFull && previousArtifacts ? tryBuildIncrementalMeasures({
 			previousBlocks: previousArtifacts.blocks,
@@ -183,19 +130,31 @@ function runLayoutPipeline(deps, state, options = {}) {
 		let pageFootnoteMap = /* @__PURE__ */ new Map();
 		let footnoteContentMap = /* @__PURE__ */ new Map();
 		const bodyBreakType = sectionProperties?.sectionStart;
-		const buildLayoutOpts = (nextMargins, nextFirstPageMargins) => {
+		const buildLayoutOpts = () => {
 			const nextLayoutOpts = {
 				pageSize,
-				margins: nextMargins,
-				pageGap
+				margins,
+				pageGap,
+				mirrorMargins
 			};
-			if (nextFirstPageMargins !== void 0) nextLayoutOpts.firstPageMargins = nextFirstPageMargins;
+			if (hasTitlePg && firstPageHeaderForRender) {
+				const headerBottom = (margins.header ?? 0) + (firstPageHeaderForRender.marginPushBottom ?? firstPageHeaderForRender.height);
+				if (headerBottom > margins.top) nextLayoutOpts.firstPageMargins = {
+					...margins,
+					top: headerBottom
+				};
+			}
+			const finalSection = document?.package.document.sections?.at(-1);
+			if (finalSection) {
+				nextLayoutOpts.finalPageSize = getPageSize(finalSection.properties);
+				nextLayoutOpts.finalMargins = getMargins(finalSection.properties);
+			}
 			if (columns !== void 0) nextLayoutOpts.columns = columns;
 			if (bodyBreakType !== void 0) nextLayoutOpts.bodyBreakType = bodyBreakType;
 			if (sectionHeaderFooterRefs !== void 0) nextLayoutOpts.sectionHeaderFooterRefs = sectionHeaderFooterRefs;
 			return nextLayoutOpts;
 		};
-		const layoutOpts = buildLayoutOpts(effectiveMargins, effectiveFirstPageMargins);
+		const layoutOpts = buildLayoutOpts();
 		let layoutOptsUsed = layoutOpts;
 		if (hasFootnotes) {
 			footnoteContentMap = buildFootnoteContentMap(documentFootnotes, footnoteRefs, contentWidth, (() => {
@@ -292,57 +251,8 @@ function runLayoutPipeline(deps, state, options = {}) {
 			firstPageFooterForRender = hasTitlePg ? renderHfFromContentOrPm(firstPageFooterContent, firstPageFooterContentRId, hfPMs, contentWidth, hfMetricsFooter, finalHfOptions) : void 0;
 			headerContentByRId = renderHeaderFooterContentByRId(document?.package.headers, hfPMs, contentWidth, hfMetricsHeader, finalHfOptions);
 			footerContentByRId = renderHeaderFooterContentByRId(document?.package.footers, hfPMs, contentWidth, hfMetricsFooter, finalHfOptions);
-			return {
-				headerContent: headerContentForRender,
-				footerContent: footerContentForRender,
-				firstPageHeaderContent: firstPageHeaderForRender,
-				firstPageFooterContent: firstPageFooterForRender
-			};
 		};
-		const MAX_HEADER_FOOTER_STABILIZATION_PASSES = 3;
-		for (let pass = 0; pass < MAX_HEADER_FOOTER_STABILIZATION_PASSES; pass++) {
-			const finalHfExtenderContent = rebuildHeaderFooterForLayout();
-			const finalEffectiveMargins = computeHeaderFooterMarginExtender({
-				...finalHfExtenderContent,
-				pageSize,
-				warn: hfWarn
-			})(margins);
-			const finalEffectiveFirstPageMargins = hasTitlePg ? computeFirstPageHeaderFooterMarginExtender({
-				...finalHfExtenderContent,
-				pageSize,
-				warn: hfWarn
-			})(margins) : void 0;
-			if (!pageMarginsEqual(effectiveMargins, finalEffectiveMargins) || !optionalPageMarginsEqual(effectiveFirstPageMargins, finalEffectiveFirstPageMargins)) {
-				effectiveMargins = finalEffectiveMargins;
-				effectiveFirstPageMargins = finalEffectiveFirstPageMargins;
-				applySectionBreakMargins(finalHfExtenderContent, effectiveMargins);
-				bodyLayoutConfig = {
-					pageSize,
-					margins: effectiveMargins
-				};
-				if (columns !== void 0) bodyLayoutConfig.columns = columns;
-				blockMeasureInputs = computePerBlockMeasureInputs({
-					blocks: newBlocks,
-					bodyConfig: bodyLayoutConfig,
-					finalConfig: bodyLayoutConfig
-				});
-				blockWidths = blockMeasureInputs.widths;
-				newMeasures = measureBlocks(newBlocks, blockWidths, blockMeasureInputs.marginTops, {
-					pageHeight: blockMeasureInputs.pageHeights,
-					marginBottom: blockMeasureInputs.marginBottoms
-				});
-				pendingArtifacts = {
-					blocks: newBlocks,
-					blockWidths,
-					measures: newMeasures
-				};
-				outcome.measures = newMeasures;
-				relayoutWithCurrentMeasures(buildLayoutOpts(effectiveMargins, effectiveFirstPageMargins));
-				stabilizeFieldWidths();
-				continue;
-			}
-			break;
-		}
+		rebuildHeaderFooterForLayout();
 		outcome.layout = newLayout;
 		recordPhaseDuration("layout-document", phaseStartedAt);
 		if (pagesContainer && painter) {
@@ -412,17 +322,5 @@ function runLayoutPipeline(deps, state, options = {}) {
 	syncCoordinator.onLayoutComplete(currentEpoch);
 	return outcome;
 }
-function pickSectionHeaderFooterContent(byRId, defaultRId, evenRId) {
-	const defaultContent = defaultRId ? byRId?.get(defaultRId) : void 0;
-	const evenContent = evenRId ? byRId?.get(evenRId) : void 0;
-	if (!defaultContent) return evenContent;
-	if (!evenContent) return defaultContent;
-	return headerFooterMarginPushHeight(evenContent) > headerFooterMarginPushHeight(defaultContent) ? evenContent : defaultContent;
-}
-function headerFooterMarginPushHeight(content) {
-	const bottom = content.marginPushBottom ?? content.visualBottom ?? content.height;
-	const top = content.marginPushTop ?? content.visualTop ?? 0;
-	return Math.max(bottom - top, content.height);
-}
 //#endregion
 export { runLayoutPipeline };

package/dist/controller/layoutScheduler.d.ts

@@ -18,7 +18,8 @@ type SchedulerClock = {
 declare const browserClock: SchedulerClock;
 type LayoutSchedulerConfig<TState> = {
   runLayout: RunLayout<TState>; /** Quiet-window debounce before an interactive layout pass. */
-  debounceMs: number; /** Hard cap on latency from the first edit in a burst. */
+  debounceMs: number; /** Run the first edit after a max-delay-sized idle period on the next frame. */
+  leadingFrame?: boolean; /** Hard cap on latency from the first edit in a burst. */
   maxDelayMs: number;
   /**
    * Timing source. Pass `browserClock` in the browser; a host injects its own

package/dist/controller/layoutScheduler.js

@@ -9,6 +9,7 @@ const browserClock = {
 };
 const createLayoutScheduler = (config) => {
 	const clock = config.clock;
+	let lastRunAt = null;
 	let pending = null;
 	const flushPending = () => {
 		if (!pending || pending.rafId !== null) return;
@@ -17,6 +18,7 @@ const createLayoutScheduler = (config) => {
 			const latest = pending;
 			pending = null;
 			if (!latest) return;
+			lastRunAt = clock.now();
 			const options = { reason: "transaction" };
 			if (latest.dirtyRange) options.dirtyRange = latest.dirtyRange;
 			config.runLayout(latest.state, options);
@@ -45,6 +47,10 @@ const createLayoutScheduler = (config) => {
 				timerId: null
 			};
 			pending = next;
+			if (config.leadingFrame && (lastRunAt === null || clock.now() - lastRunAt >= config.maxDelayMs)) {
+				flushPending();
+				return;
+			}
 			armTimer(next);
 		},
 		dispose() {

package/dist/document-operations.d.ts

@@ -0,0 +1,122 @@
+import { FolioAIEditAppliedOperation, FolioAIEditApplyMode, FolioAIEditOperation, FolioAIEditPrecondition, FolioAIEditSkippedOperation, FolioAIEditSnapshot, FolioAITextRangeHandle } from "./ai-edits/types.js";
+import { FolioAIEditView } from "./ai-edits/apply.js";
+
+//#region src/document-operations.d.ts
+declare const FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION: 1;
+declare const FOLIO_DOCUMENT_OPERATION_TYPES: readonly ["replaceInBlock", "replaceRange", "commentOnRange", "formatRange", "insertAfterBlock", "insertBeforeBlock", "replaceBlock", "deleteBlock", "commentOnBlock", "insertSignatureTable"];
+declare const FOLIO_DOCUMENT_OPERATION_MODES: readonly ["direct", "tracked-changes"];
+declare const FOLIO_DOCUMENT_OPERATION_STORIES: readonly ["main"];
+declare const FOLIO_DOCUMENT_OPERATION_PRECONDITIONS: readonly ["blockTextHash"];
+declare const FOLIO_DOCUMENT_OPERATION_BATCH_MODES: readonly ["best-effort", "atomic"];
+type FolioDocumentOperation = FolioAIEditOperation;
+type FolioDocumentOperationMode = FolioAIEditApplyMode;
+type FolioDocumentOperationPrecondition = FolioAIEditPrecondition;
+type FolioDocumentOperationType = FolioDocumentOperation["type"];
+declare const FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE: Readonly<{
+  readonly replaceInBlock: readonly ["direct", "tracked-changes"];
+  readonly replaceRange: readonly ["direct", "tracked-changes"];
+  readonly commentOnRange: readonly ["direct", "tracked-changes"];
+  readonly formatRange: readonly ["direct"];
+  readonly insertAfterBlock: readonly ["direct", "tracked-changes"];
+  readonly insertBeforeBlock: readonly ["direct", "tracked-changes"];
+  readonly replaceBlock: readonly ["direct", "tracked-changes"];
+  readonly deleteBlock: readonly ["direct", "tracked-changes"];
+  readonly commentOnBlock: readonly ["direct", "tracked-changes"];
+  readonly insertSignatureTable: readonly ["direct"];
+}>;
+type FolioDocumentOperationCapabilities = {
+  readonly version: typeof FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION;
+  readonly operationTypes: typeof FOLIO_DOCUMENT_OPERATION_TYPES;
+  readonly modes: typeof FOLIO_DOCUMENT_OPERATION_MODES;
+  readonly modesByOperationType: typeof FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE;
+  readonly batchModes: typeof FOLIO_DOCUMENT_OPERATION_BATCH_MODES;
+  readonly dryRun: true;
+  readonly preconditions: typeof FOLIO_DOCUMENT_OPERATION_PRECONDITIONS;
+  readonly stories: typeof FOLIO_DOCUMENT_OPERATION_STORIES;
+};
+declare const getFolioDocumentOperationCapabilities: () => FolioDocumentOperationCapabilities;
+declare const isFolioDocumentOperationModeSupported: (operationType: FolioDocumentOperationType, mode: FolioDocumentOperationMode) => boolean;
+declare const isSupportedFolioDocumentOperationVersion: (value: unknown) => value is typeof FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION;
+declare const UnsupportedFolioDocumentOperationVersionError_base: import("better-result").TaggedErrorClass<"UnsupportedFolioDocumentOperationVersionError", {
+  message: string;
+  receivedVersion: unknown;
+}>;
+declare class UnsupportedFolioDocumentOperationVersionError extends UnsupportedFolioDocumentOperationVersionError_base {}
+declare const InvalidFolioDocumentOperationBatchError_base: import("better-result").TaggedErrorClass<"InvalidFolioDocumentOperationBatchError", {
+  message: string;
+  path: string;
+  reason: string;
+}>;
+declare class InvalidFolioDocumentOperationBatchError extends InvalidFolioDocumentOperationBatchError_base {}
+declare const assertSupportedFolioDocumentOperationVersion: (value: unknown) => typeof FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION;
+type FolioDocumentOperationBatch = {
+  readonly version: typeof FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION;
+  operations: FolioDocumentOperation[];
+  mode?: FolioDocumentOperationMode;
+  atomic?: boolean;
+  dryRun?: boolean;
+};
+declare const parseFolioDocumentOperationBatch: (value: unknown) => FolioDocumentOperationBatch;
+type FolioDocumentOperationStatus = "committed" | "previewed" | "rejected";
+type FolioDocumentOperationRecovery = "refreshDocument" | "narrowMatch" | "changeMode" | "changeTarget" | "removeOperation" | "inspectBatch";
+type FolioDocumentOperationIssue = {
+  operationId: string;
+  operationIndex: number;
+  path: `$.operations[${number}]`;
+  code: FolioAIEditSkippedOperation["reason"];
+  retryable: boolean;
+  recovery: FolioDocumentOperationRecovery;
+};
+/** One typed target affected by a successfully applied document operation. */
+type FolioDocumentOperationAffectedTarget = {
+  type: "block";
+  story: "main";
+  blockId: string;
+  effect: "updated" | "deleted" | "commented";
+} | {
+  type: "textRange";
+  range: FolioAITextRangeHandle;
+  effect: "formatted" | "commented";
+} | {
+  type: "insertion";
+  story: "main";
+  anchorBlockId: string;
+  position: "before" | "after";
+  content: "block" | "signatureTable";
+} | {
+  type: "comment";
+  commentId: number;
+};
+/** Input-ordered effect receipt for one successfully applied operation. */
+type FolioDocumentOperationReceipt = {
+  operationId: string;
+  operationIndex: number;
+  affected: FolioDocumentOperationAffectedTarget[];
+};
+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[];
+};
+declare const getFolioDocumentOperationIssues: (operations: readonly FolioDocumentOperation[], skipped: readonly FolioAIEditSkippedOperation[]) => FolioDocumentOperationIssue[];
+/** Build deterministic affected-target receipts from operations and their applied entries. */
+declare const getFolioDocumentOperationReceipts: (operations: readonly FolioDocumentOperation[], applied: readonly FolioAIEditAppliedOperation[]) => FolioDocumentOperationReceipt[];
+type ApplyFolioDocumentOperationsOptions = {
+  view: FolioAIEditView;
+  snapshot: FolioAIEditSnapshot;
+  batch: FolioDocumentOperationBatch;
+  author?: string;
+  createCommentId?: (text: string) => number;
+};
+declare const applyFolioDocumentOperations: ({
+  view,
+  snapshot,
+  batch,
+  author,
+  createCommentId
+}: 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 };