@stll/folio-core 0.54.2 → 0.56.0

package/dist/ai-edits/apply.js

@@ -17,7 +17,7 @@ import { directParagraphAlignment } from "../prosemirror/paragraphAlignment.js";
 import { styleResolvedParagraphFormatting } from "../prosemirror/paragraphFormattingProvenance.js";
 import { directParagraphIndentation, paragraphIndentationAttrPatch, paragraphIndentationEqual, paragraphIndentationFromFormatting, withDirectParagraphIndentation } from "../prosemirror/paragraphIndentation.js";
 import { joinAtParagraphMark } from "../prosemirror/paragraphMarkJoin.js";
-import { carryParagraphProperties, paragraphLeftAfter, propertiesSetInBatch, recordReplacedParagraphProperties } from "../prosemirror/paragraphPropertyCarry.js";
+import { carriedParagraphProperties, carryParagraphProperties, paragraphLeftAfter, propertiesSetInBatch, recordReplacedParagraphProperties } from "../prosemirror/paragraphPropertyCarry.js";
 import { directParagraphSpacing, paragraphSpacingAttrPatch, paragraphSpacingEqual, paragraphSpacingFromFormatting, withDirectParagraphSpacing } from "../prosemirror/paragraphSpacing.js";
 import { getDocumentNumbering, getDocumentNumberingInstanceIds } from "../prosemirror/plugins/documentNumbering.js";
 import { getDocumentStyleDefinitions, getDocumentStyleResolver } from "../prosemirror/plugins/documentStyleState.js";
@@ -33,6 +33,7 @@ import { listAttrsFromNumbering, listLevelAttrPatch } from "../prosemirror/style
 import { removeRowsWithoutCellsAfterBatch } from "../prosemirror/tableGridMutation.js";
 import { isZeroWidthAnchor } from "../prosemirror/zeroWidthAnchors.js";
 import { getFolioParaIdFromBlockId } from "../types/block-id.js";
+import { CANONICAL_GAP } from "../types/canonicalCapabilities.js";
 import { BatchClaims } from "./batch-claims.js";
 import { stripBlockIdentityAttrs } from "./block-identity.js";
 import { describeCharacterSplit } from "./character-boundaries.js";
@@ -436,6 +437,10 @@ const preserveRunFormattingAcrossTrackedStyleChange = ({ allocateRevisionInfo, n
 		revisionIds
 	};
 };
+const appendParagraphPropertyChange = (existing, change) => {
+	if (change.info.provenance !== "suggested" && hasSerializableParagraphPropertyChange(existing)) panic("A paragraph-property write must resolve its occupied revision slot first");
+	return [...existing ?? [], change];
+};
 /**
 * Apply one paragraph-property patch to a live node. A tracked patch stores
 * the complete previous pPr: a partial snapshot cannot distinguish a property
@@ -482,7 +487,7 @@ const applyBlockParagraphProperties = ({ tr, position, node, properties, styleRe
 	const nextAttrs = {
 		...node.attrs,
 		...patch,
-		...change ? { _propertyChanges: [...Array.isArray(existing) ? existing : [], change] } : {}
+		...change ? { _propertyChanges: appendParagraphPropertyChange(existing, change) } : {}
 	};
 	const bridgeResult = preserveRunFormatting && revisionInfo ? preserveRunFormattingAcrossTrackedStyleChange({
 		allocateRevisionInfo: revisionInfo,
@@ -560,7 +565,7 @@ const applyReplaceBlockStyleId = ({ item, tr, styleResolver, revisionInfo }) =>
 	const nextAttrs = {
 		...block.attrs,
 		...patch,
-		...change ? { _propertyChanges: [...Array.isArray(existing) ? existing : [], change] } : {}
+		...change ? { _propertyChanges: appendParagraphPropertyChange(existing, change) } : {}
 	};
 	const bridgeResult = preserveRunFormatting && revisionInfo ? preserveRunFormattingAcrossTrackedStyleChange({
 		allocateRevisionInfo: revisionInfo,
@@ -1280,6 +1285,11 @@ const isInsertedPPrMark = (value) => typeof value === "object" && value !== null
 const isSuggestedParagraphInsert = (paragraph) => typeof paragraph.attrs["_suggestedInsert"] === "object" && paragraph.attrs["_suggestedInsert"] !== null;
 /** A paragraph mark that is a pending deletion, or a relocation's source. */
 const isDeletedPPrMark = (value) => typeof value === "object" && value !== null && "kind" in value && (value.kind === "del" || value.kind === "moveFrom");
+const pendingParagraphMarkPropertyRefusal = {
+	reason: "pendingParagraphMarkDeletion",
+	canonicalRefusal: { gap: CANONICAL_GAP.publicPendingParagraphMarkProperties },
+	message: "Resolve the pending paragraph mark deletion before editing its properties, or provide mergedParagraphProperties on the merge operation for atomic intent."
+};
 const hasRevisionMarker = (value) => typeof value === "object" && value !== null && "revisionId" in value;
 const isDeletedCell = (cell) => {
 	const marker = cell.attrs["cellMarker"];
@@ -1485,6 +1495,26 @@ const finalParagraphPredecessor = (doc, at) => {
 	}
 	return null;
 };
+/**
+* Whether a sibling between a final carrier's predecessor and the carrier
+* has its break deleted by this batch.
+*/
+const crossesBatchDeletion = ({ doc, from, to, batchRevisionIds }) => {
+	const $to = doc.resolve(to);
+	let position = to;
+	for (let index = $to.index() - 1; index >= 0 && position > from; index--) {
+		const node = $to.parent.child(index);
+		position -= node.nodeSize;
+		const mark = node.attrs["pPrMark"];
+		const revisionId = isPlainDeletedPPrMark(mark) ? addedOrDeletedBreakRevisionId(mark) : null;
+		if (revisionId !== null && batchRevisionIds.has(revisionId)) return true;
+	}
+	return false;
+};
+const canRetractFinalBreak = ({ predecessor, target }) => {
+	if (target.type !== predecessor.type) return false;
+	return !(JSON.stringify(paragraphPropertiesBeforePendingChanges(target)) !== JSON.stringify(paragraphPropertiesSnapshot(predecessor)) && hasSerializableParagraphPropertyChange(expectParagraphAttrs(predecessor)._propertyChanges));
+};
 /** Pending retirements, read after the merge has mapped any inserted separator. */
 const pendingRemovedFinalBreakPositions = (tr, deletions) => {
 	const positions = /* @__PURE__ */ new Set();
@@ -1496,6 +1526,92 @@ const pendingRemovedFinalBreakPositions = (tr, deletions) => {
 	}
 	return positions;
 };
+/** An unoccupied final carrier takes admissible writes from the finished batch. */
+const finalParagraphCarry = ({ tr, at, target, predecessor, batchRevisionIds, styleResolver, numbering }) => {
+	const { node: previous, position } = predecessor;
+	const beforeBatch = hasSerializableParagraphPropertyChange(expectParagraphAttrs(target)._propertyChanges) ? resolveParagraphChangeAttrs({
+		node: previous,
+		mode: "reject",
+		boundaryCovered: true,
+		revisionSet: batchRevisionIds,
+		styleResolver,
+		numbering
+	}) : null;
+	return {
+		source: beforeBatch ? previous.type.create(beforeBatch, previous.content, previous.marks) : previous,
+		keep: crossesBatchDeletion({
+			doc: tr.doc,
+			from: position + previous.nodeSize,
+			to: at,
+			batchRevisionIds
+		}) ? /* @__PURE__ */ new Set() : propertiesSetInBatch(target, batchRevisionIds)
+	};
+};
+/** Deferred retirement still owns a slot before a later explicit formatting merge. */
+const hasDeferredParagraphPropertyWrite = ({ tr, deletions, targets, mergedPropertyTargets, batchRevisionIds, styleResolver, numbering }) => {
+	for (const deletion of deletions) {
+		const at = tr.mapping.slice(deletion.mappedFrom).map(deletion.position);
+		const target = tr.doc.nodeAt(at);
+		if (!target) continue;
+		const predecessor = finalParagraphPredecessor(tr.doc, at);
+		if (!predecessor) continue;
+		const mark = predecessor.node.attrs["pPrMark"];
+		if (mark == null && mergedPropertyTargets.some(({ position, mappedFrom }) => {
+			const mapped = tr.mapping.slice(mappedFrom).mapResult(position);
+			return !mapped.deleted && mapped.pos === at;
+		})) continue;
+		const writeTarget = mark == null ? target : tr.doc.nodeAt(predecessor.position + predecessor.node.nodeSize);
+		if (!writeTarget || !targets.includes(writeTarget)) continue;
+		if (mark != null && !(isInsertedPPrMark(mark) && canRetractFinalBreak({
+			predecessor: predecessor.node,
+			target: writeTarget
+		}))) continue;
+		const transfer = mark == null ? finalParagraphCarry({
+			tr,
+			at,
+			target,
+			predecessor,
+			batchRevisionIds,
+			styleResolver,
+			numbering
+		}) : {
+			source: predecessor.node,
+			keep: propertiesSetInBatch(writeTarget, batchRevisionIds)
+		};
+		if (JSON.stringify(paragraphPropertiesSnapshot(writeTarget)) !== JSON.stringify(carriedParagraphProperties({
+			...transfer,
+			target: writeTarget
+		}))) return true;
+	}
+	return false;
+};
+/** The paragraph a merge leaves owns its properties, even across pending deleted breaks. */
+const paragraphPropertyRevisionTargets = ({ item, tr, deletedFinalParagraphs }) => {
+	const position = tr.mapping.map(item.blockFrom, item.operation.type === "replaceBlock" ? -1 : 1);
+	const source = tr.doc.nodeAt(position) ?? item.blockNode;
+	const targets = source.type.name === "paragraph" ? [source] : [];
+	if (item.operation.type !== "mergeBlockWithNext") return targets;
+	const removedBreakPositions = pendingRemovedFinalBreakPositions(tr, deletedFinalParagraphs);
+	for (const deletion of deletedFinalParagraphs) {
+		const at = tr.mapping.slice(deletion.mappedFrom).map(deletion.position);
+		const predecessor = finalParagraphPredecessor(tr.doc, at);
+		if (!predecessor || !isInsertedPPrMark(predecessor.node.attrs["pPrMark"])) continue;
+		const target = tr.doc.nodeAt(predecessor.position + predecessor.node.nodeSize);
+		if (!target) continue;
+		if (canRetractFinalBreak({
+			predecessor: predecessor.node,
+			target
+		})) removedBreakPositions.add(predecessor.position);
+	}
+	const survivorPosition = paragraphLeftAfter({
+		doc: tr.doc,
+		paragraphPos: position,
+		removedBreakPositions
+	});
+	const survivor = survivorPosition === null ? null : tr.doc.nodeAt(survivorPosition);
+	if (survivor?.type.name === "paragraph") targets.push(survivor);
+	return targets;
+};
 /**
 * Finish the tracked deletion of every paragraph a container ends with.
 *
@@ -1546,21 +1662,21 @@ const withRetiredFinalParagraphs = ({ tr, deletions, mergedPropertyTargets, appl
 					...revisionExtras
 				}
 			});
-			const beforeBatch = resolveParagraphChangeAttrs({
-				node: previous,
-				mode: "reject",
-				boundaryCovered: true,
-				revisionSet: batchRevisionIds,
-				styleResolver,
-				numbering
-			});
 			if (!mergedPropertyTargets.some(({ position: target, mappedFrom }) => {
 				const mapped = tr.mapping.slice(mappedFrom).mapResult(target);
 				return !mapped.deleted && mapped.pos === at;
 			})) carryParagraphProperties({
 				tr,
 				position: at,
-				source: beforeBatch ? previous.type.create(beforeBatch, previous.content, previous.marks) : previous,
+				...finalParagraphCarry({
+					tr,
+					at,
+					target: emptied,
+					predecessor,
+					batchRevisionIds,
+					styleResolver,
+					numbering
+				}),
 				styleResolver,
 				numbering,
 				revision: {
@@ -1568,8 +1684,7 @@ const withRetiredFinalParagraphs = ({ tr, deletions, mergedPropertyTargets, appl
 					author,
 					date,
 					...revisionExtras
-				},
-				keep: propertiesSetInBatch(emptied, batchRevisionIds)
+				}
 			});
 			resolvedOperationIds.add(operationId);
 			addedRevisions.push({
@@ -1580,11 +1695,10 @@ const withRetiredFinalParagraphs = ({ tr, deletions, mergedPropertyTargets, appl
 		}
 		if (isInsertedPPrMark(mark)) {
 			const following = tr.doc.nodeAt(position + previous.nodeSize);
-			if (following?.type.name !== emptied.type.name) continue;
-			const previousFormatting = paragraphPropertiesBeforePendingChanges(following);
-			const formattingChanges = JSON.stringify(previousFormatting) !== JSON.stringify(paragraphPropertiesSnapshot(previous));
-			const existing = expectParagraphAttrs(previous)._propertyChanges;
-			if (formattingChanges && hasSerializableParagraphPropertyChange(existing)) continue;
+			if (!following || !canRetractFinalBreak({
+				predecessor: previous,
+				target: following
+			})) continue;
 			joinAtParagraphMark({
 				tr,
 				paragraphPos: position,
@@ -2127,6 +2241,7 @@ const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations: reques
 			skipped.push({
 				id: operation.id,
 				reason: resolution.reason,
+				...resolution.canonicalRefusal !== void 0 && { canonicalRefusal: resolution.canonicalRefusal },
 				...resolution.message !== void 0 && { message: resolution.message }
 			});
 			continue;
@@ -2323,9 +2438,22 @@ const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations: reques
 		if (!item) panic("The operation execution index exceeded the resolved plan", { executionIndex });
 		continueSharedRevisionIds();
 		if (mode === "tracked-changes" && writesParagraphPropertyChange(item)) {
-			const livePosition = tr.mapping.map(item.blockFrom);
-			const liveBlock = tr.doc.nodeAt(livePosition) ?? item.blockNode;
-			if (hasSerializableParagraphPropertyChange(liveBlock.type.name === "paragraph" ? expectParagraphAttrs(liveBlock)._propertyChanges : void 0)) {
+			const appliedIds = new Set(applied.map(({ id }) => id));
+			const pendingDeletions = deletedFinalParagraphs.filter(({ operationId }) => appliedIds.has(operationId));
+			const targets = paragraphPropertyRevisionTargets({
+				item,
+				tr,
+				deletedFinalParagraphs: pendingDeletions
+			});
+			if (targets.some((target) => hasSerializableParagraphPropertyChange(expectParagraphAttrs(target)._propertyChanges)) || item.operation.type === "mergeBlockWithNext" && hasDeferredParagraphPropertyWrite({
+				tr,
+				deletions: pendingDeletions,
+				targets,
+				mergedPropertyTargets,
+				batchRevisionIds: new Set(applied.flatMap(({ revisionIds }) => revisionIds ?? [])),
+				styleResolver,
+				numbering
+			})) {
 				skipped.push({
 					id: item.operation.id,
 					reason: "pendingParagraphPropertyChange"
@@ -2559,6 +2687,13 @@ const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations: reques
 			case "replaceBlock": {
 				if (!isResolvedReplaceBlockOperation(item)) panic("Resolved replaceBlock operation lost its impact discriminator");
 				const { changesStyle, changesText } = REPLACE_BLOCK_IMPACT[item.replaceBlockImpact];
+				if (changesStyle && isDeletedPPrMark(tr.doc.nodeAt(tr.mapping.map(item.blockFrom, -1))?.attrs["pPrMark"])) {
+					skipped.push({
+						id: item.operation.id,
+						...pendingParagraphMarkPropertyRefusal
+					});
+					continue;
+				}
 				const revisionIdDelete = operationRevisionSeed;
 				const revisionIdInsert = changesText ? operationRevisionSeed + 1 : operationRevisionSeed;
 				const revisionIdBackgroundSeed = changesText ? operationRevisionSeed + 2 : operationRevisionSeed;
@@ -3291,6 +3426,13 @@ const applyFolioAIEditOperationsInternal = ({ view, snapshot, operations: reques
 					continue;
 				}
 				const blockPosition = mapped.pos;
+				if (isDeletedPPrMark(liveBlock.attrs["pPrMark"])) {
+					skipped.push({
+						id: item.operation.id,
+						...pendingParagraphMarkPropertyRefusal
+					});
+					continue;
+				}
 				const appliedProperties = applyBlockParagraphProperties({
 					tr,
 					position: blockPosition,
@@ -4868,17 +5010,23 @@ const resolveOperationTarget = ({ snapshot, operation, liveBlocks, liveBlocksByP
 			}
 		};
 	}
-	if (operation.type === "setBlockParagraphProperties") return {
-		type: "resolved",
-		operation: {
-			operation,
-			from: blockFrom,
-			to: blockTo,
-			blockFrom,
-			blockTo,
-			blockNode
-		}
-	};
+	if (operation.type === "setBlockParagraphProperties") {
+		if (isDeletedPPrMark(blockNode.attrs["pPrMark"])) return {
+			type: "skip",
+			...pendingParagraphMarkPropertyRefusal
+		};
+		return {
+			type: "resolved",
+			operation: {
+				operation,
+				from: blockFrom,
+				to: blockTo,
+				blockFrom,
+				blockTo,
+				blockNode
+			}
+		};
+	}
 	if (operation.type === "splitBlock") {
 		const separator = operation.separator ?? "";
 		const startOffset = operation.offset;
@@ -4944,6 +5092,10 @@ const resolveOperationTarget = ({ snapshot, operation, liveBlocks, liveBlocksByP
 	if (operation.type === "deleteBlock" || operation.type === "replaceBlock") {
 		const replaceChangesText = operation.type === "replaceBlock" && operation.text !== currentText;
 		const replaceChangesStyle = operation.type === "replaceBlock" && operation.styleId !== void 0 && operation.styleId !== (expectParagraphAttrs(blockNode).styleId ?? null);
+		if (replaceChangesStyle && isDeletedPPrMark(blockNode.attrs["pPrMark"])) return {
+			type: "skip",
+			...pendingParagraphMarkPropertyRefusal
+		};
 		if (replaceChangesText && cleanBlock.structuralBoundaries.some((boundary) => boundary.type !== "field" && boundary.type !== "noteReference")) return {
 			type: "skip",
 			reason: "unsupportedBlock"

package/dist/ai-edits/headless.js

@@ -5,8 +5,7 @@ import { importReferencedStyleDefinitions } from "../compare/style-resources.js"
 import { applyFolioDocumentOperations } from "../document-operations.js";
 import { applyReplyThreadMarkers } from "../docx/commentReplyMarkers.js";
 import { rebindDrawingImageRelationship } from "../docx/drawingRelationships.js";
-import { getEndnoteText, getFootnoteText, isSeparatorEndnote, isSeparatorFootnote } from "../docx/footnoteParser.js";
-import { getHeaderFooterText } from "../docx/headerFooterParser.js";
+import { isSeparatorEndnote, isSeparatorFootnote } from "../docx/footnoteParser.js";
 import { createNumberingIdAllocator } from "../docx/numberingIds.js";
 import { getCachedNumberingMap } from "../docx/numberingParser.js";
 import { recreateProseNodeWithParagraphPropertySource, transferProseParagraphPropertySource } from "../docx/paragraphPropertySource.js";
@@ -15,6 +14,7 @@ import { createReply } from "../docx/replyToComment.js";
 import { repackDocx } from "../docx/rezip.js";
 import { sectionReferenceHistory } from "../docx/sectionReferenceHistory.js";
 import { attemptSelectiveSave } from "../docx/selectiveSave.js";
+import { getEndnoteText, getFootnoteText, getHeaderFooterText } from "../docx/storyPlainText.js";
 import { pluginsForHeadlessRevisionResolution } from "../internal/headlessRevisionResolutionGuard.js";
 import { withTrackedSectionEndpointRemoval } from "../internal/sectionEndpointResolution.js";
 import { captureSectionReferenceInventory, resolvedSectionReferenceLosses, withSectionReferenceResolution } from "../internal/sectionReferenceResolution.js";
@@ -1895,6 +1895,7 @@ var FolioDocxReviewer = class FolioDocxReviewer {
 		const source = story.type === "header" || story.type === "footer" ? this.getHeaderFooterStory(story) : this.getNoteStory(story);
 		if (!source) return null;
 		const conversionOptions = {
+			...this.baseDocument.package.numbering !== void 0 && { numbering: this.baseDocument.package.numbering },
 			...this.baseDocument.package.styles !== void 0 && { styles: this.baseDocument.package.styles },
 			...this.baseDocument.package.theme !== void 0 && { theme: this.baseDocument.package.theme }
 		};

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

@@ -1,4 +1,5 @@
 import { document_d_exports } from "../types/document.js";
+import { CanonicalGap } from "../types/canonicalCapabilities.js";
 import { FolioContentBlock, FolioContentInlineBooleanProperty, FolioContentInlineFormatting, FolioContentInlineFormattingPatch, FolioContentListReference, FolioContentParagraphIndentation, FolioContentParagraphKind, FolioContentParagraphSpacing, FolioContentRun, FolioContentSnapshot, FolioContentTableLocation } from "../compare/content-types.js";
 import { ListKind } from "../docx/listNumberingInstances.js";
 //#region src/ai-edits/types.d.ts
@@ -656,7 +657,9 @@ type FolioAIEditSkipReason = "missingBlock" | "changedBlock" | "ambiguousFind" |
  * deletion is accepted. Reject that deletion first, or insert a new block
  * next to it.
  */
-"pendingDeletion";
+"pendingDeletion" |
+/** Resolve the removed paragraph mark before editing its properties separately. */
+"pendingParagraphMarkDeletion";
 type FolioAIEditAppliedOperation = {
   id: string;
   commentId?: number;
@@ -689,6 +692,9 @@ type FolioAIEditAppliedOperation = {
 type FolioAIEditSkippedOperation = {
   id: string;
   reason: FolioAIEditSkipReason;
+  canonicalRefusal?: {
+    gap: CanonicalGap;
+  };
   /**
    * What exactly was wrong when the reason alone does not say: the values a
    * `payloadDoesNotFit` skip could not place, the earlier operation an

package/dist/compare/compare.js

@@ -486,6 +486,7 @@ const COMPARE_SKIP_DISPOSITION = {
 	staleRange: "fatal",
 	emptyOperation: "unwritable",
 	pendingParagraphPropertyChange: "unwritable",
+	pendingParagraphMarkDeletion: "unwritable",
 	pendingRunPropertyChange: "unwritable",
 	noopOperation: "unwritable",
 	documentVersionMismatch: "fatal",

package/dist/compare/content-types.d.ts

@@ -83,14 +83,9 @@ type FolioContentTableLocation = {
  */
 type FolioContentParagraphAlignment = document_d_exports.ParagraphAlignment;
 /** Line-height interpretation understood by the neutral comparison model. */
-type FolioContentLineSpacingRule = "auto" | "exact" | "atLeast";
+type FolioContentLineSpacingRule = NonNullable<document_d_exports.ParagraphFormatting["lineSpacingRule"]>;
 /** The complete modeled attribute set of direct paragraph indentation. */
-type FolioContentParagraphIndentation = {
-  indentLeft?: number;
-  indentRight?: number;
-  indentFirstLine?: number;
-  hangingIndent?: boolean;
-};
+type FolioContentParagraphIndentation = Pick<document_d_exports.ParagraphFormatting, "indentLeft" | "indentRight" | "indentFirstLine" | "hangingIndent">;
 /** A concrete numbering instance and its zero-based level. */
 type FolioContentListReference = {
   numId: number;
@@ -100,14 +95,7 @@ type FolioContentListReference = {
  * The complete modeled attribute set of direct paragraph spacing. Optional
  * fields distinguish an absent attribute from an explicit zero or false value.
  */
-type FolioContentParagraphSpacing = {
-  spaceBefore?: number;
-  spaceAfter?: number;
-  lineSpacing?: number;
-  lineSpacingRule?: FolioContentLineSpacingRule;
-  beforeAutospacing?: boolean;
-  afterAutospacing?: boolean;
-};
+type FolioContentParagraphSpacing = Pick<document_d_exports.ParagraphFormatting, "spaceBefore" | "spaceAfter" | "lineSpacing" | "lineSpacingRule" | "beforeAutospacing" | "afterAutospacing">;
 /** A representation-neutral block in one ordered document story. */
 type FolioContentBlock<Kind extends string = string> = {
   id: string;

package/dist/compare/reproducible-package.d.ts

@@ -1,21 +1,4 @@
 //#region src/compare/reproducible-package.d.ts
-/**
- * The last two clocks in the compare path are outside the document body.
- *
- * Every part the serializer rewrites is stored with JSZip's default entry
- * date, which is `new Date()`. The XML is identical between two runs, but the
- * DOS timestamp fields in the local headers are not, and they only agree when
- * both runs land in the same two-second bucket — so the packages match most of
- * the time and differ occasionally, which is worse than differing always.
- *
- * The save also stamps `dcterms:modified` in `docProps/core.xml` from the wall
- * clock, which is the same failure one part deeper: two runs over identical
- * inputs differ in that part alone.
- *
- * Restamping both from the comparison's own timestamp removes them. It also
- * states the truth about the package: a generated redline is dated by the
- * comparison that produced it, not by the second it happened to be written.
- */
 declare const withFixedPackageDates: (buffer: ArrayBuffer, date: Date) => Promise<ArrayBuffer>;
 //#endregion
 export { withFixedPackageDates };

package/dist/compare/reproducible-package.js

@@ -1,21 +1,10 @@
+import { writeZipPart } from "@stll/docx-core/zip";
 import JSZip from "jszip";
 //#region src/compare/reproducible-package.ts
 /**
-* The last two clocks in the compare path are outside the document body.
-*
-* Every part the serializer rewrites is stored with JSZip's default entry
-* date, which is `new Date()`. The XML is identical between two runs, but the
-* DOS timestamp fields in the local headers are not, and they only agree when
-* both runs land in the same two-second bucket — so the packages match most of
-* the time and differ occasionally, which is worse than differing always.
-*
-* The save also stamps `dcterms:modified` in `docProps/core.xml` from the wall
-* clock, which is the same failure one part deeper: two runs over identical
-* inputs differ in that part alone.
-*
-* Restamping both from the comparison's own timestamp removes them. It also
-* states the truth about the package: a generated redline is dated by the
-* comparison that produced it, not by the second it happened to be written.
+* Date comparison output from the comparison's timestamp. Imported entries
+* retain source dates, and saves can stamp `dcterms:modified` from the wall
+* clock; restamping both makes repeated comparisons reproducible.
 */
 /** JSZip deflate level `repackDocx` writes DOCX parts at. */
 const DOCX_COMPRESSION_LEVEL = 6;
@@ -30,9 +19,14 @@ const withFixedModifiedDate = (corePropsXml, date) => corePropsXml.replace(MODIF
 const withFixedPackageDates = async (buffer, date) => {
 	const zip = await JSZip.loadAsync(buffer);
 	const coreProps = zip.file(CORE_PROPERTIES_PATH);
-	if (coreProps) zip.file(CORE_PROPERTIES_PATH, withFixedModifiedDate(await coreProps.async("text"), date), {
-		compression: "DEFLATE",
-		compressionOptions: { level: DOCX_COMPRESSION_LEVEL }
+	if (coreProps) writeZipPart({
+		zip,
+		path: CORE_PROPERTIES_PATH,
+		data: withFixedModifiedDate(await coreProps.async("text"), date),
+		options: {
+			compression: "DEFLATE",
+			compressionOptions: { level: DOCX_COMPRESSION_LEVEL }
+		}
 	});
 	zip.forEach((_path, file) => {
 		file.date = date;

package/dist/controller/canonicalClipboard.d.ts

@@ -0,0 +1,23 @@
+import { document_d_exports } from "../types/document.js";
+import { CanonicalCommit, CanonicalSession, CanonicalSessionError } from "./canonicalSession.js";
+import { Slice } from "prosemirror-model";
+import { EditorState } from "prosemirror-state";
+import { Result } from "better-result";
+//#region src/controller/canonicalClipboard.d.ts
+/** Clipboard slices are input payloads; their paragraph identities and private captures are not owners. */
+type PrepareCanonicalPasteOptions = {
+  session: CanonicalSession;
+  state: EditorState;
+  slice: Slice;
+  plain?: boolean;
+  moveTarget?: number;
+  pasteTarget?: number;
+  sourceDocument?: document_d_exports.Document;
+  moveSource?: {
+    from: number;
+    to: number;
+  };
+};
+declare const prepareCanonicalPaste: ({ session, state, slice, plain, moveTarget, pasteTarget, sourceDocument, moveSource }: PrepareCanonicalPasteOptions) => Result<CanonicalCommit, CanonicalSessionError>;
+//#endregion
+export { prepareCanonicalPaste };