@stll/folio-core 0.61.0 → 0.63.0

package/dist/ai-edits/headless.js

@@ -3,6 +3,7 @@ import { matchInlineProvenance } from "../compare/inline-provenance.js";
 import { stageSectionBoundaryProperties } from "../compare/section-boundary-properties.js";
 import { importReferencedStyleDefinitions, styleClosureNumberingReferences } from "../compare/style-resources.js";
 import { applyFolioDocumentOperations } from "../document-operations.js";
+import { removeCommentMarkers } from "../docx/commentAnchorIndex.js";
 import { applyReplyThreadMarkers } from "../docx/commentReplyMarkers.js";
 import { commentTextParagraph } from "../docx/commentTextParagraph.js";
 import { buildSections } from "../docx/documentParser.js";
@@ -12,6 +13,7 @@ import { normalizeListModelRendering } from "../docx/listModelNormalization.js";
 import { createNumberingIdAllocator } from "../docx/numberingIds.js";
 import { getCachedNumberingMap } from "../docx/numberingParser.js";
 import { recreateProseNodeWithParagraphPropertySource, transferProseParagraphPropertySource } from "../docx/paragraphPropertySource.js";
+import { visitDocxParagraphs } from "../docx/paragraphTraversal.js";
 import { parseDocx } from "../docx/parser.js";
 import { createReply } from "../docx/replyToComment.js";
 import { repackDocx } from "../docx/rezip.js";
