@stll/folio-core 0.52.0 → 0.53.0

package/dist/controller/layoutPipeline.js

@@ -11,16 +11,18 @@ import { buildSeqValues } from "../fields/seqValues.js";
 import { buildFontAlternates } from "../fonts/fontAlternates.js";
 import { prepareEndnoteAreas, resolveEndnotePosition, spliceEndnoteAreas, trailingEndnoteIds } from "../layout-bridge/convert/endnoteLayout.js";
 import { buildFootnoteContentMap, collectEndnoteRefs, collectFootnoteRefs, computeNoteDisplayNumbers, remapNoteMarkerText } from "../layout-bridge/convert/footnoteLayout.js";
+import { remapMarkupViewBlocks } from "../layout-bridge/convert/markupViewFlow.js";
 import { applyTemplatePreviewToBlocks } from "../layout-bridge/convert/templatePreviewFlow.js";
 import { toFlowBlocks } from "../layout-bridge/convert/toFlowBlocks.js";
 import { getColumns } from "../layout-bridge/sectionColumns.js";
 import { resolveAnchorLayoutInCellCompatibility } from "../layout-engine/anchorLayoutInCellCompatibility.js";
 import { layoutDocument } from "../layout-engine/index.js";
 import { resolveJustificationCompatibility } from "../layout-engine/justificationCompatibility.js";
-import { recordLayoutComplete, recordLayoutError, recordLayoutPhase, recordLayoutStart } from "../layout-engine/layoutInstrumentation.js";
+import { recordLayoutComplete, recordLayoutError, recordLayoutPhase, recordLayoutStart, recordMarkupViewIncomplete } from "../layout-engine/layoutInstrumentation.js";
+import { labelMeasureCachesFontSet, syncMeasureCachesToFontSet } from "../layout-engine/measure/cache.js";
 import { collectRequestedHyphenationDictionaries } from "../layout-engine/measure/hyphenationDictionaries.js";
 import { measureBlocks, measureSingleBlockWithoutFloatingZones } from "../layout-engine/measure/measureBlocks.js";
-import { installCanvasMeasureProvider } from "../layout-engine/measure/measureContainer.js";
+import { installCanvasMeasureProvider, resetCanvasContext } from "../layout-engine/measure/measureContainer.js";
 import { resolveEffectiveParagraphSpacingTree } from "../layout-engine/paragraphSpacing.js";
 import { resolveTableIndentCompatibility } from "../layout-engine/tableIndentCompatibility.js";
 import "../layout-engine/types.js";
@@ -28,14 +30,39 @@ import { renderPages } from "../layout-painter/renderPage.js";
 import { tryBuildIncrementalMeasures } from "../paged-layout/incrementalMeasure.js";
 import { computePerBlockMeasureInputs } from "../paged-layout/sectionBlockWidths.js";
 import { getMargins, getPageNumbering, getPageSize, twipsToPixels } from "../paged-layout/sectionGeometry.js";
+import { projectMarkupView } from "../prosemirror/markupViewProjection.js";
 import { templatePreviewValuesKey } from "../prosemirror/plugins/templatePreviewValues.js";
 import { getDocumentWatermark } from "../watermark/index.js";
+import { diffAgainstCommittedLayout } from "./committedLayoutDiff.js";
+import { LAYOUT_MEASURE } from "./layoutRunOptions.js";
 //#region src/controller/layoutPipeline.ts
 const formatEndnoteTexts = (numbers, formatNumber) => {
 	const texts = /* @__PURE__ */ new Map();
 	for (const [id, displayNumber] of numbers) texts.set(id, formatNumber(displayNumber));
 	return texts;
 };
