@stll/folio-core 0.62.0 → 0.63.0

package/dist/ai-edits/removed-blocks.js

@@ -0,0 +1,69 @@
+//#region src/ai-edits/removed-blocks.ts
+const blockContainerKey = ({ table }) => table === void 0 ? "body" : `${String(table.tableIndex)}:${String(table.rowIndex)}:${String(table.cellIndex)}`;
+const isContainerCarrier = (blocks, anchorIndex) => {
+	const anchor = blocks[anchorIndex];
+	if (anchor === void 0) return false;
+	const containerKey = blockContainerKey(anchor);
+	return blocks.slice(anchorIndex + 1).every((block) => blockContainerKey(block) !== containerKey);
+};
+/**
+* The pre-batch block identities an operation removes from the accepted result.
+*
+* Batch operations all address this same block list. Keeping removal in block-id
+* coordinates prevents a structural operation from moving a later operation's
+* numeric position onto a different block.
+*/
+const removedBlockIds = (blocks, operation) => {
+	const removed = /* @__PURE__ */ new Set();
+	const blockId = "range" in operation ? operation.range.blockId : operation.blockId;
+	const anchorIndex = blocks.findIndex(({ id }) => id === blockId);
+	const anchor = blocks[anchorIndex];
+	switch (operation.type) {
+		case "deleteBlock":
+			removed.add(operation.blockId);
+			break;
+		case "mergeBlockWithNext": {
+			const next = anchorIndex < 0 ? void 0 : blocks[anchorIndex + 1];
+			if (next !== void 0) removed.add(next.id);
+			break;
+		}
+		case "deleteTable":
+			if (anchor?.table !== void 0) {
+				for (const block of blocks) if (block.table?.tableIndex === anchor.table.tableIndex) removed.add(block.id);
+			}
+			break;
+		case "deleteTableRow":
+			if (anchor?.table !== void 0) {
+				for (const block of blocks) if (block.table?.tableIndex === anchor.table.tableIndex && block.table.rowIndex === anchor.table.rowIndex) removed.add(block.id);
+			}
+			break;
+		case "deleteTableColumn": if (anchor?.table !== void 0) for (const block of blocks) {
+			const table = block.table;
+			if (table?.tableIndex === anchor.table.tableIndex && table.gridColumnIndex === anchor.table.gridColumnIndex && table.columnSpan === 1) removed.add(block.id);
+		}
+	}
+	return removed;
+};
+/**
+* The pre-batch block identities an operation removes from the accepted result.
+*
+* Batch operations all address this same block list. Keeping removal in block-id
+* coordinates prevents a structural operation from moving a later operation's
+* numeric position onto a different block.
+*/
+const getFolioDocumentOperationRemovedBlockIds = (blocks, operation) => removedBlockIds(blocks, operation);
+const getTrackedFolioDocumentOperationRemovedBlockIds = (blocks, operation) => operation.type === "mergeBlockWithNext" ? /* @__PURE__ */ new Set() : removedBlockIds(blocks, operation);
+const getTrackedFolioDocumentOperationCarrierBlockId = (blocks, operation, previouslyRemovedBlockIds) => {
+	if (operation.type !== "mergeBlockWithNext") return void 0;
+	const anchorIndex = blocks.findIndex(({ id }) => id === operation.blockId);
+	const anchor = blocks[anchorIndex];
+	if (anchor === void 0) return void 0;
+	const containerKey = blockContainerKey(anchor);
+	let carrierIndex = anchorIndex + 1;
+	while (blocks[carrierIndex + 1] !== void 0 && blockContainerKey(blocks[carrierIndex + 1]) === containerKey) carrierIndex++;
+	const carrier = blocks[carrierIndex];
+	if (carrier === void 0 || !isContainerCarrier(blocks, carrierIndex)) return void 0;
+	return blocks.slice(anchorIndex + 1, carrierIndex + 1).every(({ id }) => previouslyRemovedBlockIds.has(id)) ? carrier.id : void 0;
+};
+//#endregion
+export { getFolioDocumentOperationRemovedBlockIds, getTrackedFolioDocumentOperationCarrierBlockId, getTrackedFolioDocumentOperationRemovedBlockIds };

package/dist/ai-edits/result-validation.d.ts

@@ -3,7 +3,7 @@ import { Node } from "prosemirror-model";
 import { ValidateDocumentModelIssue } from "@stll/docx-core";
 //#region src/ai-edits/result-validation.d.ts
 /** What the story's package knows that the story itself does not. */
-type FolioOperationResultValidationContext = {
+export type FolioOperationResultValidationContext = {
   /**
    * The document's numbering definitions; `null` when the story states none,
    * `undefined` when it cannot say (no numbering plugin), which leaves
@@ -23,7 +23,6 @@ type FolioOperationResultValidationContext = {
  * of `after` that the same window of `before` did not already report. Empty
  * when the result is as saveable as the story it started from.
  */
-declare const findIntroducedModelErrors: (before: Node, after: Node, context: FolioOperationResultValidationContext) => ValidateDocumentModelIssue[];
-declare const describeModelError: ({ path, message }: ValidateDocumentModelIssue) => string;
-//#endregion
-export { FolioOperationResultValidationContext, describeModelError, findIntroducedModelErrors };
+export declare const findIntroducedModelErrors: (before: Node, after: Node, context: FolioOperationResultValidationContext) => ValidateDocumentModelIssue[];
+export declare const describeModelError: ({ path, message }: ValidateDocumentModelIssue) => string;
+//#endregion

package/dist/ai-edits/result-validation.js

@@ -1,7 +1,7 @@
-import { validateFolioDocumentModel } from "../docx/modelValidation.js";
 import { proseDocToBlocks } from "../prosemirror/conversion/fromProseDoc.js";
 import { sectionPropertiesOf } from "../prosemirror/sectionCarrier.js";
 import { anchoredCommentIdsInProseDoc } from "./comment-lifecycle.js";
+import { validateDocumentModel } from "@stll/docx-core";
 import { Fragment } from "prosemirror-model";
 //#region src/ai-edits/result-validation.ts
 /**
@@ -97,7 +97,7 @@ const windowErrors = ({ doc, from, to, context, knownParts, knownCommentIds }) =
 			severity: "error"
 		}];
 	}
-	return validateFolioDocumentModel({ package: {
+	const document = { package: {
 		document: {
 			content,
 			comments: [...[...knownCommentIds ?? []].map((id) => syntheticComment(id, "")), ...context.createdCommentIds.filter((id) => !knownCommentIds?.has(id)).map((id) => syntheticComment(id, context.commentAuthor ?? ""))]
@@ -107,7 +107,8 @@ const windowErrors = ({ doc, from, to, context, knownParts, knownCommentIds }) =
 			headers: knownParts.headers,
 			footers: knownParts.footers
 		}
-	} }).issues.filter((issue) => issue.severity === "error" && !(context.numbering === void 0 && issue.path.endsWith(".numPr.numId"))).map(({ path, message, severity }) => ({
+	} };
+	return validateDocumentModel(document).issues.filter((issue) => issue.severity === "error" && !(context.numbering === void 0 && issue.path.endsWith(".numPr.numId"))).map(({ path, message, severity }) => ({
 		path: rebasePath(path, from),
 		message,
 		severity

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

@@ -4,7 +4,7 @@ type SeparateRevisionStretchesOptions = {
   tr: Transaction;
   revisionSeed: number;
 };
-type SeparatedRevisionStretches = {
+export type SeparatedRevisionStretches = {
   nextRevisionId: number;
   /** Each fresh id, with the revision whose stretch it now names. */
   minted: {
@@ -12,6 +12,6 @@ type SeparatedRevisionStretches = {
     from: number;
   }[];
 };
-declare const separateRevisionStretches: ({ tr, revisionSeed }: SeparateRevisionStretchesOptions) => SeparatedRevisionStretches;
+export declare const separateRevisionStretches: ({ tr, revisionSeed }: SeparateRevisionStretchesOptions) => SeparatedRevisionStretches;
 //#endregion
-export { SeparatedRevisionStretches, separateRevisionStretches };
+export {};

package/dist/ai-edits/revisionStretches.js

@@ -2,6 +2,23 @@ import { expectRunPropertyChangeMarkAttrs, expectTrackedChangeMarkAttrs } from "
 import { applyMarksToRunFormattingRepresentation, expandRunFormattingCarrier } from "../prosemirror/runFormattingInlineCarriers.js";
 import { panic } from "better-result";
 //#region src/ai-edits/revisionStretches.ts
+/**
+* One id per stretch of an inline revision.
+*
+* An edit inside a pending insertion (or a replacement whose words differ in
+* several places) leaves one revision in stretches with other content between
+* them. A saved package writes each stretch as a wrapper of its own, and
+* `w:id` is unique per wrapper, so the save would give every stretch after the
+* first a fresh id: once reopened they are separate changes, each accepted or
+* rejected alone. The batch gives them those ids when it makes them, so the
+* reviewer lists, resolves, saves and reopens the same changes.
+*
+* A stretch is what the reader lists as one change: the revision's content in
+* one paragraph, uninterrupted but for comment references.
+* A formatting revision instead belongs to one serialized run carrier. A
+* later edit can split that carrier without changing its property mark, so
+* each resulting carrier gets its own id through the same allocator.
+*/
 const INLINE_REVISION_MARKS = /* @__PURE__ */ new Set(["insertion", "deletion"]);
 const separateRevisionStretches = ({ tr, revisionSeed }) => {
 	let nextRevisionId = revisionSeed;

package/dist/ai-edits/scoped-reading.d.ts

@@ -1,8 +1,7 @@
 import { FolioAIEditSnapshot, FolioDocumentOutline, FolioDocumentSectionHandle, FolioDocumentSectionReadResult } from "./types.js";
 //#region src/ai-edits/scoped-reading.d.ts
 /** Build a flat, ordered outline with stable handles and explicit parents. */
-declare const getFolioDocumentOutline: (snapshot: FolioAIEditSnapshot) => FolioDocumentOutline;
+export declare const getFolioDocumentOutline: (snapshot: FolioAIEditSnapshot) => FolioDocumentOutline;
 /** Resolve one heading section against a fresh snapshot without guessing. */
-declare const readFolioDocumentSection: (snapshot: FolioAIEditSnapshot, handle: FolioDocumentSectionHandle) => FolioDocumentSectionReadResult;
-//#endregion
-export { getFolioDocumentOutline, readFolioDocumentSection };
+export declare const readFolioDocumentSection: (snapshot: FolioAIEditSnapshot, handle: FolioDocumentSectionHandle) => FolioDocumentSectionReadResult;
+//#endregion

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

@@ -1,29 +1,30 @@
 import { FolioAIBlock, FolioAIBlockStructuralBoundary, FolioAIEditSnapshot, FolioAITextRangeHandle } from "./types.js";
 import { NoteReferenceLabels } from "./note-references.js";
 import { CleanBlockText } from "./clean-text.js";
+import { NumberingMap } from "../docx/numberingParser.js";
 import { RunStyleResolver } from "../prosemirror/runStyleFormatting.js";
 import { Node } from "prosemirror-model";
 //#region src/ai-edits/snapshot.d.ts
 /** @internal Numbering references collected during the snapshot's document walk. */
-declare const numberingReferenceKeysOf: (snapshot: FolioAIEditSnapshot) => readonly string[];
+export declare const numberingReferenceKeysOf: (snapshot: FolioAIEditSnapshot) => readonly string[];
 /** @internal Tables collected during the snapshot's document walk. */
-declare const storyTablesOf: (snapshot: FolioAIEditSnapshot) => readonly FolioStoryTable[];
+export declare const storyTablesOf: (snapshot: FolioAIEditSnapshot) => readonly FolioStoryTable[];
 /** @internal The immutable ProseMirror document that produced this snapshot. */
-declare const sourceDocumentOf: (snapshot: FolioAIEditSnapshot) => Node;
+export declare const sourceDocumentOf: (snapshot: FolioAIEditSnapshot) => Node;
 /** @internal Style context that produced the snapshot's authored run properties. */
-declare const styleResolverOf: (snapshot: FolioAIEditSnapshot) => RunStyleResolver | null;
+export declare const styleResolverOf: (snapshot: FolioAIEditSnapshot) => RunStyleResolver | null;
 /**
  * Derive a comparison-only view with concrete numbering references rebound.
  * Rebuild from the remapped source document so blocks, anchors, table nodes,
  * and operation templates retain one canonical set of numbering references.
  */
-declare const remapFolioAIEditSnapshotNumberingReferences: (snapshot: FolioAIEditSnapshot, numIdMap: ReadonlyMap<number, number>) => FolioAIEditSnapshot;
+export declare const remapFolioAIEditSnapshotNumberingReferences: (snapshot: FolioAIEditSnapshot, numIdMap: ReadonlyMap<number, number>) => FolioAIEditSnapshot;
 /**
  * Detach external hyperlink relationship ids before copying a story into a
  * different package. The serializer allocates relationship ids for the
  * receiving part; bookmark targets remain package-local and are refused.
  */
-declare const detachFolioAIEditSnapshotExternalHyperlinks: (snapshot: FolioAIEditSnapshot) => FolioAIEditSnapshot | null;
+export declare const detachFolioAIEditSnapshotExternalHyperlinks: (snapshot: FolioAIEditSnapshot) => FolioAIEditSnapshot | null;
 type RemapFolioAIEditSnapshotStyleReferencesOptions = {
   snapshot: FolioAIEditSnapshot;
   styleIdMap: ReadonlyMap<string, string>;
@@ -32,8 +33,8 @@ type RemapFolioAIEditSnapshotStyleReferencesOptions = {
   reconcileAuthoredFormatting?: boolean;
 };
 /** Rebind imported style identifiers while retaining the source formatting context. */
-declare const remapFolioAIEditSnapshotStyleReferences: ({ snapshot, styleIdMap, defaultParagraphStyleId, importedStyleResolver, reconcileAuthoredFormatting }: RemapFolioAIEditSnapshotStyleReferencesOptions) => FolioAIEditSnapshot;
-declare const normalizeFolioAIBlockText: (text: string) => string;
+export declare const remapFolioAIEditSnapshotStyleReferences: ({ snapshot, styleIdMap, defaultParagraphStyleId, importedStyleResolver, reconcileAuthoredFormatting }: RemapFolioAIEditSnapshotStyleReferencesOptions) => FolioAIEditSnapshot;
+export declare const normalizeFolioAIBlockText: (text: string) => string;
 /**
  * Whether a block carries text a reader would see.
  *
@@ -48,7 +49,7 @@ declare const normalizeFolioAIBlockText: (text: string) => string;
  * that it wants content by calling this. One helper, so "what counts as
  * content" has a single answer; five inline emptiness checks would drift.
  */
-declare const isFolioAIContentBlock: ({ text }: Pick<FolioAIBlock, "text">) => boolean;
+export declare const isFolioAIContentBlock: ({ text }: Pick<FolioAIBlock, "text">) => boolean;
 /**
  * The block that content appended to the end of a story hangs from: the last
  * paragraph at body level.
@@ -65,8 +66,8 @@ declare const isFolioAIContentBlock: ({ text }: Pick<FolioAIBlock, "text">) => b
  * `null`; callers that can place a peer beside the table use its outer boundary
  * instead.
  */
-declare const trailingBodyBlockId: ({ blocks }: FolioAIEditSnapshot) => string | null;
-declare const hashFolioAIBlockText: (text: string) => string;
+export declare const trailingBodyBlockId: ({ blocks }: FolioAIEditSnapshot) => string | null;
+export declare const hashFolioAIBlockText: (text: string) => string;
 /**
  * Canonical public projection of the clean view's inline structure.
  *
@@ -75,16 +76,16 @@ declare const hashFolioAIBlockText: (text: string) => string;
  * note reference is published: its marker reads like text, and a reader has to
  * be able to tell it is not.
  */
-declare const projectFolioAIBlockStructuralBoundaries: ({ structuralBoundaries }: Pick<CleanBlockText, "structuralBoundaries">) => readonly FolioAIBlockStructuralBoundary[];
+export declare const projectFolioAIBlockStructuralBoundaries: ({ structuralBoundaries }: Pick<CleanBlockText, "structuralBoundaries">) => readonly FolioAIBlockStructuralBoundary[];
 /** Stable precondition fingerprint for a block's zero-width structure. */
-declare const hashFolioAIBlockStructuralBoundaries: (cleanBlock: Pick<CleanBlockText, "structuralBoundaries">) => string;
+export declare const hashFolioAIBlockStructuralBoundaries: (cleanBlock: Pick<CleanBlockText, "structuralBoundaries">) => string;
 type CreateFolioAITextRangeHandleOptions = {
   blockId: string;
   text: string;
   startOffset: number;
   endOffset: number;
 };
-declare const createFolioAITextRangeHandle: ({ blockId, text, startOffset, endOffset }: CreateFolioAITextRangeHandleOptions) => FolioAITextRangeHandle | null;
+export declare const createFolioAITextRangeHandle: ({ blockId, text, startOffset, endOffset }: CreateFolioAITextRangeHandleOptions) => FolioAITextRangeHandle | null;
 /**
  * True for a `tableRow` marked `hidden` (OOXML `w:trPr/w:hidden` — Word never
  * renders the row). Nothing inside such a row may surface its text to the
@@ -92,7 +93,7 @@ declare const createFolioAITextRangeHandle: ({ blockId, text, startOffset, endOf
  * instructions into a row that no human ever sees. The walk skips the row's
  * whole subtree, so a table nested inside a hidden row is hidden with it.
  */
-declare const isHiddenTableRow: (node: Node) => boolean;
+export declare const isHiddenTableRow: (node: Node) => boolean;
 /**
  * The marker every footnote/endnote reference of a story reads as: numbered in
  * reading order over the blocks {@link createFolioAIEditSnapshot} reads (a
@@ -103,7 +104,7 @@ declare const isHiddenTableRow: (node: Node) => boolean;
  * whose walk meets no reference (most documents, and every revision-stats
  * read) never pays for a second walk of the story.
  */
-declare const collectNoteReferenceLabels: (doc: Node) => NoteReferenceLabels;
+export declare const collectNoteReferenceLabels: (doc: Node) => NoteReferenceLabels;
 /**
  * @internal The markers a comparison reads a revised story's references as:
  * each note the base story references keeps the base's marker, and a note
@@ -116,15 +117,15 @@ declare const collectNoteReferenceLabels: (doc: Node) => NoteReferenceLabels;
  * reference's marker identical, and makes a reference the comparison brings
  * write the marker the base story (which the edits resolve against) gives it.
  */
-declare const alignedNoteReferenceLabels: (base: Node, revised: Node) => NoteReferenceLabels;
+export declare const alignedNoteReferenceLabels: (base: Node, revised: Node) => NoteReferenceLabels;
 /**
  * @internal The same snapshot with every note reference read through `labels`
  * rather than the story's own numbering. Only the text and structural
  * boundaries can change: block ids, anchors and the source document do not.
  */
-declare const relabelFolioAIEditSnapshotNoteReferences: (snapshot: FolioAIEditSnapshot, labels: NoteReferenceLabels) => FolioAIEditSnapshot;
+export declare const relabelFolioAIEditSnapshotNoteReferences: (snapshot: FolioAIEditSnapshot, labels: NoteReferenceLabels) => FolioAIEditSnapshot;
 /** One table of a story, numbered the way {@link createFolioAIEditSnapshot} numbers it. */
-type FolioStoryTable = {
+export type FolioStoryTable = {
   /** Document-order index over every table, nested ones included. */
   index: number;
   /** The table node's position in the story document. */
@@ -138,9 +139,9 @@ type FolioStoryTable = {
  * Uses the same traversal classification as the snapshot's integrated census,
  * so both surfaces skip and number the same nodes in the same order.
  */
-declare const folioStoryTables: (doc: Node) => FolioStoryTable[];
-declare const createFolioAIEditSnapshot: (doc: Node) => FolioAIEditSnapshot;
+export declare const folioStoryTables: (doc: Node) => FolioStoryTable[];
+export declare const createFolioAIEditSnapshot: (doc: Node) => FolioAIEditSnapshot;
 /** @internal Use for an EditorState that owns the document's style resolver. */
-declare const createFolioAIEditSnapshotWithStyleResolver: (doc: Node, styleResolver: RunStyleResolver | null) => FolioAIEditSnapshot;
+export declare const createFolioAIEditSnapshotWithStyleResolver: (doc: Node, styleResolver: RunStyleResolver | null, numbering?: NumberingMap | null) => FolioAIEditSnapshot;
 //#endregion
-export { FolioStoryTable, alignedNoteReferenceLabels, collectNoteReferenceLabels, createFolioAIEditSnapshot, createFolioAIEditSnapshotWithStyleResolver, createFolioAITextRangeHandle, detachFolioAIEditSnapshotExternalHyperlinks, folioStoryTables, hashFolioAIBlockStructuralBoundaries, hashFolioAIBlockText, isFolioAIContentBlock, isHiddenTableRow, normalizeFolioAIBlockText, numberingReferenceKeysOf, projectFolioAIBlockStructuralBoundaries, relabelFolioAIEditSnapshotNoteReferences, remapFolioAIEditSnapshotNumberingReferences, remapFolioAIEditSnapshotStyleReferences, sourceDocumentOf, storyTablesOf, styleResolverOf, trailingBodyBlockId };
+export {};

package/dist/ai-edits/snapshot.js

@@ -5,7 +5,7 @@ import { OPAQUE_REVISION_CARRIER_READER_DIAGNOSTIC, isOpaqueNestedRowMarkup, opa
 import { recreateProseNodeWithParagraphPropertySource } from "../docx/paragraphPropertySource.js";
 import { expectCharacterStyleMarkAttrs, expectHyperlinkMarkAttrs, expectParagraphAttrs, expectRunFormattingOverrideMarkAttrs } from "../prosemirror/attrs/index.js";
 import { createListLabelCounter } from "../prosemirror/listLabels.js";
-import { effectiveParagraphNumberingReference, paragraphNumberingAttr, paragraphNumberingSourcesFromBoundary, readParagraphNumberingAttr } from "../prosemirror/numberingAttr.js";
+import { paragraphNumberingAttr, readParagraphNumberingAttr } from "../prosemirror/numberingAttr.js";
 import { readOutlineLevelAttr } from "../prosemirror/outlineLevelAttr.js";
 import { directParagraphAlignment } from "../prosemirror/paragraphAlignment.js";
 import { directParagraphIndentation } from "../prosemirror/paragraphIndentation.js";
@@ -423,7 +423,7 @@ const getTableLocation = ({ path, blockIndex, tableIndexByStart }) => {
 		};
 	}
 };
-const createFolioAIEditSnapshotInternal = (doc, styleResolver, noteReferenceLabels) => {
+const createFolioAIEditSnapshotInternal = (doc, styleResolver, noteReferenceLabels, numbering) => {
 	const builtInStyles = styleResolver?.builtInStyles ?? EMPTY_BUILT_IN_STYLE_INDEX;
 	const noteReferences = noteReferenceLabels ? {
 		labelOf: noteReferenceLabels.labelOf,
@@ -433,7 +433,7 @@ const createFolioAIEditSnapshotInternal = (doc, styleResolver, noteReferenceLabe
 	const hashCounts = /* @__PURE__ */ new Map();
 	const usedBlockIds = /* @__PURE__ */ new Set();
 	const numberingReferenceKeys = /* @__PURE__ */ new Set();
-	const nextListLabel = createListLabelCounter();
+	const nextListLabel = createListLabelCounter(numbering ?? null);
 	const tables = [];
 	const tableIndexByStart = /* @__PURE__ */ new Map();
 	const path = [];
@@ -532,13 +532,19 @@ const createFolioAIEditSnapshotInternal = (doc, styleResolver, noteReferenceLabe
 		}
 		usedBlockIds.add(id);
 		const headingLevel = getHeadingLevel(node, builtInStyles);
-		const listLabel = node.type.name === "paragraph" ? nextListLabel(expectParagraphAttrs(node)) : void 0;
-		const kind = getBlockKind(headingLevel, listLabel);
+		const listAttrs = node.type.name === "paragraph" ? snapshotListAttrs(expectParagraphAttrs(node), styleResolver) : void 0;
+		const visibleList = listAttrs === void 0 ? void 0 : nextListLabel(listAttrs);
+		const listLabel = visibleList?.label;
+		const kind = getBlockKind(headingLevel, visibleList?.kind === "marker");
 		const displayLabel = getDisplayLabel(node, listLabel, kind === "heading");
 		const styleId = getStyleId(node);
 		const directOutlineLevel = node.type.name === "paragraph" ? expectParagraphAttrs(node)._originalFormatting?.outlineLevel : void 0;
-		const listReference = getListReference(node);
-		const numberingReferenceKey = getNumberingReferenceKey(node);
+		const numberedListReference = visibleList?.numbering;
+		const listReference = visibleList?.kind !== "marker" || numberedListReference === void 0 ? void 0 : {
+			numId: numberedListReference.numId,
+			level: numberedListReference.ilvl
+		};
+		const numberingReferenceKey = listReference ? `${String(listReference.numId)}:${String(listReference.level)}` : null;
 		if (numberingReferenceKey) numberingReferenceKeys.add(numberingReferenceKey);
 		const directAlignment = getDirectAlignment(node);
 		const directSpacing = getDirectSpacing(node);
@@ -624,7 +630,7 @@ const getOpaqueCarrierDiagnostic = (xml, readerText) => {
 };
 const createFolioAIEditSnapshot = (doc) => createFolioAIEditSnapshotInternal(doc, null);
 /** @internal Use for an EditorState that owns the document's style resolver. */
-const createFolioAIEditSnapshotWithStyleResolver = (doc, styleResolver) => createFolioAIEditSnapshotInternal(doc, styleResolver);
+const createFolioAIEditSnapshotWithStyleResolver = (doc, styleResolver, numbering) => createFolioAIEditSnapshotInternal(doc, styleResolver, void 0, numbering);
 /**
 * What a reader sees the block as, heading first: a numbered heading (`1.
 * Scope`, numbered through its style or its own `w:numPr`) is a heading that
@@ -632,12 +638,38 @@ const createFolioAIEditSnapshotWithStyleResolver = (doc, styleResolver) => creat
 * `listReference`. A paragraph is a list item when it shows a marker, which is
 * when it has a label. One whose numbering shows none (a `w:vanish` level, a
 * level its list does not define, or `w:numId="0"` cancelling its style's
-* numbering) reads as prose and is a paragraph, keeping its `statedNumbering` and
-* effective `listReference`.
+* numbering) reads as prose and is a paragraph, keeping its `statedNumbering`
+* without claiming effective list membership.
 */
-const getBlockKind = (headingLevel, listLabel) => {
+const getBlockKind = (headingLevel, showsMarker) => {
 	if (headingLevel !== void 0) return "heading";
-	return listLabel === void 0 ? "paragraph" : "listItem";
+	return showsMarker ? "listItem" : "paragraph";
+};
+/** Rebind cached style numbering to the current style before the owner reads it. */
+const snapshotListAttrs = (attrs, styleResolver) => {
+	if (styleResolver === null) return attrs;
+	if (!(typeof attrs.styleId === "string" || attrs.numPrFromStyle !== null && attrs.numPrFromStyle !== void 0 || attrs.numPr?.kind === "levelOnly" || attrs._propertyChanges?.some(({ previousFormatting }) => previousFormatting !== void 0 && (typeof previousFormatting.styleId === "string" || previousFormatting.numPrFromStyle !== null && previousFormatting.numPrFromStyle !== void 0 || previousFormatting.numPr?.kind === "levelOnly")) === true)) return attrs;
+	const styleNumbering = (styleId) => styleResolver.resolveParagraphStyle(typeof styleId === "string" ? styleId : null).paragraphFormatting?.numPr;
+	const styleNumberingAttr = (styleId) => {
+		const numbering = styleNumbering(styleId);
+		return numbering === void 0 ? null : paragraphNumberingAttr(numbering);
+	};
+	const currentStyleNumbering = styleNumberingAttr(attrs.styleId);
+	const currentAttrs = { ...attrs };
+	delete currentAttrs.numPrFromStyle;
+	const cancelsStaleStyleNumbering = (attrs.numPr === null || attrs.numPr === void 0) && currentStyleNumbering === null && attrs._propertyChanges !== null && attrs._propertyChanges !== void 0 && attrs._propertyChanges.length > 0;
+	return {
+		...currentAttrs,
+		...cancelsStaleStyleNumbering ? { numPr: paragraphNumberingAttr({ kind: "none" }) } : {},
+		...currentStyleNumbering === null ? {} : { numPrFromStyle: currentStyleNumbering },
+		...attrs._propertyChanges === null || attrs._propertyChanges === void 0 ? {} : { _propertyChanges: attrs._propertyChanges.map((change) => ({
+			...change,
+			...change.previousFormatting === void 0 ? {} : { previousFormatting: {
+				...change.previousFormatting,
+				numPrFromStyle: styleNumberingAttr(change.previousFormatting.styleId)
+			} }
+		})) }
+	};
 };
 /** The block's 1-based heading level, as {@link resolveHeadingLevel} classifies it. */
 const getHeadingLevel = (node, styles) => {
@@ -653,23 +685,6 @@ const getDisplayLabel = (node, listLabel, isHeading) => {
 	const styleId = node.attrs["styleId"];
 	if (isHeading && typeof styleId === "string") return styleId;
 };
-const getListReference = (node) => {
-	const numbering = effectiveParagraphNumberingReference(paragraphNumberingSourcesFromBoundary({
-		numPr: readParagraphNumberingAttr(node.attrs["numPr"]),
-		numPrFromStyle: readParagraphNumberingAttr(node.attrs["numPrFromStyle"])
-	}));
-	return numbering ? {
-		numId: numbering.numId,
-		level: numbering.ilvl
-	} : void 0;
-};
-const getNumberingReferenceKey = (node) => {
-	const numbering = effectiveParagraphNumberingReference(paragraphNumberingSourcesFromBoundary({
-		numPr: readParagraphNumberingAttr(node.attrs["numPr"]),
-		numPrFromStyle: readParagraphNumberingAttr(node.attrs["numPrFromStyle"])
-	}));
-	return numbering ? `${String(numbering.numId)}:${String(numbering.ilvl)}` : null;
-};
 const getStyleId = (node) => {
 	const styleId = node.attrs["styleId"];
 	return typeof styleId === "string" && styleId.length > 0 ? styleId : void 0;
@@ -777,7 +792,6 @@ const getPreviewRunStyle = (marks, defaultStyle) => {
 			if (color !== void 0) style.color = color;
 			break;
 		}
-		default: break;
 	}
 	const overrideMark = marks.find(({ type }) => type.name === RUN_FORMATTING_OVERRIDE_MARK);
 	if (!overrideMark) return style;

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

@@ -13,11 +13,11 @@ type TrackedTableCellRectangleMutationOptions = TableCellRectangleMutationOption
   author: string;
   date: string;
 };
-declare const mergeTableRectangle: ({ tr, tablePosition, table, rectangle }: TableCellRectangleMutationOptions) => Transaction | null;
-declare const mergeTrackedVerticalTableCells: ({ tr, tablePosition, table, rectangle, revisionId, author, date }: TrackedTableCellRectangleMutationOptions) => Transaction | null;
-declare const splitTableRectangle: ({ tr, tablePosition, table, rectangle }: TableCellRectangleMutationOptions) => Transaction | null;
-declare const splitTrackedVerticalTableCell: ({ tr, tablePosition, table, rectangle, revisionId, author, date }: TrackedTableCellRectangleMutationOptions) => Transaction | null;
+export declare const mergeTableRectangle: ({ tr, tablePosition, table, rectangle }: TableCellRectangleMutationOptions) => Transaction | null;
+export declare const mergeTrackedVerticalTableCells: ({ tr, tablePosition, table, rectangle, revisionId, author, date }: TrackedTableCellRectangleMutationOptions) => Transaction | null;
+export declare const splitTableRectangle: ({ tr, tablePosition, table, rectangle }: TableCellRectangleMutationOptions) => Transaction | null;
+export declare const splitTrackedVerticalTableCell: ({ tr, tablePosition, table, rectangle, revisionId, author, date }: TrackedTableCellRectangleMutationOptions) => Transaction | null;
 /** A cell holding one empty paragraph: all a tracked merge may fold away. */
-declare const isEmptyTableCell: (cell: Node) => boolean;
+export declare const isEmptyTableCell: (cell: Node) => boolean;
 //#endregion
-export { isEmptyTableCell, mergeTableRectangle, mergeTrackedVerticalTableCells, splitTableRectangle, splitTrackedVerticalTableCell };
+export {};

package/dist/ai-edits/table-cell-mutations.js

@@ -160,7 +160,8 @@ const splitTableRectangle = ({ tr, tablePosition, table, rectangle }) => {
 	if (rectangle.left < 0 || rectangle.top < 0 || rectangle.right > map.width || rectangle.bottom > map.height || rectangle.left >= rectangle.right || rectangle.top >= rectangle.bottom || rectangle.right - rectangle.left === 1 && rectangle.bottom - rectangle.top === 1) return null;
 	const cellPosition = map.map[rectangle.top * map.width + rectangle.left];
 	if (cellPosition === void 0) return null;
-	if (!tableRectanglesEqual(map.findCell(cellPosition), rectangle)) return null;
+	const cellRectangle = map.findCell(cellPosition);
+	if (!tableRectanglesEqual(cellRectangle, rectangle)) return null;
 	const cell = table.nodeAt(cellPosition);
 	if (!cell) return null;
 	const colspan = cell.attrs["colspan"];
@@ -203,7 +204,8 @@ const splitTrackedVerticalTableCell = ({ tr, tablePosition, table, rectangle, re
 	if (rectangle.right - rectangle.left !== 1 || rectangle.bottom - rectangle.top < 2 || rectangle.left < 0 || rectangle.top < 0 || rectangle.right > map.width || rectangle.bottom > map.height) return null;
 	const relativeCellPosition = map.map[rectangle.top * map.width + rectangle.left];
 	if (relativeCellPosition === void 0) return null;
-	if (!tableRectanglesEqual(map.findCell(relativeCellPosition), rectangle)) return null;
+	const cellRectangle = map.findCell(relativeCellPosition);
+	if (!tableRectanglesEqual(cellRectangle, rectangle)) return null;
 	const cell = table.nodeAt(relativeCellPosition);
 	if (!cell) return null;
 	const attrs = expectTableCellAttrs(cell);
@@ -264,12 +266,13 @@ const isEmptyTableCell = (cell) => cell.childCount === 1 && cell.firstChild?.isT
 const trackedSplitCellFromStoredSource = ({ origin, source, marker }) => {
 	if (source.formatting?.gridSpan !== void 0 && source.formatting.gridSpan > 1) return null;
 	const formatting = formattingWithoutVerticalMerge(source.formatting);
-	const converted = standaloneTableCellToProseMirror({
+	const restoredSource = {
 		type: "tableCell",
 		...formatting ? { formatting } : {},
 		...source.propertyChanges ? { propertyChanges: source.propertyChanges } : {},
 		content: source.content
-	}, origin.type.name === "tableHeader" ? "tableHeader" : "tableCell");
+	};
+	const converted = standaloneTableCellToProseMirror(restoredSource, origin.type.name === "tableHeader" ? "tableHeader" : "tableCell");
 	const compatible = Result.try(() => origin.type.schema.nodeFromJSON(converted.toJSON())).unwrapOr(null);
 	if (!compatible) return null;
 	return compatible.type.create({

package/dist/ai-edits/table-geometry.d.ts

@@ -3,13 +3,13 @@ import { Node } from "prosemirror-model";
 import { Transaction } from "prosemirror-state";
 //#region src/ai-edits/table-geometry.d.ts
 /** Where a cell sits: which table, which row of it, which cell of that row. */
-type TableCellCoordinate = {
+export type TableCellCoordinate = {
   tableIndex: number;
   rowIndex: number;
   cellIndex: number;
 };
 /** One base cell and the target cell it was aligned with. */
-type TableGeometryPairing = {
+export type TableGeometryPairing = {
   base: TableCellCoordinate;
   target: TableCellCoordinate;
 };
@@ -26,7 +26,7 @@ type MatchTableGeometryOptions = {
     idSeed: number;
   };
 };
-type MatchTableGeometryResult = {
+export type MatchTableGeometryResult = {
   /** First revision id a following batch may allocate. */
   nextRevisionId: number;
   /** Tables, rows and cells whose properties the match moved. */
@@ -38,7 +38,7 @@ type MatchTableGeometryResult = {
  * their own lines rather than being folded into their parent's, so a
  * difference names the table it is in.
  */
-declare const projectTableGeometry: (tables: readonly FolioStoryTable[]) => string[];
+export declare const projectTableGeometry: (tables: readonly FolioStoryTable[]) => string[];
 /**
  * Copy a paired table's, row's and cell's properties from the document it was
  * compared against, recording the previous set so a reject restores it.
@@ -51,6 +51,6 @@ declare const projectTableGeometry: (tables: readonly FolioStoryTable[]) => stri
  * without restructuring the rows around it leaves the map inconsistent with
  * its own grid. That is the rule a reject of a `w:tcPrChange` follows too.
  */
-declare const matchTableGeometry: ({ tr, baseTables, targetTables, pairings, revision }: MatchTableGeometryOptions) => MatchTableGeometryResult;
+export declare const matchTableGeometry: ({ tr, baseTables, targetTables, pairings, revision }: MatchTableGeometryOptions) => MatchTableGeometryResult;
 //#endregion
-export { MatchTableGeometryResult, TableCellCoordinate, TableGeometryPairing, matchTableGeometry, projectTableGeometry };
+export {};

package/dist/ai-edits/table-mutation-plan.d.ts

@@ -1,12 +1,12 @@
 import { Node } from "prosemirror-model";
 //#region src/ai-edits/table-mutation-plan.d.ts
-type TableRectangle = {
+export type TableRectangle = {
   left: number;
   top: number;
   right: number;
   bottom: number;
 };
-type TableMutationPlanTarget = {
+export type TableMutationPlanTarget = {
   type: "none";
 } | {
   type: "tableStructure";
@@ -33,7 +33,7 @@ type TableMutationPlan<T> = {
   executable: T[];
   skipped: TableMutationPlanSkip[];
 };
-declare const planTableMutations: <T>(candidates: readonly TableMutationPlanCandidate<T>[], doc: Node) => TableMutationPlan<T>;
-declare const tableRectanglesEqual: (left: TableRectangle, right: TableRectangle) => boolean;
+export declare const planTableMutations: <T>(candidates: readonly TableMutationPlanCandidate<T>[], doc: Node) => TableMutationPlan<T>;
+export declare const tableRectanglesEqual: (left: TableRectangle, right: TableRectangle) => boolean;
 //#endregion
-export { TableMutationPlanTarget, TableRectangle, planTableMutations, tableRectanglesEqual };
+export {};

package/dist/ai-edits/table-mutation-plan.js

@@ -12,10 +12,7 @@ const planTableMutations = (candidates, doc) => {
 		case "mergeCells":
 			mergeTables.add(target.tablePosition);
 			break;
-		case "splitCell":
-			splitTables.add(target.tablePosition);
-			break;
-		case "none": break;
+		case "splitCell": splitTables.add(target.tablePosition);
 	}
 	const mergeRectanglesByTable = /* @__PURE__ */ new Map();
 	const splitRectanglesByTable = /* @__PURE__ */ new Map();