@@ -32,16 +34,17 @@ import { getChangedParagraphIds, getTrackedSectionEndpointRemoval, hasStructural
 import { completeNumberingForDoc } from "../prosemirror/listInstanceReferences.js";
 import "../prosemirror/listMarker.js";
 import { deleteNoteWithReference, noteDeletionRevisions, noteKeysReferencedIn, noteReferenceStates, noteReferencesRestored, referenceDeletions, referencedNotes } from "../prosemirror/noteReferenceReview.js";
-import { createDocumentNumberingPlugin, withDocumentNumbering } from "../prosemirror/plugins/documentNumbering.js";
+import { createDocumentNumberingPlugin, getDocumentNumbering, withDocumentNumbering } from "../prosemirror/plugins/documentNumbering.js";
 import { getDocumentStyleResolver } from "../prosemirror/plugins/documentStyleState.js";
 import { createDocumentStylesPlugin, withDocumentStyles } from "../prosemirror/plugins/documentStyles.js";
 import { schema, singletonManager } from "../prosemirror/schema/index.js";
 import { sectionPropertiesOf } from "../prosemirror/sectionCarrier.js";
 import { storyListNumbering } from "../prosemirror/storyListNumbering.js";
+import { collapseEmptyTextBoxHosts } from "../prosemirror/textBoxHostCollapse.js";
 import { canonicalJson } from "../utils/canonicalJson.js";
 import { deterministicHexId } from "../utils/hexId.js";
 import { buildAnnotatedBlockTextWithNoteReferences } from "./clean-text.js";
-import { anchoredCommentIdsInBlocks, anchoredCommentIdsInProseDoc, withoutLostCommentThreads } from "./comment-lifecycle.js";
+import { anchoredCommentIdsInBlocks, anchoredCommentIdsInProseDoc, coveredCommentIdsInProseDoc, withoutLostCommentThreads } from "./comment-lifecycle.js";
 import { noteReferenceEditsAllowed } from "./note-references.js";
 import { noteStoryInventory } from "./note-story-inventory.js";
 import { FolioPendingSuggestionRegistry, createPendingSuggestionSourceSnapshot, withoutPendingSuggestionCommentMarks } from "./pending-suggestions.js";
@@ -51,7 +54,7 @@ import { collectNoteReferenceLabels, createFolioAIEditSnapshotWithStyleResolver,
 import { matchTableGeometry } from "./table-geometry.js";
 import { tableTemplateCanCrossPackageLosslessly } from "./table-template.js";
 import { TaggedError, panic } from "better-result";
-import { REVIEW_CARRIERS } from "@stll/docx-core/model";
+import { REVIEW_CARRIERS, finalizeParagraphFormatting, numberingLevelEntries, setDocumentBodyComments } from "@stll/docx-core/model";
 import { Fragment } from "prosemirror-model";
 import { reconcileDocumentPartRelationships } from "@stll/docx-core/ops";
 import { EditorState } from "prosemirror-state";
@@ -79,6 +82,7 @@ import JSZip from "jszip";
 let undoHandleCursor = Date.now();
 const createReviewerComment = ({ id, text, author, date }) => ({
 	id,
+	anchorKind: "range",
 	author,
 	date: date ?? (/* @__PURE__ */ new Date()).toISOString(),
 	content: [commentTextParagraph(text)]
@@ -202,23 +206,16 @@ const resolvedStoryProjection = (snapshot, minted) => {
 };
 const numberingLevelsOf = (numbering) => {
 	if (!numbering) return [];
-	const levelsByAbstractId = new Map(numbering.abstractNums.map((abstractNum) => [abstractNum.abstractNumId, abstractNum.levels]));
-	const levels = [];
-	for (const instance of numbering.nums) {
-		const overrides = new Map((instance.levelOverrides ?? []).map((override) => [override.ilvl, override]));
-		for (const level of levelsByAbstractId.get(instance.abstractNumId) ?? []) {
-			const override = overrides.get(level.ilvl);
-			const resolved = override?.lvl ?? level;
-			levels.push({
-				numId: instance.numId,
-				level: resolved.ilvl,
-				format: resolved.numFmt,
-				levelText: resolved.lvlText,
-				...(override?.startOverride ?? resolved.start) !== void 0 ? { start: override?.startOverride ?? resolved.start } : {}
-			});
-		}
-	}
-	return levels;
+	return numberingLevelEntries(numbering).map(({ numId, ilvl, level }) => {
+		const entry = {
+			numId,
+			level: ilvl,
+			format: level.numFmt,
+			levelText: level.lvlText
+		};
+		if (level.start !== void 0) entry.start = level.start;
+		return entry;
+	});
 };
 const referencedNumberingLevelsByNumId = ({ references }) => {
 	const levelsByNumId = /* @__PURE__ */ new Map();
@@ -302,7 +299,7 @@ const createHeadlessPlugins = (styles, numbering) => [
 	createDocumentStylesPlugin(styles),
 	createDocumentNumberingPlugin(numbering)
 ];
-const createStateSnapshot = (state) => createFolioAIEditSnapshotWithStyleResolver(state.doc, getDocumentStyleResolver(state));
+const createStateSnapshot = (state) => createFolioAIEditSnapshotWithStyleResolver(state.doc, getDocumentStyleResolver(state), getDocumentNumbering(state));
 const formatStorySnapshotForLLM = (snapshot, annotated) => {
 	const blocks = snapshot.blocks.filter(isFolioAIContentBlock);
 	if (!annotated) return blocks.map(formatBlockForLLM).join("\n");
@@ -580,7 +577,8 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 		const targetAbstracts = new Map(target.abstractNums.map((entry) => [entry.abstractNumId, entry]));
 		const levelsByNumId = referencedNumberingLevelsByNumId({ references });
 		const importedAbstractIds = /* @__PURE__ */ new Map();
-		const abstractIds = createNumberingIdAllocator("abstract", [...abstracts.keys(), ...targetAbstracts.keys()]);
+		const existingAbstractIds = [...abstracts.keys(), ...targetAbstracts.keys()];
+		const abstractIds = createNumberingIdAllocator("abstract", existingAbstractIds);
 		for (const numId of levelsByNumId.keys()) {
 			const targetNum = targetNums.get(numId);
 			if (!targetNum) return "conflict";
@@ -635,7 +633,8 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 		const targetNums = new Map(target.nums.map((entry) => [entry.numId, entry]));
 		const targetAbstracts = new Map(target.abstractNums.map((entry) => [entry.abstractNumId, entry]));
 		const levelsByNumId = referencedNumberingLevelsByNumId({ references });
-		const numberingIds = createNumberingIdAllocator("num", [...nums.keys(), ...targetNums.keys()]);
+		const existingNumIds = [...nums.keys(), ...targetNums.keys()];
+		const numberingIds = createNumberingIdAllocator("num", existingNumIds);
 		const remapped = /* @__PURE__ */ new Map();
 		for (const numId of levelsByNumId.keys()) {
 			const targetNum = targetNums.get(numId);
@@ -678,10 +677,15 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 	snapshot() {
 		return createStateSnapshot(this.state);
 	}
-	/** Export staged AI operations for storage by the host, outside the DOCX. */
-	exportPendingSuggestions() {
+	/** Every suggestion id the document's stories still carry. */
+	activeSuggestionIds() {
 		const active = new Set(getSuggestions(this.state).map(({ suggestionId }) => suggestionId));
 		for (const entry of this.secondaryStoryStates.values()) for (const { suggestionId } of getSuggestions(entry.state)) active.add(suggestionId);
+		return active;
+	}
+	/** Export staged AI operations for storage by the host, outside the DOCX. */
+	exportPendingSuggestions() {
+		const active = this.activeSuggestionIds();
 		return this.pendingSuggestions.exportPendingSuggestions({
 			activeSuggestionIds: active,
 			snapshotForStory: (story, commentIds) => {
@@ -702,6 +706,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 			apply: (record, snapshot) => {
 				const result = this.applyDocumentOperationsInternal({
 					undefinedReferences: "refuse",
+					restagesSuggestions: true,
 					story: record.story,
 					batch: {
 						version: 1,
@@ -945,7 +950,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 		if (noteReferenceEditsAllowed()) return this.applyDocumentOperationsToStoryState(options);
 		return this.withNotesFollowingReferences(() => this.applyDocumentOperationsToStoryState(options));
 	}
-	applyDocumentOperationsToStoryState({ story, batch, author, snapshot, revisionStamp, wordDiff, tableTemplates, replacementBackground, undefinedReferences, createUndoEntry }) {
+	applyDocumentOperationsToStoryState({ story, batch, author, snapshot, revisionStamp, wordDiff, tableTemplates, replacementBackground, undefinedReferences, createUndoEntry, restagesSuggestions }) {
 		const beforeState = this.requireEditableStoryState(story);
 		const operationAuthor = author ?? this.author;
 		const sourceSnapshot = snapshot ?? createStateSnapshot(beforeState);
@@ -967,6 +972,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 			...tableTemplates !== void 0 && { tableTemplates },
 			...replacementBackground !== void 0 && { replacementBackground },
 			undefinedReferences,
+			...restagesSuggestions === true ? { restagesSuggestions } : { pendingSuggestionIds: this.activeSuggestionIds() },
 			createCommentId: (text) => {
 				const comment = createReviewerComment({
 					id: this.nextCommentId(),
@@ -1171,9 +1177,15 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 	* (nested tracked changes, hyperlinks) is out of scope.
 	*/
 	getComments(filter) {
-		const definitions = this.withResolvedOverrides(this.keptCommentThreads([...this.baseDocument.package.document.comments ?? [], ...this.createdComments], this.state, this.secondaryStoryStates.values()));
-		if (definitions.length === 0) return [];
 		const anchors = this.commentAnchors();
+		const covered = /* @__PURE__ */ new Set();
+		for (const story of this.listStoryHandlesInternal()) {
+			const doc = story.type === "main" ? this.state.doc : this.readSecondaryStoryDoc(story);
+			if (!doc) continue;
+			for (const id of coveredCommentIdsInProseDoc(doc)) covered.add(id);
+		}
+		const definitions = this.withResolvedOverrides(this.keptCommentThreads([...this.baseDocument.package.document.comments ?? [], ...this.createdComments], this.state, this.secondaryStoryStates.values()).filter(({ id, parentId, anchorKind }) => anchorKind !== "range" || parentId !== void 0 || covered.has(id)));
+		if (definitions.length === 0) return [];
 		const repliesByParent = /* @__PURE__ */ new Map();
 		const topLevel = [];
 		for (const comment of definitions) {
@@ -1218,7 +1230,8 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 	*/
 	replyTo(target, input) {
 		const parentId = typeof target === "number" ? target : target.id;
-		const reply = createReply([...this.baseDocument.package.document.comments ?? [], ...this.createdComments], parentId, {
+		const existing = [...this.baseDocument.package.document.comments ?? [], ...this.createdComments];
+		const reply = createReply(existing, parentId, {
 			author: input.author ?? this.author,
 			text: input.text,
 			...input.initials !== void 0 ? { initials: input.initials } : {},
@@ -1408,7 +1421,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 		const id = revisionIdOf(target);
 		const ids = getTrackedChangeGroupIdsFromDoc(this.state.doc, id);
 		const suggestionId = suggestionIdOfRevision(this.state, id);
-		if (suggestionId !== null) this.runCommand(acceptSuggestion(suggestionId, { author: this.author }));
+		if (suggestionId !== null && !this.runCommand(acceptSuggestion(suggestionId, { author: this.author }))) return false;
 		let bodyChanged = false;
 		for (const memberId of ids) bodyChanged = this.runCommand(acceptAIEditRevision(memberId)) || bodyChanged;
 		const sectionChanged = this.resolveFinalSectionProperties("accept", id) > 0;
@@ -1623,6 +1636,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 			};
 			const applied = applyFolioDocumentOperations({
 				undefinedReferences: "refuse",
+				restagesSuggestions: true,
 				view,
 				snapshot,
 				batch: {
@@ -1673,6 +1687,15 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 	toDocument() {
 		const document = this.documentFromStateSnapshot(this.captureReviewerState());
 		applyReplyThreadMarkers(document);
+		visitDocxParagraphs({
+			documentBody: document.package.document,
+			headers: document.package.headers,
+			footers: document.package.footers,
+			footnotes: document.package.footnotes,
+			endnotes: document.package.endnotes
+		}, (paragraph) => {
+			if (finalizeParagraphFormatting(paragraph.formatting) === void 0) delete paragraph.formatting;
+		});
 		return document;
 	}
 	captureReviewerState() {
@@ -1698,7 +1721,17 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 			resolvedStoryExpectations: [...this.resolvedStoryExpectations.values()].filter(({ story }) => story.type === "main" || this.secondaryStorySource(story) !== void 0)
 		};
 	}
-	documentFromStateSnapshot(snapshot) {
+	documentFromStateSnapshot(authored) {
+		const pendingCommentIds = new Set(this.exportPendingSuggestions().flatMap(({ commentId }) => commentId === void 0 ? [] : [commentId]));
+		const snapshot = {
+			...authored,
+			mainState: withoutPendingSuggestionCommentMarks(rejectSuggestions(authored.mainState), pendingCommentIds),
+			secondaryStoryStates: authored.secondaryStoryStates.map((entry) => ({
+				...entry,
+				state: withoutPendingSuggestionCommentMarks(rejectSuggestions(entry.state), pendingCommentIds)
+			})),
+			createdComments: authored.createdComments.filter(({ id }) => !pendingCommentIds.has(id))
+		};
 		const sourceDocument = snapshot.importedStyles === void 0 ? this.baseDocument : {
 			...this.baseDocument,
 			package: {
@@ -1733,13 +1766,64 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 			Object.assign(document.package, noteStoryInventory(document.package, removed));
 		}
 		const definitions = [...document.package.document.comments ?? [], ...snapshot.createdComments];
-		const kept = this.keptCommentThreads(definitions, snapshot.mainState, snapshot.secondaryStoryStates);
-		if (kept.length !== definitions.length || snapshot.createdComments.length > 0 || snapshot.resolvedOverrides.size > 0) document.package.document.comments = this.withResolvedOverrides(kept, snapshot.resolvedOverrides);
-		return normalizeListModelRendering(reconcileDocumentPartRelationships(document)).document;
+		const knownDefinitions = [...this.baseDocument.package.document.comments ?? [], ...snapshot.createdComments];
+		const keptThreadIds = new Set(this.keptCommentThreads(knownDefinitions, snapshot.mainState, snapshot.secondaryStoryStates).map(({ id }) => id));
+		const kept = definitions.filter(({ id }) => keptThreadIds.has(id));
+		const keptIds = new Set(kept.map(({ id }) => id));
+		const retiredCommentIds = new Set(knownDefinitions.filter(({ id }) => !keptIds.has(id)).map(({ id }) => id));
+		const modelStories = [
+			document.package.document,
+			...document.package.headers?.values() ?? [],
+			...document.package.footers?.values() ?? [],
+			...document.package.footnotes ?? [],
+			...document.package.endnotes ?? []
+		];
+		for (const story of modelStories) for (const id of anchoredCommentIdsInBlocks(story.content)) if (!keptIds.has(id)) retiredCommentIds.add(id);
+		if (retiredCommentIds.size > 0) {
+			document.package.document = {
+				...document.package.document,
+				content: removeCommentMarkers(document.package.document.content, retiredCommentIds)
+			};
+			if (document.package.headers) {
+				const headers = new Map(document.package.headers);
+				for (const [id, header] of headers) headers.set(id, {
+					...header,
+					content: removeCommentMarkers(header.content, retiredCommentIds)
+				});
+				document.package.headers = headers;
+			}
+			if (document.package.footers) {
+				const footers = new Map(document.package.footers);
+				for (const [id, footer] of footers) footers.set(id, {
+					...footer,
+					content: removeCommentMarkers(footer.content, retiredCommentIds)
+				});
+				document.package.footers = footers;
+			}
+			if (document.package.footnotes) document.package.footnotes = document.package.footnotes.map((footnote) => ({
+				...footnote,
+				content: removeCommentMarkers(footnote.content, retiredCommentIds)
+			}));
+			if (document.package.endnotes) document.package.endnotes = document.package.endnotes.map((endnote) => ({
+				...endnote,
+				content: removeCommentMarkers(endnote.content, retiredCommentIds)
+			}));
+		}
+		if (kept.length !== definitions.length || snapshot.createdComments.length > 0 || snapshot.resolvedOverrides.size > 0) setDocumentBodyComments(document.package.document, this.withResolvedOverrides(kept, snapshot.resolvedOverrides));
+		const normalized = normalizeListModelRendering(reconcileDocumentPartRelationships(document)).document;
+		visitDocxParagraphs({
+			documentBody: normalized.package.document,
+			headers: normalized.package.headers,
+			footers: normalized.package.footers,
+			footnotes: normalized.package.footnotes,
+			endnotes: normalized.package.endnotes
+		}, (paragraph) => {
+			if (finalizeParagraphFormatting(paragraph.formatting) === void 0) delete paragraph.formatting;
+		});
+		return normalized;
 	}
 	captureSaveSnapshot() {
 		const snapshot = this.captureReviewerState();
-		const pendingCommentIds = new Set(this.exportPendingSuggestions().flatMap(({ commentId }) => commentId === void 0 ? [] : [commentId]));
 		const changedParaIds = new Set(getChangedParagraphIds(snapshot.mainState));
 		let structuralChange = hasStructuralChanges(snapshot.mainState) || snapshot.finalSectionPropertiesOverride !== void 0 || snapshot.importedStyles !== void 0 || snapshot.importedHeaders.size > 0 || snapshot.importedFooters.size > 0 || snapshot.removedNoteStories.length > 0;
 		let untrackedChanges = hasUntrackedChanges(snapshot.mainState);
@@ -1766,15 +1850,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 			reason: "untrackedChange"
 		};
 		return {
-			document: this.documentFromStateSnapshot({
-				...snapshot,
-				mainState: withoutPendingSuggestionCommentMarks(rejectSuggestions(snapshot.mainState), pendingCommentIds),
-				secondaryStoryStates: snapshot.secondaryStoryStates.map((entry) => ({
-					...entry,
-					state: withoutPendingSuggestionCommentMarks(rejectSuggestions(entry.state), pendingCommentIds)
-				})),
-				createdComments: snapshot.createdComments.filter(({ id }) => !pendingCommentIds.has(id))
-			}),
+			document: this.documentFromStateSnapshot(snapshot),
 			path,
 			changedNoteParaIds,
 			sectionReferenceRemovals: snapshot.sectionReferenceRemovals,
@@ -1933,10 +2009,11 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 			story
 		});
 	}
-	setEditableStoryState(story, state) {
+	setEditableStoryState(story, projected) {
 		this.resolvedStoryExpectations.delete(editableStoryKey(story));
+		const folded = (stored) => stored.doc === projected.doc ? projected : collapseEmptyTextBoxHosts(projected);
 		if (story.type === "main") {
-			this.state = state;
+			this.state = folded(this.state);
 			return;
 		}
 		const entry = this.secondaryStoryStates.get(secondaryStoryKey(story));
@@ -1944,7 +2021,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 			message: `Document story ${JSON.stringify(story)} was not found.`,
 			story
 		});
-		entry.state = state;
+		entry.state = folded(entry.state);
 	}
 	getHeaderFooterStory(story) {
 		if (this.removedHeaderFooterStories.has(headerFooterStoryKey(story))) return void 0;
@@ -2050,7 +2127,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 	* same states, so the text now describes exactly what a save would write.
 	*/
 	storyBlocks(state, source) {
-		return state ? proseDocToBlocks(state.doc, source.content, this.baseDocument.package.styles) : source.content;
+		return state ? proseDocToBlocks(rejectSuggestions(state).doc, source.content, this.baseDocument.package.styles) : source.content;
 	}
 	getHeaderFooterStoryText(story, source) {
 		const state = this.secondaryStoryStates.get(headerFooterStoryKey(story))?.state;
@@ -2160,19 +2237,35 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 		const addAll = (target, ids) => {
 			for (const id of ids) target.add(id);
 		};
+		const referenceStates = noteReferenceStates(mainState.doc);
+		for (const entry of loaded.values()) {
+			addAll(anchoredBefore, anchoredCommentIdsInProseDoc(entry.initialState.doc));
+			if ((entry.handle.type === "footnote" || entry.handle.type === "endnote") && this.removedNoteStories.has(noteStoryKey(entry.handle)) && referenceStates.get(noteStoryKey(entry.handle)) !== "deleted") continue;
+			addAll(anchoredNow, anchoredCommentIdsInProseDoc(entry.state.doc, entry.initialState.doc));
+		}
 		for (const handle of this.listStoryHandlesInternal()) {
 			if (handle.type === "main") continue;
-			const entry = loaded.get(secondaryStoryKey(handle));
-			if (entry) {
-				addAll(anchoredBefore, anchoredCommentIdsInProseDoc(entry.initialState.doc));
-				addAll(anchoredNow, anchoredCommentIdsInProseDoc(entry.state.doc));
+			if (loaded.get(secondaryStoryKey(handle))) continue;
+			const source = handle.type === "header" || handle.type === "footer" ? this.getHeaderFooterStory(handle) : this.getNoteStory(handle);
+			addAll(anchoredNow, anchoredCommentIdsInBlocks(source?.content ?? []));
+		}
+		for (const handle of this.removedNoteStories.values()) {
+			if (loaded.get(secondaryStoryKey(handle))) {
+				if (referenceStates.get(noteStoryKey(handle)) === "deleted") {
+					const source = (handle.type === "footnote" ? this.baseDocument.package.footnotes : this.baseDocument.package.endnotes)?.find((note) => note.id === handle.noteId);
+					addAll(anchoredNow, anchoredCommentIdsInBlocks(source?.content ?? []));
+				}
 				continue;
 			}
-			addAll(anchoredNow, anchoredCommentIdsInBlocks((handle.type === "header" || handle.type === "footer" ? this.getHeaderFooterStory(handle) : this.getNoteStory(handle))?.content ?? []));
+			const removed = anchoredCommentIdsInBlocks((handle.type === "footnote" ? this.baseDocument.package.footnotes : this.baseDocument.package.endnotes)?.find((note) => note.id === handle.noteId)?.content ?? []);
+			addAll(anchoredBefore, removed);
+			if (referenceStates.get(noteStoryKey(handle)) === "deleted") addAll(anchoredNow, removed);
 		}
-		for (const handle of this.removedNoteStories.values()) {
-			const entry = loaded.get(secondaryStoryKey(handle));
-			addAll(anchoredBefore, entry ? anchoredCommentIdsInProseDoc(entry.initialState.doc) : anchoredCommentIdsInBlocks((handle.type === "footnote" ? this.baseDocument.package.footnotes : this.baseDocument.package.endnotes)?.find((note) => note.id === handle.noteId)?.content ?? []));
+		for (const [key, state] of referenceStates) {
+			if (state !== "deleted") continue;
+			const handle = noteStoryHandleOf(key);
+			if (!handle || loaded.has(secondaryStoryKey(handle))) continue;
+			addAll(anchoredNow, anchoredCommentIdsInBlocks(this.getNoteStory(handle)?.content ?? []));
 		}
 		return withoutLostCommentThreads(comments, {
 			anchoredBefore,
@@ -2186,14 +2279,22 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 	*/
 	commentAnchors() {
 		const anchors = /* @__PURE__ */ new Map();
-		for (const story of this.listStoryHandlesInternal()) {
-			const doc = story.type === "main" ? this.state.doc : this.readSecondaryStoryDoc(story);
-			if (!doc) continue;
+		const add = (doc, story) => {
 			for (const anchor of getCommentAnchorsFromDoc(doc)) if (!anchors.has(anchor.commentId)) anchors.set(anchor.commentId, {
 				text: anchor.quote,
 				blockId: anchor.blockId,
 				story
 			});
+		};
+		for (const story of this.listStoryHandlesInternal()) {
+			const doc = story.type === "main" ? this.state.doc : this.readSecondaryStoryDoc(story);
+			if (!doc) continue;
+			add(doc, story);
+		}
+		for (const story of this.removedNoteStories.values()) {
+			if (noteReferenceStates(this.state.doc).get(noteStoryKey(story)) !== "deleted") continue;
+			const entry = this.secondaryStoryStates.get(secondaryStoryKey(story));
+			if (entry) add(entry.initialState.doc, story);
 		}
 		return anchors;
 	}

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

@@ -10,5 +10,6 @@ import { FolioCommentAnchor, FolioReviewChange, FolioReviewChangeKind, getCommen
 import { createFolioAIEditSnapshot, createFolioAIEditSnapshotWithStyleResolver, createFolioAITextRangeHandle, hashFolioAIBlockText, isFolioAIContentBlock, normalizeFolioAIBlockText } from "./snapshot.js";
 import { FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FolioApplyDocumentOperationsToStoryOptions, FolioDocumentStory, FolioDocumentStoryHandle, FolioDocumentStoryNotFoundError, FolioEditableDocumentStoryHandle, FolioReadReviewedStoryOptions, FolioResolveReviewedStoryOptions, FolioResolvedReviewedView, FolioReviewedStory, FolioReviewedView, UnsupportedFolioReviewedViewError, isFolioResolvedReviewedView, isFolioReviewedView } from "./headless.js";
 import { getFolioDocumentOutline, readFolioDocumentSection } from "./scoped-reading.js";
+import { getFolioDocumentOperationRemovedBlockIds } from "./removed-blocks.js";
 import { getFolioParaIdFromBlockId } from "../types/block-id.js";
-export { type ApplyFolioDocumentOperationsOptions, type DocPositionRange, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FOLIO_LINE_SPACING_RULE_VALUES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, FOLIO_PENDING_SUGGESTION_VERSION, FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIBlockStructuralBoundary, type FolioAIBlockTableLocation, type FolioAIComment, type FolioAIDiagnosticBlock, type FolioAIEditAppliedOperation, type FolioAIEditApplyMode, type FolioAIEditApplyOutcome, type FolioAIEditApplyResult, type FolioAIEditNormalization, type FolioAIEditNormalizationCode, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditReviewMeta, type FolioAIEditSeverity, type FolioAIEditSkipReason, type FolioAIEditSkippedOperation, type FolioAIEditSnapshot, type FolioAIEditView, type FolioAIInlineBooleanProperty, type FolioAIInlineFormatting, type FolioAIInlineFormattingPatch, type FolioAIInsertFormattingScope, type FolioAIParagraphBlock, type FolioAIParagraphSpacing, type FolioAISignatureParty, type FolioAITextRangeHandle, type FolioApplyDocumentOperationsToStoryOptions, type FolioCommentAnchor, type FolioContentParagraphKind, type FolioDocumentNavigationTarget, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationResultBase, type FolioDocumentOperationStatus, type FolioDocumentOperationStory, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type FolioDocumentOutline, type FolioDocumentOutlineEntry, type FolioDocumentSection, type FolioDocumentSectionHandle, type FolioDocumentSectionReadResult, type FolioDocumentStory, type FolioDocumentStoryHandle, FolioDocumentStoryNotFoundError, type FolioEditableDocumentStoryHandle, type FolioPendingSuggestionLoadResult, type FolioPendingSuggestionRecord, FolioPendingSuggestionRegistry, type FolioPendingSuggestionStaleReason, type FolioReadReviewedStoryOptions, type FolioResolveReviewedStoryOptions, type FolioResolvedReviewedView, type FolioReviewChange, type FolioReviewChangeKind, type FolioReviewedStory, type FolioReviewedView, type FolioRevisionStamp, type FolioUndefinedReferencePolicy, type FolioWordDiffOptions, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioReviewedViewError, WORD_DIFF_GRANULARITIES, type WordDiffGranularity, type WordDiffNormalization, type WordDiffOptions, type WordDiffSegment, applyFolioAIEditOperations, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, buildAnnotatedBlockText, clampRangeToDocSize, createFolioAIEditSnapshot, createFolioAIEditSnapshotWithStyleResolver, createFolioAITextRangeHandle, createPendingSuggestionSourceSnapshot, diffWordSegments, getCommentAnchorsFromDoc, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, getTrackedChangesFromDoc, hashFolioAIBlockText, isFolioAIContentBlock, isFolioDocumentOperationModeSupported, isFolioResolvedReviewedView, isFolioReviewedView, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, readFolioDocumentSection, resolveFolioAIBlockRange, resolveFolioAITextRange, resolvePassageRange };
+export { type ApplyFolioDocumentOperationsOptions, type DocPositionRange, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FOLIO_LINE_SPACING_RULE_VALUES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, FOLIO_PENDING_SUGGESTION_VERSION, FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIBlockStructuralBoundary, type FolioAIBlockTableLocation, type FolioAIComment, type FolioAIDiagnosticBlock, type FolioAIEditAppliedOperation, type FolioAIEditApplyMode, type FolioAIEditApplyOutcome, type FolioAIEditApplyResult, type FolioAIEditNormalization, type FolioAIEditNormalizationCode, type FolioAIEditOperation, type FolioAIEditPrecondition, type FolioAIEditReviewMeta, type FolioAIEditSeverity, type FolioAIEditSkipReason, type FolioAIEditSkippedOperation, type FolioAIEditSnapshot, type FolioAIEditView, type FolioAIInlineBooleanProperty, type FolioAIInlineFormatting, type FolioAIInlineFormattingPatch, type FolioAIInsertFormattingScope, type FolioAIParagraphBlock, type FolioAIParagraphSpacing, type FolioAISignatureParty, type FolioAITextRangeHandle, type FolioApplyDocumentOperationsToStoryOptions, type FolioCommentAnchor, type FolioContentParagraphKind, type FolioDocumentNavigationTarget, type FolioDocumentOperation, type FolioDocumentOperationAffectedTarget, type FolioDocumentOperationBatch, type FolioDocumentOperationCapabilities, type FolioDocumentOperationIssue, type FolioDocumentOperationMode, type FolioDocumentOperationPrecondition, type FolioDocumentOperationReceipt, type FolioDocumentOperationRecovery, type FolioDocumentOperationResult, type FolioDocumentOperationResultBase, type FolioDocumentOperationStatus, type FolioDocumentOperationStory, type FolioDocumentOperationType, type FolioDocumentOperationUndoFailureReason, type FolioDocumentOperationUndoHandle, type FolioDocumentOperationUndoResult, type FolioDocumentOutline, type FolioDocumentOutlineEntry, type FolioDocumentSection, type FolioDocumentSectionHandle, type FolioDocumentSectionReadResult, type FolioDocumentStory, type FolioDocumentStoryHandle, FolioDocumentStoryNotFoundError, type FolioEditableDocumentStoryHandle, type FolioPendingSuggestionLoadResult, type FolioPendingSuggestionRecord, FolioPendingSuggestionRegistry, type FolioPendingSuggestionStaleReason, type FolioReadReviewedStoryOptions, type FolioResolveReviewedStoryOptions, type FolioResolvedReviewedView, type FolioReviewChange, type FolioReviewChangeKind, type FolioReviewedStory, type FolioReviewedView, type FolioRevisionStamp, type FolioUndefinedReferencePolicy, type FolioWordDiffOptions, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioReviewedViewError, WORD_DIFF_GRANULARITIES, type WordDiffGranularity, type WordDiffNormalization, type WordDiffOptions, type WordDiffSegment, applyFolioAIEditOperations, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, buildAnnotatedBlockText, clampRangeToDocSize, createFolioAIEditSnapshot, createFolioAIEditSnapshotWithStyleResolver, createFolioAITextRangeHandle, createPendingSuggestionSourceSnapshot, diffWordSegments, getCommentAnchorsFromDoc, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOperationRemovedBlockIds, getFolioDocumentOutline, getFolioParaIdFromBlockId, getTrackedChangesFromDoc, hashFolioAIBlockText, isFolioAIContentBlock, isFolioDocumentOperationModeSupported, isFolioResolvedReviewedView, isFolioReviewedView, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, readFolioDocumentSection, resolveFolioAIBlockRange, resolveFolioAITextRange, resolvePassageRange };

package/dist/ai-edits/index.js

@@ -6,7 +6,8 @@ import { buildAnnotatedBlockText } from "./clean-text.js";
 import { FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FolioDocumentStoryNotFoundError, UnsupportedFolioReviewedViewError, isFolioResolvedReviewedView, isFolioReviewedView } from "./headless.js";
 import { FOLIO_PENDING_SUGGESTION_VERSION, FolioPendingSuggestionRegistry, createPendingSuggestionSourceSnapshot } from "./pending-suggestions.js";
 import { getCommentAnchorsFromDoc, getTrackedChangesFromDoc } from "./read.js";
+import { getFolioDocumentOperationRemovedBlockIds } from "./removed-blocks.js";
 import { getFolioDocumentOutline, readFolioDocumentSection } from "./scoped-reading.js";
 import { createFolioAIEditSnapshot, createFolioAIEditSnapshotWithStyleResolver, createFolioAITextRangeHandle, hashFolioAIBlockText, isFolioAIContentBlock, normalizeFolioAIBlockText } from "./snapshot.js";
 import { WORD_DIFF_GRANULARITIES, diffWordSegments } from "./word-diff.js";
-export { FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FOLIO_LINE_SPACING_RULE_VALUES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, FOLIO_PENDING_SUGGESTION_VERSION, FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FolioDocumentStoryNotFoundError, FolioPendingSuggestionRegistry, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioReviewedViewError, WORD_DIFF_GRANULARITIES, applyFolioAIEditOperations, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, buildAnnotatedBlockText, clampRangeToDocSize, createFolioAIEditSnapshot, createFolioAIEditSnapshotWithStyleResolver, createFolioAITextRangeHandle, createPendingSuggestionSourceSnapshot, diffWordSegments, getCommentAnchorsFromDoc, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, getTrackedChangesFromDoc, hashFolioAIBlockText, isFolioAIContentBlock, isFolioDocumentOperationModeSupported, isFolioResolvedReviewedView, isFolioReviewedView, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, readFolioDocumentSection, resolveFolioAIBlockRange, resolveFolioAITextRange, resolvePassageRange };
+export { FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FOLIO_LINE_SPACING_RULE_VALUES, FOLIO_PARAGRAPH_ALIGNMENT_VALUES, FOLIO_PENDING_SUGGESTION_VERSION, FOLIO_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, FolioDocumentStoryNotFoundError, FolioPendingSuggestionRegistry, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioReviewedViewError, WORD_DIFF_GRANULARITIES, applyFolioAIEditOperations, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, buildAnnotatedBlockText, clampRangeToDocSize, createFolioAIEditSnapshot, createFolioAIEditSnapshotWithStyleResolver, createFolioAITextRangeHandle, createPendingSuggestionSourceSnapshot, diffWordSegments, getCommentAnchorsFromDoc, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOperationRemovedBlockIds, getFolioDocumentOutline, getFolioParaIdFromBlockId, getTrackedChangesFromDoc, hashFolioAIBlockText, isFolioAIContentBlock, isFolioDocumentOperationModeSupported, isFolioResolvedReviewedView, isFolioReviewedView, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, readFolioDocumentSection, resolveFolioAIBlockRange, resolveFolioAITextRange, resolvePassageRange };

package/dist/ai-edits/inline-emphasis.d.ts

@@ -17,15 +17,15 @@
  * Backslashes are ordinary characters (no markdown escapes), so Windows paths
  * and regex survive intact.
  */
-type InlineEmphasisRun = {
+export type InlineEmphasisRun = {
   text: string;
   bold: boolean;
   italic: boolean;
 };
-declare const parseInlineEmphasisRuns: (input: string) => InlineEmphasisRun[];
+export declare const parseInlineEmphasisRuns: (input: string) => InlineEmphasisRun[];
 /** True when `input` contains at least one bold / italic span worth promoting
  *  to real marks; lets callers skip the run rebuild for plain text. */
-declare const hasInlineEmphasis: (input: string) => boolean;
+export declare const hasInlineEmphasis: (input: string) => boolean;
 /**
  * Drop emphasis markers without reconstructing formatting. Used on the
  * tracked-changes replace path, where the word-diff redline cannot carry inline
@@ -33,6 +33,5 @@ declare const hasInlineEmphasis: (input: string) => boolean;
  * input verbatim when no real span is present, so plain prose (and stray
  * single `*` / escaped `\*`) is never reshaped.
  */
-declare const stripInlineEmphasisMarkers: (input: string) => string;
-//#endregion
-export { InlineEmphasisRun, hasInlineEmphasis, parseInlineEmphasisRuns, stripInlineEmphasisMarkers };
+export declare const stripInlineEmphasisMarkers: (input: string) => string;
+//#endregion

package/dist/ai-edits/minimal-replacement.d.ts

@@ -1,26 +1,26 @@
 import { WordDiffSegment } from "./word-diff.js";
 //#region src/ai-edits/minimal-replacement.d.ts
 /** Replace `source.slice(start, end)` with `text`; offsets index the source span. */
-type TextChange = {
+export type TextChange = {
   start: number;
   end: number;
   text: string;
 };
 /** A clean-text span that can only be replaced whole (a field result). */
-type AtomicTextSpan = {
+export type AtomicTextSpan = {
   offset: number;
   length: number;
 };
 /** Common prefix length that never ends between the halves of a surrogate pair. */
-declare const commonPrefixLength: (a: string, b: string) => number;
+export declare const commonPrefixLength: (a: string, b: string) => number;
 /** Common suffix length that never starts between the halves of a surrogate pair. */
-declare const commonSuffixLength: (a: string, b: string) => number;
+export declare const commonSuffixLength: (a: string, b: string) => number;
 /**
  * Edits beyond which a replacement is treated as one rewrite. Bounds the diff
  * at O((N + M) * D) time and O(D^2) memory; a rewrite that large keeps
  * nothing of its source worth aligning to anyway.
  */
-declare const MAX_TOKEN_EDITS = 1024;
+export declare const MAX_TOKEN_EDITS = 1024;
 /**
  * The shortest edit script between two token sequences (Myers, 1986), as
  * segments of joined token text, or `null` past `maxEdits` edits.
@@ -30,7 +30,7 @@ declare const MAX_TOKEN_EDITS = 1024;
  * edit applied directly has no reader to serve, and every token it gives up is
  * text rewritten with someone else's formatting.
  */
-declare const shortestTokenDiff: (before: readonly string[], after: readonly string[], maxEdits?: number) => WordDiffSegment[] | null;
+export declare const shortestTokenDiff: (before: readonly string[], after: readonly string[], maxEdits?: number) => WordDiffSegment[] | null;
 /**
  * The changes from `source` to `replacement`, in source order and disjoint.
  *
@@ -44,14 +44,14 @@ declare const shortestTokenDiff: (before: readonly string[], after: readonly str
  * diff that does not reconstruct both strings exactly (it never should), is
  * one change over the whole span, trimmed the same way.
  */
-declare const planTextChanges: (source: string, replacement: string) => TextChange[];
+export declare const planTextChanges: (source: string, replacement: string) => TextChange[];
 /**
  * The changes a diff's segments describe, in source order and disjoint: each
  * run of `del` and `ins` segments between two `equal` ones is one change,
  * exactly as wide as the segments say. A redline's segments come cut to the
  * granularity its reader asked for, so they are not trimmed further.
  */
-declare const changesFromSegments: (segments: readonly WordDiffSegment[]) => TextChange[];
+export declare const changesFromSegments: (segments: readonly WordDiffSegment[]) => TextChange[];
 /**
  * `changes` widened so none cuts into an atomic span, then merged where the
  * widening made two overlap. A widened change re-emits the source text it
@@ -59,7 +59,7 @@ declare const changesFromSegments: (segments: readonly WordDiffSegment[]) => Tex
  *
  * `spans` are in the same coordinates as the changes (the source span's).
  */
-declare const widenChangesToAtomicSpans: (source: string, changes: readonly TextChange[], spans: readonly AtomicTextSpan[]) => TextChange[];
+export declare const widenChangesToAtomicSpans: (source: string, changes: readonly TextChange[], spans: readonly AtomicTextSpan[]) => TextChange[];
 /**
  * `changes` cut around every atomic span (a field result) that `kept`, another
  * plan of the same replacement, leaves untouched.
@@ -72,8 +72,7 @@ declare const widenChangesToAtomicSpans: (source: string, changes: readonly Text
  * the field's text does not stand in the change's new text exactly where
  * `kept` puts it, the change is left whole.
  */
-declare const keepAtomicSpans: (source: string, replacement: string, changes: readonly TextChange[], kept: readonly TextChange[], spans: readonly AtomicTextSpan[]) => TextChange[];
+export declare const keepAtomicSpans: (source: string, replacement: string, changes: readonly TextChange[], kept: readonly TextChange[], spans: readonly AtomicTextSpan[]) => TextChange[];
 /** `source` with `changes` applied; the invariant the planner owes. */
-declare const applyTextChanges: (source: string, changes: readonly TextChange[]) => string;
-//#endregion
-export { AtomicTextSpan, MAX_TOKEN_EDITS, TextChange, applyTextChanges, changesFromSegments, commonPrefixLength, commonSuffixLength, keepAtomicSpans, planTextChanges, shortestTokenDiff, widenChangesToAtomicSpans };
+export declare const applyTextChanges: (source: string, changes: readonly TextChange[]) => string;
+//#endregion

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

@@ -1,17 +1,30 @@
+import { FolioContentStatedNumbering } from "../compare/content-types.js";
+import { ListKind } from "../docx/listNumberingInstances.js";
 import { FolioAIEditOperation, FolioAIListNumbering, FolioAINewListReference, FolioAIResolvedEditOperation } from "./types.js";
 import { NumberingMap } from "../docx/numberingParser.js";
 //#region src/ai-edits/newListNumbering.d.ts
 /** Whether `numbering` asks for a new list rather than naming an instance. */
-declare const isFolioAINewListReference: (numbering: FolioAIListNumbering) => numbering is FolioAINewListReference;
+export declare const isFolioAINewListReference: (numbering: FolioAIListNumbering) => numbering is FolioAINewListReference;
 type ResolvedNewLists = {
   operations: FolioAIResolvedEditOperation[];
   numbering: NumberingMap | null;
 };
+type DeferredNewListReference = {
+  kind: "deferredNewList";
+  allocation: {
+    format: ListKind;
+  };
+  level: number;
+};
+export type FolioAIStagedEditOperation = FolioAIEditOperation<FolioContentStatedNumbering | DeferredNewListReference>;
+export declare function assertNewListsAllocated(operation: FolioAIStagedEditOperation): asserts operation is FolioAIResolvedEditOperation;
+/** Make requests structurally plannable without allocating document resources. */
+export declare const stageNewListOperations: (operations: readonly FolioAIEditOperation[]) => FolioAIStagedEditOperation[];
 /**
  * Replace every new-list request with a reference to an instance minted for
  * its operation: one instance per operation and kind. `numbering` is the map
  * the batch applies against; the result's map adds the minted instances.
  */
-declare const resolveNewListOperations: (operations: readonly FolioAIEditOperation[], numbering: NumberingMap | null) => ResolvedNewLists;
+export declare const resolveNewListOperations: (operations: readonly FolioAIStagedEditOperation[], numbering: NumberingMap | null) => ResolvedNewLists;
 //#endregion
-export { isFolioAINewListReference, resolveNewListOperations };
+export {};