+const sameMeasureInputs = (left, right) => left.styles === right.styles && left.theme === right.theme && left.defaultTabStop === right.defaultTabStop && left.pageContentHeight === right.pageContentHeight && left.fontSet === right.fontSet && left.fontAlternates.size === right.fontAlternates.size && [...left.fontAlternates].every(([name, alternate]) => right.fontAlternates.get(name) === alternate) && left.markupView === right.markupView;
+/**
+* The range an incremental pass re-measures, or `null` for a full measure: the
+* committed measures must come from the same measure inputs, and the range is
+* where the current document and preview differ from the committed ones.
+*/
+const incrementalDirtyRange = ({ session, state, preview, measureInputs }) => {
+	const { lastPmDoc, lastMeasureInputs } = session;
+	if (!lastPmDoc || !lastMeasureInputs || !sameMeasureInputs(lastMeasureInputs, measureInputs)) return null;
+	const diff = diffAgainstCommittedLayout({
+		doc: lastPmDoc,
+		preview: session.lastTemplatePreview
+	}, {
+		doc: state.doc,
+		preview
+	});
+	switch (diff.type) {
+		case "full": return null;
+		case "range": return diff.range;
+		default: return diff;
+	}
+};
 /** Resolve only package-owned picture-watermark bytes for the DOM painter. */
 const resolveWatermarkImageSrc = (document, watermark) => {
 	if (watermark?.kind !== "picture" || watermark.imageTargetExternal === true) return;
@@ -108,11 +135,13 @@ function runLayoutPipeline(deps, state, options = {}) {
 	return result;
 }
 function runLayoutPipelineMeasured(deps, state, options) {
-	const { contentWidth, columns, pageSize, margins, pageGap, showMarginGuides, marginGuideColor, 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, pageRenderer = PAGE_RENDERER.legacy, emptyTemplatePreviewEntries: EMPTY_TEMPLATE_PREVIEW_ENTRIES, emptyTemplatePreviewHidden: EMPTY_TEMPLATE_PREVIEW_HIDDEN } = deps;
+	const { contentWidth, columns, pageSize, margins, pageGap, showMarginGuides, marginGuideColor, syncCoordinator, headerContent, footerContent, firstPageHeaderContent, firstPageFooterContent, headerContentRId, footerContentRId, firstPageHeaderContentRId, firstPageFooterContentRId, sectionHeaderFooterRefs, theme: _theme, sectionProperties, document, defaultTabStop, mirrorMargins, styles, layout, hfPMs, painter, pagesContainer, session, renderHfFromContentOrPm, renderHeaderFooterContentByRId, readFontSetSignature, buildFootnoteRenderItems, describeInvalidHighlightMarks, pageRenderer = PAGE_RENDERER.legacy, emptyTemplatePreviewEntries: EMPTY_TEMPLATE_PREVIEW_ENTRIES, emptyTemplatePreviewHidden: EMPTY_TEMPLATE_PREVIEW_HIDDEN, markupView } = deps;
 	let outcome = {};
 	let pendingArtifacts;
 	let pendingTemplatePreview;
 	installCanvasMeasureProvider();
+	const fontSet = readFontSetSignature();
+	if (syncMeasureCachesToFontSet(fontSet)) resetCanvasContext();
 	const reason = options.reason ?? "manual";
 	const recordPhaseDuration = (phase, startedAt) => {
 		recordLayoutPhase(reason, phase, performance.now() - startedAt);
@@ -124,6 +153,15 @@ function runLayoutPipelineMeasured(deps, state, options) {
 		let phaseStartedAt = performance.now();
 		const pageContentHeight = pageSize.h - margins.top - margins.bottom;
 		const fontAlternates = buildFontAlternates(document?.package.fontTable);
+		const measureInputs = {
+			styles,
+			theme: _theme,
+			defaultTabStop,
+			pageContentHeight,
+			fontSet,
+			fontAlternates,
+			markupView
+		};
 		const flowOpts = {
 			pageContentHeight,
 			fontAlternates,
@@ -151,10 +189,14 @@ function runLayoutPipelineMeasured(deps, state, options) {
 		const endnotePosition = resolveEndnotePosition(document?.package.settings?.endnotePr?.position, document?.package.document.sections?.at(-1)?.properties);
 		const bodyTrailingEndnoteIds = trailingEndnoteIds(document?.package.endnotes, endnotePosition);
 		if (bodyTrailingEndnoteIds.size > 0) flowOpts.trailingEndnoteIds = bodyTrailingEndnoteIds;
-		let newBlocks = toFlowBlocks(document === null ? state.doc.type.create({
-			...state.doc.attrs,
+		const projection = projectMarkupView(state, markupView);
+		if (projection.type === "resolved" && projection.completeness === "partial") recordMarkupViewIncomplete(markupView);
+		const viewDoc = projection.type === "resolved" ? projection.doc : state.doc;
+		let newBlocks = toFlowBlocks(document === null ? viewDoc.type.create({
+			...viewDoc.attrs,
 			_finalSectionStart: sectionProperties?.sectionStart ?? null
-		}, state.doc.content, state.doc.marks) : state.doc, flowOpts);
+		}, viewDoc.content, viewDoc.marks) : viewDoc, flowOpts);
+		if (projection.type === "resolved") newBlocks = remapMarkupViewBlocks(newBlocks, projection);
 		const previewState = templatePreviewValuesKey.getState(state);
 		const previewEntries = previewState?.entries ?? EMPTY_TEMPLATE_PREVIEW_ENTRIES;
 		const previewHidden = previewState?.hidden ?? EMPTY_TEMPLATE_PREVIEW_HIDDEN;
@@ -286,13 +328,19 @@ function runLayoutPipelineMeasured(deps, state, options) {
 		});
 		const blockWidths = blockMeasureInputs.widths;
 		const previousArtifacts = session.artifacts;
-		const incrementalResult = options.dirtyRange && !options.forceFull && previousArtifacts ? tryBuildIncrementalMeasures({
+		const dirtyRange = options.measure === LAYOUT_MEASURE.incremental ? incrementalDirtyRange({
+			session,
+			state,
+			preview: pendingTemplatePreview,
+			measureInputs
+		}) : null;
+		const incrementalResult = dirtyRange && previousArtifacts ? tryBuildIncrementalMeasures({
 			previousBlocks: previousArtifacts.blocks,
 			previousMeasures: previousArtifacts.measures,
 			previousBlockWidths: previousArtifacts.blockWidths,
 			nextBlocks: newBlocks,
 			nextBlockWidths: blockWidths,
-			dirtyRange: options.dirtyRange,
+			dirtyRange,
 			measureBlock: measureSingleBlockWithoutFloatingZones
 		}) : null;
 		let newMeasures = incrementalResult?.measures ?? measureBlocks(newBlocks, blockWidths, blockMeasureInputs.marginTops, {
@@ -583,11 +631,16 @@ function runLayoutPipelineMeasured(deps, state, options) {
 			renderPages(newLayout.pages, pagesContainer, renderOpts);
 			recordPhaseDuration("render-pages", phaseStartedAt);
 		}
+		const measuredFontSet = readFontSetSignature();
+		labelMeasureCachesFontSet(measuredFontSet);
 		session.artifacts = pendingArtifacts;
 		session.lastTemplatePreview = pendingTemplatePreview;
 		session.lastEditorState = state;
 		session.lastPmDoc = state.doc;
-		session.usedLoadedFonts = documentFontsAreLoaded();
+		session.lastMeasureInputs = {
+			...measureInputs,
+			fontSet: measuredFontSet
+		};
 		recordLayoutComplete(reason);
 	} catch (error) {
 		const invalidHighlights = describeInvalidHighlightMarks(state.doc);

package/dist/controller/layoutRunOptions.d.ts

@@ -0,0 +1,24 @@
+import { LayoutRunReason } from "../layout-engine/layoutInstrumentation.js";
+//#region src/controller/layoutRunOptions.d.ts
+/**
+ * How a layout pass measures its blocks.
+ *
+ * - `full` measures every block.
+ * - `incremental` may keep the committed layout's measures for the blocks the
+ *   current document shares with the document that layout was computed for.
+ *   The pass derives what changed from those two documents itself; a caller
+ *   never supplies a changed range, so the range cannot be relative to a
+ *   document the committed measures did not come from.
+ */
+declare const LAYOUT_MEASURE: {
+  readonly full: "full";
+  readonly incremental: "incremental";
+};
+type LayoutMeasure = (typeof LAYOUT_MEASURE)[keyof typeof LAYOUT_MEASURE];
+type LayoutRunOptions = {
+  /** Defaults to {@link LAYOUT_MEASURE.full}. */
+  measure?: LayoutMeasure;
+  reason?: LayoutRunReason;
+};
+//#endregion
+export { LAYOUT_MEASURE, LayoutMeasure, LayoutRunOptions };

package/dist/controller/layoutRunOptions.js

@@ -0,0 +1,17 @@
+//#region src/controller/layoutRunOptions.ts
+/**
+* How a layout pass measures its blocks.
+*
+* - `full` measures every block.
+* - `incremental` may keep the committed layout's measures for the blocks the
+*   current document shares with the document that layout was computed for.
+*   The pass derives what changed from those two documents itself; a caller
+*   never supplies a changed range, so the range cannot be relative to a
+*   document the committed measures did not come from.
+*/
+const LAYOUT_MEASURE = {
+	full: "full",
+	incremental: "incremental"
+};
+//#endregion
+export { LAYOUT_MEASURE };

package/dist/controller/layoutScheduler.d.ts

@@ -1,11 +1,5 @@
-import { LayoutRunReason } from "../layout-engine/layoutInstrumentation.js";
-import { DirtyRange } from "../paged-layout/incrementalMeasure.js";
+import { LayoutRunOptions } from "./layoutRunOptions.js";
 //#region src/controller/layoutScheduler.d.ts
-type LayoutRunOptions = {
-  dirtyRange?: DirtyRange;
-  forceFull?: boolean;
-  reason: LayoutRunReason;
-};
 type RunLayout<TState> = (state: TState, options: LayoutRunOptions) => void;
 type SchedulerClock = {
   requestFrame: (callback: () => void) => number;
@@ -16,6 +10,11 @@ type SchedulerClock = {
 };
 declare const browserClock: SchedulerClock;
 type LayoutSchedulerConfig<TState> = {
+  /**
+   * The editor's current state, read when a pass runs; `null` (no editor)
+   * skips the pass.
+   */
+  readState: () => TState | null;
   runLayout: RunLayout<TState>;
   /** Quiet-window debounce before an interactive layout pass. */
   debounceMs: number;
@@ -30,16 +29,22 @@ type LayoutSchedulerConfig<TState> = {
    */
   clock: SchedulerClock;
 };
-type LayoutScheduler<TState> = {
+/** Interactive transaction layout timing shared by framework adapters. */
+declare const TRANSACTION_LAYOUT_TIMING: {
+  readonly debounceMs: 32;
+  readonly maxDelayMs: 96;
+  readonly leadingFrame: true;
+};
+type LayoutScheduler = {
   /**
-   * Schedule a layout pass after a short coalescing window. Repeated calls in
-   * the window replace the pending state and merge dirty ranges, so a typing
-   * burst paints once while still honoring the max-latency cap.
+   * Request an incremental layout pass after a short coalescing window.
+   * Repeated calls in the window join the pending request, so a typing burst
+   * paints once while still honoring the max-latency cap.
    */
-  schedule: (state: TState, dirtyRange: DirtyRange | null) => void;
+  schedule: () => void;
   /** Cancel any pending timer/frame. Call on teardown. */
   dispose: () => void;
 };
-declare const createLayoutScheduler: <TState>(config: LayoutSchedulerConfig<TState>) => LayoutScheduler<TState>;
+declare const createLayoutScheduler: <TState>(config: LayoutSchedulerConfig<TState>) => LayoutScheduler;
 //#endregion
-export { LayoutRunOptions, LayoutScheduler, LayoutSchedulerConfig, RunLayout, SchedulerClock, browserClock, createLayoutScheduler };
+export { LayoutScheduler, LayoutSchedulerConfig, RunLayout, SchedulerClock, TRANSACTION_LAYOUT_TIMING, browserClock, createLayoutScheduler };

package/dist/controller/layoutScheduler.js

@@ -1,4 +1,4 @@
-import { mergeDirtyRanges } from "../paged-layout/incrementalMeasure.js";
+import { LAYOUT_MEASURE } from "./layoutRunOptions.js";
 //#region src/controller/layoutScheduler.ts
 const browserClock = {
 	requestFrame: (callback) => window.requestAnimationFrame(callback),
@@ -7,6 +7,12 @@ const browserClock = {
 	clearTimer: (id) => window.clearTimeout(id),
 	now: () => window.performance.now()
 };
+/** Interactive transaction layout timing shared by framework adapters. */
+const TRANSACTION_LAYOUT_TIMING = {
+	debounceMs: 32,
+	maxDelayMs: 96,
+	leadingFrame: true
+};
 const createLayoutScheduler = (config) => {
 	const clock = config.clock;
 	let lastRunAt = null;
@@ -15,13 +21,14 @@ const createLayoutScheduler = (config) => {
 		if (!pending || pending.rafId !== null) return;
 		pending.timerId = null;
 		pending.rafId = clock.requestFrame(() => {
-			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);
+			const state = config.readState();
+			if (state === null) return;
+			config.runLayout(state, {
+				reason: "transaction",
+				measure: LAYOUT_MEASURE.incremental
+			});
 		});
 	};
 	const armTimer = (request) => {
@@ -32,18 +39,14 @@ const createLayoutScheduler = (config) => {
 		request.timerId = clock.setTimer(flushPending, delayMs);
 	};
 	return {
-		schedule(state, dirtyRange) {
+		schedule() {
 			if (pending) {
-				pending.state = state;
-				pending.dirtyRange = mergeDirtyRanges(pending.dirtyRange, dirtyRange);
 				armTimer(pending);
 				return;
 			}
 			const next = {
-				dirtyRange,
 				firstScheduledAt: clock.now(),
 				rafId: null,
-				state,
 				timerId: null
 			};
 			pending = next;
@@ -62,4 +65,4 @@ const createLayoutScheduler = (config) => {
 	};
 };
 //#endregion
-export { browserClock, createLayoutScheduler };
+export { TRANSACTION_LAYOUT_TIMING, browserClock, createLayoutScheduler };

package/dist/controller/layoutSession.d.ts

@@ -1,5 +1,8 @@
+import { document_d_exports } from "../types/document.js";
 import { TemplatePreviewEntry, TemplatePreviewHiddenRange, TemplatePreviewValues } from "../prosemirror/plugins/templatePreviewValues.js";
 import { FlowBlock, Measure } from "../layout-engine/types.js";
+import { DisplayMode } from "../managers/EditorModeManager.js";
+import { FontAlternates } from "../fonts/fontAlternates.js";
 import { EditorState } from "prosemirror-state";
 //#region src/controller/layoutSession.d.ts
 type LayoutArtifacts = {
@@ -12,13 +15,34 @@ type LayoutTemplatePreview = {
   hidden: readonly TemplatePreviewHiddenRange[];
   mode: TemplatePreviewValues["mode"];
 };
+/**
+ * The inputs besides the ProseMirror document and block widths that a block's
+ * measure depends on. An incremental pass keeps committed measures only when
+ * these are the ones they were computed with. The `Document` model itself is
+ * not among them: adapters hand back a new one after every edit, while a load
+ * that changes how text measures brings new styles or font alternates.
+ */
+type LayoutMeasureInputs = {
+  styles: document_d_exports.StyleDefinitions | null | undefined;
+  theme: document_d_exports.Theme | null | undefined;
+  defaultTabStop: number | undefined;
+  pageContentHeight: number;
+  /**
+   * The font set (`readFontSetSignature`) the measures were taken in. A face
+   * that loads afterwards changes it, so fallback measures are never reused.
+   */
+  fontSet: string;
+  fontAlternates: FontAlternates;
+  /** The review view: each lays out different text, so a measure is reusable only within one. */
+  markupView: DisplayMode;
+};
 type LayoutSession = {
   artifacts: LayoutArtifacts | null;
   lastEditorState: EditorState | null;
   lastPmDoc: EditorState["doc"] | null;
-  usedLoadedFonts: boolean;
+  lastMeasureInputs: LayoutMeasureInputs | null;
   lastTemplatePreview: LayoutTemplatePreview;
 };
 declare const createLayoutSession: () => LayoutSession;
 //#endregion
-export { LayoutArtifacts, LayoutSession, LayoutTemplatePreview, createLayoutSession };
+export { LayoutArtifacts, LayoutMeasureInputs, LayoutSession, LayoutTemplatePreview, createLayoutSession };

package/dist/controller/layoutSession.js

@@ -3,7 +3,7 @@ const createLayoutSession = () => ({
 	artifacts: null,
 	lastEditorState: null,
 	lastPmDoc: null,
-	usedLoadedFonts: false,
+	lastMeasureInputs: null,
 	lastTemplatePreview: {
 		entries: [],
 		hidden: [],

package/dist/controller/noteEditorManager.js

@@ -8,6 +8,7 @@ import { ensureParaIdsInState } from "../prosemirror/extensions/features/ParaIdA
 import { createDocumentNumberingPlugin } from "../prosemirror/plugins/documentNumbering.js";
 import { createDocumentStylesPlugin } from "../prosemirror/plugins/documentStyles.js";
 import { schema } from "../prosemirror/schema/index.js";
+import { storyListNumbering } from "../prosemirror/storyListNumbering.js";
 import { EditorState } from "prosemirror-state";
 import { EditorView } from "prosemirror-view";
 //#region src/controller/noteEditorManager.ts
@@ -163,8 +164,11 @@ const createNoteEditorManager = (deps) => {
 			let endnotes = document.package.endnotes;
 			let footnotesChanged = false;
 			let endnotesChanged = false;
+			let numbering = document.package.numbering;
 			for (const story of mounted.values()) {
 				if (!story.dirty) continue;
+				const lists = storyListNumbering(story.view.state, numbering);
+				numbering = lists.numbering;
 				if (story.note.kind === "footnote") {
 					const index = footnotes?.findIndex(({ id }) => id === story.note.noteId) ?? -1;
 					const current = index === -1 ? null : footnotes?.at(index);
@@ -175,7 +179,7 @@ const createNoteEditorManager = (deps) => {
 					}
 					const updated = {
 						...current,
-						content: proseDocToBlocks(story.view.state.doc, current.content, document.package.styles)
+						content: proseDocToBlocks(lists.doc, current.content, document.package.styles)
 					};
 					footnotes[index] = updated;
 					story.appliedNote = updated;
@@ -192,7 +196,7 @@ const createNoteEditorManager = (deps) => {
 				}
 				const updated = {
 					...current,
-					content: proseDocToBlocks(story.view.state.doc, current.content, document.package.styles)
+					content: proseDocToBlocks(lists.doc, current.content, document.package.styles)
 				};
 				endnotes[index] = updated;
 				story.appliedNote = updated;
@@ -205,7 +209,8 @@ const createNoteEditorManager = (deps) => {
 				package: {
 					...document.package,
 					...footnotesChanged && footnotes ? { footnotes } : {},
-					...endnotesChanged && endnotes ? { endnotes } : {}
+					...endnotesChanged && endnotes ? { endnotes } : {},
+					...numbering ? { numbering } : {}
 				}
 			};
 		},

package/dist/document-operations.d.ts

@@ -1,7 +1,7 @@
 import { document_d_exports } from "./types/document.js";
 import { FolioTableTemplates } from "./ai-edits/table-template.js";
 import { FolioAIEditAppliedOperation, FolioAIEditApplyMode, FolioAIEditNormalization, FolioAIEditOperation, FolioAIEditPrecondition, FolioAIEditSkippedOperation, FolioAIEditSnapshot, FolioAITextRangeHandle } from "./ai-edits/types.js";
-import { FolioAIEditView, FolioReplacementBackground, FolioRevisionStamp, FolioWordDiffOptions } from "./ai-edits/apply.js";
+import { FolioAIEditView, FolioReplacementBackground, FolioRevisionStamp, FolioUndefinedStylePolicy, FolioWordDiffOptions } from "./ai-edits/apply.js";
 //#region src/document-operations.d.ts
 declare const FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION: 1;
 /** Direct paragraph-alignment values accepted by the operation contract. */
@@ -132,6 +132,8 @@ type FolioDocumentOperationIssue = {
   code: FolioAIEditSkippedOperation["reason"];
   retryable: boolean;
   recovery: FolioDocumentOperationRecovery;
+  /** The skip's detail, when it has one; see {@link FolioAIEditSkippedOperation.message}. */
+  message?: string;
 };
 type FolioDocumentOperationStory = "main" | {
   type: "header";
@@ -289,7 +291,14 @@ type ApplyFolioDocumentOperationsOptions = {
    * revised document — keeps them instead.
    */
   replacementBackground?: FolioReplacementBackground;
+  /**
+   * What an operation naming a paragraph style the document does not define
+   * does. Refusing it (`missingStyle`) is the default; a caller copying the
+   * style references of another document — a comparison reproducing the
+   * revised one — keeps them instead.
+   */
+  undefinedStyles?: FolioUndefinedStylePolicy;
 };
-declare const applyFolioDocumentOperations: ({ view, snapshot, batch, story, author, createCommentId, createUndoHandle, revisionStamp, wordDiff, tableTemplates, replacementBackground }: ApplyFolioDocumentOperationsOptions) => FolioDocumentOperationResult;
+declare const applyFolioDocumentOperations: ({ view, snapshot, batch, story, author, createCommentId, createUndoHandle, revisionStamp, wordDiff, tableTemplates, replacementBackground, undefinedStyles }: ApplyFolioDocumentOperationsOptions) => FolioDocumentOperationResult;
 //#endregion
 export { ApplyFolioDocumentOperationsOptions, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_BATCH_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_KEYS_BY_TYPE, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FOLIO_LINE_SPACING_RULE_VALUES, FOLIO_PAGE_BREAK_CLEAR_VALUES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, FolioDocumentOperation, FolioDocumentOperationAffectedTarget, FolioDocumentOperationBatch, FolioDocumentOperationBatchPrecondition, FolioDocumentOperationCapabilities, FolioDocumentOperationIssue, FolioDocumentOperationMode, FolioDocumentOperationPrecondition, FolioDocumentOperationQueuedOperation, FolioDocumentOperationReceipt, FolioDocumentOperationRecovery, FolioDocumentOperationResult, FolioDocumentOperationResultBase, FolioDocumentOperationStatus, FolioDocumentOperationStory, FolioDocumentOperationType, FolioDocumentOperationUndoFailureReason, FolioDocumentOperationUndoHandle, FolioDocumentOperationUndoResult, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch };