@stll/folio-core 0.39.1 → 0.40.0

package/dist/ai-edits/apply.js

@@ -1090,6 +1090,7 @@ const buildInsertedParagraphs = ({ item, schema, formattingFromStyle, mode, auth
 			suggestionId
 		} : {}
 	};
+	const formatsEveryParagraph = operation.formattingScope === "allParagraphs";
 	const baseAttrs = operation.inheritFormatting === false ? {} : {
 		...stripBlockIdentityAttrs(item.blockNode.attrs),
 		_propertyChanges: null,
@@ -1102,6 +1103,7 @@ const buildInsertedParagraphs = ({ item, schema, formattingFromStyle, mode, auth
 	let nextRevisionId = revisionSeed;
 	for (const [paragraphIndex, text] of insertTexts.entries()) {
 		const isFirstParagraph = paragraphIndex === 0;
+		const formatsParagraph = isFirstParagraph || formatsEveryParagraph;
 		const marks = [];
 		let paragraphRevisionId = null;
 		if (producesTrackedChanges && insertionType) {
@@ -1127,11 +1129,11 @@ const buildInsertedParagraphs = ({ item, schema, formattingFromStyle, mode, auth
 			text,
 			marks
 		}) : buildEmphasisInlineContent(schema, text, marks);
-		const attrs = isFirstParagraph ? { ...baseAttrs } : {};
+		const attrs = formatsParagraph ? { ...baseAttrs } : {};
 		if (isFirstParagraph && operation.pageBreakBefore === true) attrs["pageBreakBefore"] = true;
 		const explicitNumbering = operation.numbering;
 		const listLevel = operation.listLevel;
-		if (isFirstParagraph) {
+		if (formatsParagraph) {
 			if (explicitNumbering === null) {
 				attrs["numPr"] = null;
 				Object.assign(attrs, CLEARED_LIST_RENDERING_ATTRS);
@@ -1160,11 +1162,11 @@ const buildInsertedParagraphs = ({ item, schema, formattingFromStyle, mode, auth
 				}
 			}
 		}
-		if (isFirstParagraph && operation.styleId !== void 0) {
+		if (formatsParagraph && operation.styleId !== void 0) {
 			attrs["styleId"] = operation.styleId;
 			if (operation.inheritFormatting !== false && operation.styleId !== null) Object.assign(attrs, CLEARED_LIST_RENDERING_ATTRS);
 		}
-		if (isFirstParagraph && (operation.styleId !== void 0 || operation.alignment !== void 0 || operation.spacing !== void 0 || operation.indentation !== void 0)) {
+		if (formatsParagraph && (operation.styleId !== void 0 || operation.alignment !== void 0 || operation.spacing !== void 0 || operation.indentation !== void 0)) {
 			const inheritedDirectAlignment = operation.inheritFormatting === false ? void 0 : directParagraphAlignment(expectParagraphAttrs(item.blockNode));
 			const inheritedDirectSpacing = operation.inheritFormatting === false ? void 0 : directParagraphSpacing(expectParagraphAttrs(item.blockNode));
 			const inheritedDirectIndentation = operation.inheritFormatting === false ? void 0 : directParagraphIndentation(expectParagraphAttrs(item.blockNode));

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

@@ -1,5 +1,5 @@
 import { FolioContentParagraphKind } from "../compare/content-types.js";
-import { FolioAIBlock, FolioAIBlockAnchor, FolioAIBlockKind, FolioAIBlockPreviewRun, FolioAIBlockStructuralBoundary, FolioAIBlockTableLocation, FolioAIComment, FolioAIEditAppliedOperation, FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditNormalization, FolioAIEditNormalizationCode, FolioAIEditOperation, FolioAIEditPrecondition, FolioAIEditReviewMeta, FolioAIEditSeverity, FolioAIEditSkipReason, FolioAIEditSkippedOperation, FolioAIEditSnapshot, FolioAIInlineBooleanProperty, FolioAIInlineFormatting, FolioAIInlineFormattingPatch, FolioAIParagraphSpacing, FolioAISignatureParty, FolioAITextRangeHandle, FolioDocumentNavigationTarget, FolioDocumentOutline, FolioDocumentOutlineEntry, FolioDocumentSection, FolioDocumentSectionHandle, FolioDocumentSectionReadResult } from "./types.js";
+import { FolioAIBlock, FolioAIBlockAnchor, FolioAIBlockKind, FolioAIBlockPreviewRun, FolioAIBlockStructuralBoundary, FolioAIBlockTableLocation, FolioAIComment, FolioAIEditAppliedOperation, FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditNormalization, FolioAIEditNormalizationCode, FolioAIEditOperation, FolioAIEditPrecondition, FolioAIEditReviewMeta, FolioAIEditSeverity, FolioAIEditSkipReason, FolioAIEditSkippedOperation, FolioAIEditSnapshot, FolioAIInlineBooleanProperty, FolioAIInlineFormatting, FolioAIInlineFormattingPatch, FolioAIInsertFormattingScope, FolioAIParagraphSpacing, FolioAISignatureParty, FolioAITextRangeHandle, FolioDocumentNavigationTarget, FolioDocumentOutline, FolioDocumentOutlineEntry, FolioDocumentSection, FolioDocumentSectionHandle, FolioDocumentSectionReadResult } from "./types.js";
 import { WORD_DIFF_GRANULARITIES, WordDiffGranularity, WordDiffNormalization, WordDiffOptions, WordDiffSegment, diffWordSegments } from "./word-diff.js";
 import { FolioAIEditApplyOutcome, FolioAIEditView, FolioRevisionStamp, FolioWordDiffOptions, applyFolioAIEditOperations } from "./apply.js";
 import { DocPositionRange, clampRangeToDocSize, resolveFolioAIBlockRange, resolveFolioAITextRange, resolvePassageRange } from "./blockRange.js";
@@ -10,4 +10,4 @@ import { createFolioAIEditSnapshot, createFolioAITextRangeHandle, hashFolioAIBlo
 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 { 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_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIBlockStructuralBoundary, type FolioAIBlockTableLocation, type FolioAIComment, 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 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 FolioReadReviewedStoryOptions, type FolioResolveReviewedStoryOptions, type FolioResolvedReviewedView, type FolioReviewChange, type FolioReviewChangeKind, type FolioReviewedStory, type FolioReviewedView, type FolioRevisionStamp, type FolioWordDiffOptions, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioReviewedViewError, WORD_DIFF_GRANULARITIES, type WordDiffGranularity, type WordDiffNormalization, type WordDiffOptions, type WordDiffSegment, applyFolioAIEditOperations, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, buildAnnotatedBlockText, clampRangeToDocSize, createFolioAIEditSnapshot, createFolioAITextRangeHandle, 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_RESOLVED_REVIEWED_VIEWS, FOLIO_REVIEWED_VIEWS, type FolioAIBlock, type FolioAIBlockAnchor, type FolioAIBlockKind, type FolioAIBlockPreviewRun, type FolioAIBlockStructuralBoundary, type FolioAIBlockTableLocation, type FolioAIComment, 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 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 FolioReadReviewedStoryOptions, type FolioResolveReviewedStoryOptions, type FolioResolvedReviewedView, type FolioReviewChange, type FolioReviewChangeKind, type FolioReviewedStory, type FolioReviewedView, type FolioRevisionStamp, type FolioWordDiffOptions, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, UnsupportedFolioReviewedViewError, WORD_DIFF_GRANULARITIES, type WordDiffGranularity, type WordDiffNormalization, type WordDiffOptions, type WordDiffSegment, applyFolioAIEditOperations, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, buildAnnotatedBlockText, clampRangeToDocSize, createFolioAIEditSnapshot, createFolioAITextRangeHandle, diffWordSegments, getCommentAnchorsFromDoc, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, getFolioDocumentOutline, getFolioParaIdFromBlockId, getTrackedChangesFromDoc, hashFolioAIBlockText, isFolioAIContentBlock, isFolioDocumentOperationModeSupported, isFolioResolvedReviewedView, isFolioReviewedView, isSupportedFolioDocumentOperationVersion, normalizeFolioAIBlockText, parseFolioDocumentOperationBatch, readFolioDocumentSection, resolveFolioAIBlockRange, resolveFolioAITextRange, resolvePassageRange };

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

@@ -43,6 +43,8 @@ type FolioAIParagraphSpacing = FolioContentParagraphSpacing;
 /** The complete modeled attribute set of one direct `w:pPr/w:ind` child. */
 type FolioAIParagraphIndentation = FolioContentParagraphIndentation;
 type FolioAIListReference = FolioContentListReference;
+/** Which paragraphs split from one insertion's `text` receive its paragraph formatting. */
+type FolioAIInsertFormattingScope = "firstParagraph" | "allParagraphs";
 /**
  * The paragraph properties an operation may set. A subset of `w:pPrChange`'s
  * scope: properties a comparison can see in a block projection and an agent
@@ -212,11 +214,11 @@ type FolioAIEditOperation = FolioAIEditReviewMeta & {
   /**
    * The paragraph text to insert. With the default `lineBreakMode:
    * "paragraph"`, a line break splits `text` into consecutive
-   * paragraphs at the same anchor: only the first paragraph gets
-   * `styleId` / `alignment` / `inheritFormatting`, later ones use
-   * body formatting. Blank lines are dropped and reported as a
-   * `splitMultilineText` normalization. `"inline"` retains the
-   * control inside one paragraph.
+   * paragraphs at the same anchor. `formattingScope` decides which of
+   * them receive this operation's paragraph formatting: by default only
+   * the first, later ones use body formatting. Blank lines are dropped
+   * and reported as a `splitMultilineText` normalization. `"inline"`
+   * retains the control inside one paragraph.
    *
    * `""` inserts a BLANK paragraph, and is a real edit: adding an empty
    * line is a change a reader sees, and a document that has one where
@@ -229,6 +231,17 @@ type FolioAIEditOperation = FolioAIEditReviewMeta & {
    * `"inline"` retains tabs and hard breaks inside this inserted block.
    */
   lineBreakMode?: "paragraph" | "inline";
+  /**
+   * Which paragraphs split from `text` receive the operation's
+   * paragraph formatting: the inherited anchor formatting plus
+   * `styleId`, `listLevel`, `numbering`, `alignment`, `spacing` and
+   * `indentation`. `"firstParagraph"` (the default) formats the first
+   * and leaves the rest as body paragraphs, for a heading followed by
+   * its body. `"allParagraphs"` formats every paragraph alike, for
+   * several list items in one operation. `pageBreakBefore` and
+   * `hardPageBreak` apply to the first paragraph in either scope.
+   */
+  formattingScope?: FolioAIInsertFormattingScope;
   inheritFormatting?: boolean;
   /**
    * Links this insertion to the deletion that carries the same
@@ -596,4 +609,4 @@ type FolioAIEditApplyResult = {
   normalizations?: FolioAIEditNormalization[];
 };
 //#endregion
-export { FolioAIBlock, FolioAIBlockAnchor, FolioAIBlockKind, FolioAIBlockParagraphProperties, FolioAIBlockPreviewRun, FolioAIBlockStructuralBoundary, FolioAIBlockTableLocation, FolioAIComment, FolioAIEditAppliedOperation, FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditNormalization, FolioAIEditNormalizationCode, FolioAIEditOperation, FolioAIEditPrecondition, FolioAIEditReviewMeta, FolioAIEditSeverity, FolioAIEditSkipReason, FolioAIEditSkippedOperation, FolioAIEditSnapshot, FolioAIInlineBooleanProperty, FolioAIInlineFormatting, FolioAIInlineFormattingPatch, FolioAIListReference, FolioAIParagraphIndentation, FolioAIParagraphSpacing, FolioAISignatureParty, FolioAITextRangeHandle, FolioDocumentNavigationTarget, FolioDocumentOutline, FolioDocumentOutlineEntry, FolioDocumentSection, FolioDocumentSectionHandle, FolioDocumentSectionReadResult };
+export { FolioAIBlock, FolioAIBlockAnchor, FolioAIBlockKind, FolioAIBlockParagraphProperties, FolioAIBlockPreviewRun, FolioAIBlockStructuralBoundary, FolioAIBlockTableLocation, FolioAIComment, FolioAIEditAppliedOperation, FolioAIEditApplyMode, FolioAIEditApplyResult, FolioAIEditNormalization, FolioAIEditNormalizationCode, FolioAIEditOperation, FolioAIEditPrecondition, FolioAIEditReviewMeta, FolioAIEditSeverity, FolioAIEditSkipReason, FolioAIEditSkippedOperation, FolioAIEditSnapshot, FolioAIInlineBooleanProperty, FolioAIInlineFormatting, FolioAIInlineFormattingPatch, FolioAIInsertFormattingScope, FolioAIListReference, FolioAIParagraphIndentation, FolioAIParagraphSpacing, FolioAISignatureParty, FolioAITextRangeHandle, FolioDocumentNavigationTarget, FolioDocumentOutline, FolioDocumentOutlineEntry, FolioDocumentSection, FolioDocumentSectionHandle, FolioDocumentSectionReadResult };

package/dist/document-operations.d.ts

@@ -95,27 +95,27 @@ type FolioDocumentOperationBatch = {
  * guessing, and so tool schemas can be derived from the contract.
  */
 declare const FOLIO_DOCUMENT_OPERATION_KEYS_BY_TYPE: Readonly<{
-  readonly replaceInBlock: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "find", "replace", "comment"];
-  readonly replaceRange: readonly ["id", "type", "range", "severity", "area", "precondition", "suggestionId", "replace", "comment"];
-  readonly commentOnRange: readonly ["id", "type", "range", "severity", "area", "precondition", "comment"];
-  readonly formatRange: readonly ["id", "type", "range", "severity", "area", "precondition", "suggestionId", "formatting"];
-  readonly insertAfterBlock: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "text", "inheritFormatting", "alignment", "spacing", "indentation", "lineBreakMode", "listLevel", "numbering", "moveId", "pageBreakBefore", "hardPageBreak", "styleId", "comment"];
-  readonly insertBeforeBlock: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "text", "inheritFormatting", "alignment", "spacing", "indentation", "lineBreakMode", "listLevel", "numbering", "moveId", "pageBreakBefore", "hardPageBreak", "styleId", "comment"];
-  readonly replaceBlock: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "text", "preserveFormatting", "styleId", "comment"];
-  readonly deleteBlock: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "moveId", "comment"];
-  readonly splitBlock: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "offset", "separator", "firstParagraphProperties", "secondParagraphProperties"];
-  readonly mergeBlockWithNext: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "separator", "mergedParagraphProperties"];
-  readonly setBlockParagraphProperties: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "properties"];
-  readonly insertTable: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "position", "rows"];
-  readonly deleteTable: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId"];
-  readonly commentOnBlock: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "quote", "comment"];
-  readonly insertSignatureTable: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "position", "parties", "comment"];
-  readonly insertTableRow: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "position", "cellTexts"];
-  readonly deleteTableRow: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId"];
-  readonly insertTableColumn: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "position", "cellTexts"];
-  readonly deleteTableColumn: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId"];
-  readonly mergeTableCells: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId", "endBlockId", "rowCount"];
-  readonly splitTableCell: readonly ["id", "type", "blockId", "severity", "area", "precondition", "suggestionId"];
+  readonly replaceInBlock: readonly string[];
+  readonly replaceRange: readonly string[];
+  readonly commentOnRange: readonly string[];
+  readonly formatRange: readonly string[];
+  readonly insertAfterBlock: readonly string[];
+  readonly insertBeforeBlock: readonly string[];
+  readonly replaceBlock: readonly string[];
+  readonly deleteBlock: readonly string[];
+  readonly splitBlock: readonly string[];
+  readonly mergeBlockWithNext: readonly string[];
+  readonly setBlockParagraphProperties: readonly string[];
+  readonly insertTable: readonly string[];
+  readonly deleteTable: readonly string[];
+  readonly commentOnBlock: readonly string[];
+  readonly insertSignatureTable: readonly string[];
+  readonly insertTableRow: readonly string[];
+  readonly deleteTableRow: readonly string[];
+  readonly insertTableColumn: readonly string[];
+  readonly deleteTableColumn: readonly string[];
+  readonly mergeTableCells: readonly string[];
+  readonly splitTableCell: readonly string[];
 }>;
 declare const parseFolioDocumentOperationBatch: (value: unknown) => FolioDocumentOperationBatch;
 /**

package/dist/document-operations.js

@@ -448,23 +448,145 @@ const readReviewMeta = (value, path) => {
 		...area !== void 0 && { area }
 	};
 };
-const COMMON_OPERATION_KEYS = [
-	"id",
-	"type",
-	"blockId",
-	"severity",
-	"area",
-	"precondition",
-	"suggestionId"
-];
-const RANGE_OPERATION_KEYS = [
-	"id",
-	"type",
-	"range",
-	"severity",
-	"area",
-	"precondition"
-];
+const COMMON_OPERATION_KEY_DECISIONS = {
+	id: true,
+	type: true,
+	blockId: true,
+	severity: true,
+	area: true,
+	precondition: true,
+	suggestionId: true
+};
+const RANGE_OPERATION_KEY_DECISIONS = {
+	id: true,
+	type: true,
+	range: true,
+	severity: true,
+	area: true,
+	precondition: true
+};
+const OPERATION_KEY_DECISIONS = {
+	replaceInBlock: {
+		...COMMON_OPERATION_KEY_DECISIONS,
+		find: true,
+		replace: true,
+		comment: true
+	},
+	replaceRange: {
+		...RANGE_OPERATION_KEY_DECISIONS,
+		suggestionId: true,
+		replace: true,
+		comment: true
+	},
+	commentOnRange: {
+		...RANGE_OPERATION_KEY_DECISIONS,
+		suggestionId: false,
+		comment: true
+	},
+	formatRange: {
+		...RANGE_OPERATION_KEY_DECISIONS,
+		suggestionId: true,
+		formatting: true
+	},
+	insertAfterBlock: {
+		...COMMON_OPERATION_KEY_DECISIONS,
+		text: true,
+		inheritFormatting: true,
+		alignment: true,
+		spacing: true,
+		indentation: true,
+		lineBreakMode: true,
+		formattingScope: true,
+		listLevel: true,
+		numbering: true,
+		moveId: true,
+		pageBreakBefore: true,
+		hardPageBreak: true,
+		styleId: true,
+		comment: true
+	},
+	insertBeforeBlock: {
+		...COMMON_OPERATION_KEY_DECISIONS,
+		text: true,
+		inheritFormatting: true,
+		alignment: true,
+		spacing: true,
+		indentation: true,
+		lineBreakMode: true,
+		formattingScope: true,
+		listLevel: true,
+		numbering: true,
+		moveId: true,
+		pageBreakBefore: true,
+		hardPageBreak: true,
+		styleId: true,
+		comment: true
+	},
+	replaceBlock: {
+		...COMMON_OPERATION_KEY_DECISIONS,
+		text: true,
+		preserveFormatting: true,
+		styleId: true,
+		comment: true
+	},
+	deleteBlock: {
+		...COMMON_OPERATION_KEY_DECISIONS,
+		moveId: true,
+		comment: true
+	},
+	splitBlock: {
+		...COMMON_OPERATION_KEY_DECISIONS,
+		offset: true,
+		separator: true,
+		firstParagraphProperties: true,
+		secondParagraphProperties: true
+	},
+	mergeBlockWithNext: {
+		...COMMON_OPERATION_KEY_DECISIONS,
+		separator: true,
+		mergedParagraphProperties: true
+	},
+	setBlockParagraphProperties: {
+		...COMMON_OPERATION_KEY_DECISIONS,
+		properties: true
+	},
+	insertTable: {
+		...COMMON_OPERATION_KEY_DECISIONS,
+		position: true,
+		rows: true
+	},
+	deleteTable: COMMON_OPERATION_KEY_DECISIONS,
+	commentOnBlock: {
+		...COMMON_OPERATION_KEY_DECISIONS,
+		quote: true,
+		comment: true
+	},
+	insertSignatureTable: {
+		...COMMON_OPERATION_KEY_DECISIONS,
+		position: true,
+		parties: true,
+		comment: true
+	},
+	insertTableRow: {
+		...COMMON_OPERATION_KEY_DECISIONS,
+		position: true,
+		cellTexts: true
+	},
+	deleteTableRow: COMMON_OPERATION_KEY_DECISIONS,
+	insertTableColumn: {
+		...COMMON_OPERATION_KEY_DECISIONS,
+		position: true,
+		cellTexts: true
+	},
+	deleteTableColumn: COMMON_OPERATION_KEY_DECISIONS,
+	mergeTableCells: {
+		...COMMON_OPERATION_KEY_DECISIONS,
+		endBlockId: true,
+		rowCount: true
+	},
+	splitTableCell: COMMON_OPERATION_KEY_DECISIONS
+};
+const acceptedKeys = (decisions) => Object.keys(decisions).filter((key) => decisions[key] === true);
 /**
 * Every property each operation type accepts on the wire; the parser
 * rejects any other key. Exported so a lenient front door (an LLM tool
@@ -472,116 +594,27 @@ const RANGE_OPERATION_KEYS = [
 * guessing, and so tool schemas can be derived from the contract.
 */
 const FOLIO_DOCUMENT_OPERATION_KEYS_BY_TYPE = Object.freeze({
-	replaceInBlock: [
-		...COMMON_OPERATION_KEYS,
-		"find",
-		"replace",
-		"comment"
-	],
-	replaceRange: [
-		...RANGE_OPERATION_KEYS,
-		"suggestionId",
-		"replace",
-		"comment"
-	],
-	commentOnRange: [...RANGE_OPERATION_KEYS, "comment"],
-	formatRange: [
-		...RANGE_OPERATION_KEYS,
-		"suggestionId",
-		"formatting"
-	],
-	insertAfterBlock: [
-		...COMMON_OPERATION_KEYS,
-		"text",
-		"inheritFormatting",
-		"alignment",
-		"spacing",
-		"indentation",
-		"lineBreakMode",
-		"listLevel",
-		"numbering",
-		"moveId",
-		"pageBreakBefore",
-		"hardPageBreak",
-		"styleId",
-		"comment"
-	],
-	insertBeforeBlock: [
-		...COMMON_OPERATION_KEYS,
-		"text",
-		"inheritFormatting",
-		"alignment",
-		"spacing",
-		"indentation",
-		"lineBreakMode",
-		"listLevel",
-		"numbering",
-		"moveId",
-		"pageBreakBefore",
-		"hardPageBreak",
-		"styleId",
-		"comment"
-	],
-	replaceBlock: [
-		...COMMON_OPERATION_KEYS,
-		"text",
-		"preserveFormatting",
-		"styleId",
-		"comment"
-	],
-	deleteBlock: [
-		...COMMON_OPERATION_KEYS,
-		"moveId",
-		"comment"
-	],
-	splitBlock: [
-		...COMMON_OPERATION_KEYS,
-		"offset",
-		"separator",
-		"firstParagraphProperties",
-		"secondParagraphProperties"
-	],
-	mergeBlockWithNext: [
-		...COMMON_OPERATION_KEYS,
-		"separator",
-		"mergedParagraphProperties"
-	],
-	setBlockParagraphProperties: [...COMMON_OPERATION_KEYS, "properties"],
-	insertTable: [
-		...COMMON_OPERATION_KEYS,
-		"position",
-		"rows"
-	],
-	deleteTable: COMMON_OPERATION_KEYS,
-	commentOnBlock: [
-		...COMMON_OPERATION_KEYS,
-		"quote",
-		"comment"
-	],
-	insertSignatureTable: [
-		...COMMON_OPERATION_KEYS,
-		"position",
-		"parties",
-		"comment"
-	],
-	insertTableRow: [
-		...COMMON_OPERATION_KEYS,
-		"position",
-		"cellTexts"
-	],
-	deleteTableRow: COMMON_OPERATION_KEYS,
-	insertTableColumn: [
-		...COMMON_OPERATION_KEYS,
-		"position",
-		"cellTexts"
-	],
-	deleteTableColumn: COMMON_OPERATION_KEYS,
-	mergeTableCells: [
-		...COMMON_OPERATION_KEYS,
-		"endBlockId",
-		"rowCount"
-	],
-	splitTableCell: COMMON_OPERATION_KEYS
+	replaceInBlock: acceptedKeys(OPERATION_KEY_DECISIONS.replaceInBlock),
+	replaceRange: acceptedKeys(OPERATION_KEY_DECISIONS.replaceRange),
+	commentOnRange: acceptedKeys(OPERATION_KEY_DECISIONS.commentOnRange),
+	formatRange: acceptedKeys(OPERATION_KEY_DECISIONS.formatRange),
+	insertAfterBlock: acceptedKeys(OPERATION_KEY_DECISIONS.insertAfterBlock),
+	insertBeforeBlock: acceptedKeys(OPERATION_KEY_DECISIONS.insertBeforeBlock),
+	replaceBlock: acceptedKeys(OPERATION_KEY_DECISIONS.replaceBlock),
+	deleteBlock: acceptedKeys(OPERATION_KEY_DECISIONS.deleteBlock),
+	splitBlock: acceptedKeys(OPERATION_KEY_DECISIONS.splitBlock),
+	mergeBlockWithNext: acceptedKeys(OPERATION_KEY_DECISIONS.mergeBlockWithNext),
+	setBlockParagraphProperties: acceptedKeys(OPERATION_KEY_DECISIONS.setBlockParagraphProperties),
+	insertTable: acceptedKeys(OPERATION_KEY_DECISIONS.insertTable),
+	deleteTable: acceptedKeys(OPERATION_KEY_DECISIONS.deleteTable),
+	commentOnBlock: acceptedKeys(OPERATION_KEY_DECISIONS.commentOnBlock),
+	insertSignatureTable: acceptedKeys(OPERATION_KEY_DECISIONS.insertSignatureTable),
+	insertTableRow: acceptedKeys(OPERATION_KEY_DECISIONS.insertTableRow),
+	deleteTableRow: acceptedKeys(OPERATION_KEY_DECISIONS.deleteTableRow),
+	insertTableColumn: acceptedKeys(OPERATION_KEY_DECISIONS.insertTableColumn),
+	deleteTableColumn: acceptedKeys(OPERATION_KEY_DECISIONS.deleteTableColumn),
+	mergeTableCells: acceptedKeys(OPERATION_KEY_DECISIONS.mergeTableCells),
+	splitTableCell: acceptedKeys(OPERATION_KEY_DECISIONS.splitTableCell)
 });
 const isFolioDocumentOperationType = (value) => Object.hasOwn(FOLIO_DOCUMENT_OPERATION_KEYS_BY_TYPE, value);
 const parseSignatureParties = (value, path) => {
@@ -762,6 +795,8 @@ const parseDocumentOperation = (value, index) => {
 		});
 		const lineBreakMode = value["lineBreakMode"];
 		if (lineBreakMode !== void 0 && lineBreakMode !== "paragraph" && lineBreakMode !== "inline") return invalidBatch(`${path}.lineBreakMode`, "expected \"paragraph\" or \"inline\" when provided");
+		const formattingScope = value["formattingScope"];
+		if (formattingScope !== void 0 && formattingScope !== "firstParagraph" && formattingScope !== "allParagraphs") return invalidBatch(`${path}.formattingScope`, "expected \"firstParagraph\" or \"allParagraphs\" when provided");
 		const text = readString(value, "text", path);
 		if (hardPageBreak !== void 0 && text.length > 0) return invalidBatch(`${path}.text`, "expected empty text with hardPageBreak");
 		if (hardPageBreak !== void 0 && pageBreakBefore !== void 0) return invalidBatch(`${path}.pageBreakBefore`, "cannot combine hardPageBreak with pageBreakBefore");
@@ -777,6 +812,7 @@ const parseDocumentOperation = (value, index) => {
 			...spacing !== void 0 && { spacing },
 			...indentation !== void 0 && { indentation },
 			...lineBreakMode !== void 0 && { lineBreakMode },
+			...formattingScope !== void 0 && { formattingScope },
 			...listLevel !== void 0 && { listLevel },
 			...numbering !== void 0 && { numbering },
 			...moveId !== void 0 && { moveId },

package/dist/docx/commentRangeIntegrity.js

@@ -107,7 +107,6 @@ const withoutOrphanBlockMarkers = (blocks, validCommentIds) => {
 const withoutOrphanBlockMarker = (block, validCommentIds) => {
 	if (block.type === "paragraph") return withoutOrphanParagraphMarkers(block, validCommentIds);
 	if (block.type === "table") return withoutOrphanTableMarkers(block, validCommentIds);
-	if (!("content" in block) || !block.content) return block;
 	const content = withoutOrphanBlockMarkers(block.content, validCommentIds);
 	if (!content) return block;
 	return {

package/dist/docx/headerFooterVerbatim.d.ts

@@ -1,20 +1,9 @@
 import { document_d_exports } from "../types/document.js";
 //#region src/docx/headerFooterVerbatim.d.ts
-/**
- * Folio extension on {@link HeaderFooter}: original part XML captured at parse
- * time so unedited headers/footers re-emit byte-identically on save (VML OLE
- * wrappers, smart tags, and other constructs the model cannot fully represent).
- * Cleared on first edit.
- */
-type HeaderFooterWithVerbatim = document_d_exports.HeaderFooter & {
-  verbatimXml?: string;
-  /** Fingerprint of modeled fields at parse time; verbatim replay is safe only while it matches. */
-  verbatimFingerprint?: string;
-};
 declare const getHeaderFooterVerbatimXml: (hf: document_d_exports.HeaderFooter) => string | undefined;
 declare const canReplayHeaderFooterVerbatim: (hf: document_d_exports.HeaderFooter) => boolean;
 declare const assignHeaderFooterVerbatimXml: (hf: document_d_exports.HeaderFooter, xml: string) => void;
 declare const refreshHeaderFooterVerbatimFingerprint: (hf: document_d_exports.HeaderFooter) => void;
 declare const clearHeaderFooterVerbatimXml: (hf: document_d_exports.HeaderFooter) => void;
 //#endregion
-export { HeaderFooterWithVerbatim, assignHeaderFooterVerbatimXml, canReplayHeaderFooterVerbatim, clearHeaderFooterVerbatimXml, getHeaderFooterVerbatimXml, refreshHeaderFooterVerbatimFingerprint };
+export { assignHeaderFooterVerbatimXml, canReplayHeaderFooterVerbatim, clearHeaderFooterVerbatimXml, getHeaderFooterVerbatimXml, refreshHeaderFooterVerbatimFingerprint };

package/dist/docx/numberingParser.d.ts

@@ -45,9 +45,7 @@ declare function createNumberingMap(definitions: document_d_exports.NumberingDef
 declare function computeListRendering(numPr: {
   numId?: number;
   ilvl?: number;
-}, numbering: NumberingMap): (document_d_exports.ListRendering & {
-  levelStarts: number[];
-}) | null;
+}, numbering: NumberingMap): document_d_exports.ListRendering | null;
 /**
  * Render list marker text by replacing placeholders with formatted numbers
  *

package/dist/docx/settingsParser.d.ts

@@ -1,11 +1,7 @@
 import { document_d_exports } from "../types/document.js";
 //#region src/docx/settingsParser.d.ts
-type FolioDocumentSettings = document_d_exports.DocumentSettings & {
-  /** Swap left/right section margins on even physical pages. */
-  mirrorMargins?: boolean;
-};
 /** OOXML default per §17.6.13 when `w:defaultTabStop` is absent. */
 declare const DEFAULT_TAB_STOP_TWIPS = 720;
-declare function parseSettings(xml: string | null): FolioDocumentSettings;
+declare function parseSettings(xml: string | null): document_d_exports.DocumentSettings;
 //#endregion
-export { DEFAULT_TAB_STOP_TWIPS, FolioDocumentSettings, parseSettings };
+export { DEFAULT_TAB_STOP_TWIPS, parseSettings };

package/dist/headless-layout.js

@@ -105,13 +105,7 @@ const buildFlowOptions = (document, pageContentHeight) => {
 	if (finalSectionDocumentGridLinePitchTwips !== void 0) options.finalSectionDocumentGridLinePitchTwips = finalSectionDocumentGridLinePitchTwips;
 	return options;
 };
-/**
-* `w:mirrorMargins` is parsed into `FolioDocumentSettings` but the shared
-* `Document` model types `settings` as the narrower `DocumentSettings`, so the
-* flag is present at runtime and invisible to the type. The React paged editor
-* narrows the same way; both should stop once the model carries the field.
-*/
-const readsMirrorMargins = (settings) => settings !== void 0 && "mirrorMargins" in settings && settings.mirrorMargins === true;
+const readsMirrorMargins = (settings) => settings?.mirrorMargins === true;
 const buildBlockLookup = (blocks, measures) => new Map(blocks.flatMap((block, index) => {
 	const measure = measures.at(index);
 	return measure === void 0 ? [] : [[String(block.id), {

package/dist/prosemirror/conversion/fromProseDoc.js

@@ -15,6 +15,7 @@ import { autospacingMatchesBase, hasAutospacingBaseSide } from "../autospacingBa
 import { expectBookmarkBoundaryAttrs } from "../bookmarkBoundaryAttrs.js";
 import { paragraphRejectAttrPatch, paragraphRejectOriginalFormatting, removeParagraphPropertyChanges } from "../commands/propertyChangeScope.js";
 import { applyRunFormattingOverrideAttrs, buildRunFormattingOverrideAttrs } from "../extensions/marks/RunFormattingOverrideExtension.js";
+import { listRenderingFromAttrs as listRenderingFromAttrs$1 } from "../listRenderingAttrs.js";
 import { resolveNumberedRefFields } from "../numberedRefFields.js";
 import { directParagraphAlignment } from "../paragraphAlignment.js";
 import { directionToBidi } from "../paragraphDirection.js";
@@ -657,25 +658,10 @@ function listRenderingFromAttrs(attrs) {
 	const numId = attrs.numPr?.numId;
 	if (numId === void 0 || numId === 0) return;
 	if (!(attrs.listMarker != null || attrs.listIsBullet || attrs.listNumFmt != null)) return;
-	return {
-		marker: attrs.listMarker ?? "",
-		...attrs.listMarkerTemplate != null && { markerTemplate: attrs.listMarkerTemplate },
-		level: attrs.numPr?.ilvl ?? 0,
-		numId,
-		isBullet: attrs.listIsBullet ?? false,
-		...attrs.listIsLegal != null && { isLegal: attrs.listIsLegal },
-		...attrs.listNumFmt != null && { numFmt: attrs.listNumFmt },
-		...attrs.listMarkerHidden != null && { markerHidden: attrs.listMarkerHidden },
-		...attrs.listMarkerFormatting != null && { markerFormatting: attrs.listMarkerFormatting },
-		...attrs.listMarkerAlignment != null && { markerAlignment: attrs.listMarkerAlignment },
-		...attrs.listMarkerSuffix != null && { markerSuffix: attrs.listMarkerSuffix },
-		...attrs.listMarkerAllCaps != null && { markerAllCaps: attrs.listMarkerAllCaps },
-		...attrs.listImplicitChildLevelAdvances != null && { implicitChildLevelAdvances: attrs.listImplicitChildLevelAdvances },
-		...attrs.listMarkerSecondSlotOffsetTwips != null && { markerSecondSlotOffsetTwips: attrs.listMarkerSecondSlotOffsetTwips },
-		...attrs.listLevelNumFmts != null && { levelNumFmts: attrs.listLevelNumFmts },
-		...attrs.listAbstractNumId != null && { abstractNumId: attrs.listAbstractNumId },
-		...attrs.listStartOverride != null && { startOverride: attrs.listStartOverride }
-	};
+	return listRenderingFromAttrs$1({
+		attrs,
+		numId
+	});
 }
 /**
 * Create a paragraph containing only a page break run (for DOCX serialization)

package/dist/prosemirror/conversion/toProseDoc.js

@@ -9,6 +9,7 @@ import { mergeTextFormatting } from "../../utils/textFormattingMerge.js";
 import { emuToPixels } from "../../utils/units.js";
 import { setAutospacingBaseValue } from "../autospacingBase.js";
 import { buildRunFormattingOverrideAttrs } from "../extensions/marks/RunFormattingOverrideExtension.js";
+import { listRenderingAttrPatch } from "../listRenderingAttrs.js";
 import { stampNumberedRefFieldBaselines } from "../numberedRefFields.js";
 import { pageBreakRunParagraphProjectionDispositionForFeatures } from "../pageBreakRunProjection.js";
 import { directionFromBidi } from "../paragraphDirection.js";
@@ -422,25 +423,7 @@ function paragraphFormattingToAttrs(paragraph, styleResolver, tableParagraphOver
 	if (tableOfContentsLevel !== void 0) attrs._tableOfContentsLevel = tableOfContentsLevel;
 	if (formatting?.numPr) attrs.numPr = formatting.numPr;
 	if (formatting?.numPrFromStyle) attrs.numPrFromStyle = formatting.numPrFromStyle;
-	if (paragraph.listRendering?.numFmt) attrs.listNumFmt = paragraph.listRendering.numFmt;
-	if (paragraph.listRendering?.isBullet) attrs.listIsBullet = paragraph.listRendering.isBullet;
-	if (paragraph.listRendering?.isLegal) attrs.listIsLegal = paragraph.listRendering.isLegal;
-	if (paragraph.listRendering?.marker) attrs.listMarker = paragraph.listRendering.marker;
-	if (paragraph.listRendering?.markerTemplate) attrs.listMarkerTemplate = paragraph.listRendering.markerTemplate;
-	if (paragraph.listRendering?.markerHidden) attrs.listMarkerHidden = paragraph.listRendering.markerHidden;
-	if (paragraph.listRendering?.markerFormatting) attrs.listMarkerFormatting = paragraph.listRendering.markerFormatting;
-	if (paragraph.listRendering?.markerAlignment) attrs.listMarkerAlignment = paragraph.listRendering.markerAlignment;
-	if (paragraph.listRendering?.markerSuffix) attrs.listMarkerSuffix = paragraph.listRendering.markerSuffix;
-	if (paragraph.listRendering?.markerAllCaps) attrs.listMarkerAllCaps = paragraph.listRendering.markerAllCaps;
-	if (paragraph.listRendering?.implicitChildLevelAdvances !== void 0) attrs.listImplicitChildLevelAdvances = paragraph.listRendering.implicitChildLevelAdvances;
-	if (paragraph.listRendering?.markerSecondSlotOffsetTwips !== void 0) attrs.listMarkerSecondSlotOffsetTwips = paragraph.listRendering.markerSecondSlotOffsetTwips;
-	if (paragraph.listRendering?.levelNumFmts) attrs.listLevelNumFmts = paragraph.listRendering.levelNumFmts;
-	if (paragraph.listRendering && "levelStarts" in paragraph.listRendering) {
-		const { levelStarts } = paragraph.listRendering;
-		if (Array.isArray(levelStarts) && levelStarts.every((value) => typeof value === "number")) attrs.listLevelStarts = levelStarts;
-	}
-	if (paragraph.listRendering?.abstractNumId !== void 0) attrs.listAbstractNumId = paragraph.listRendering.abstractNumId;
-	if (paragraph.listRendering?.startOverride !== void 0) attrs.listStartOverride = paragraph.listRendering.startOverride;
+	if (paragraph.listRendering) Object.assign(attrs, listRenderingAttrPatch(paragraph.listRendering));
 	if (formatting) attrs._originalFormatting = formatting;
 	if (paragraph.propertyChanges && paragraph.propertyChanges.length > 0) attrs._propertyChanges = [...paragraph.propertyChanges];
 	if (paragraph.pPrMark) attrs.pPrMark = paragraph.pPrMark;

package/dist/prosemirror/extensions/features/ListExtension.js

@@ -1,6 +1,7 @@
 import { expectParagraphAttrs } from "../../attrs/index.js";
 import { PPR_CHANGE_SCOPED_ATTR_KEYS, hasSerializableParagraphPropertyChange } from "../../commands/propertyChangeScope.js";
-import { CLEARED_LIST_RENDERING_ATTRS, LIST_RENDERING_ATTR_KEYS } from "../../listMarker.js";
+import { CLEARED_LIST_RENDERING_ATTRS } from "../../listMarker.js";
+import { LIST_RENDERING_ATTR_KEYS } from "../../listRenderingAttrs.js";
 import { getDocumentNumbering } from "../../plugins/documentNumbering.js";
 import { SUGGESTION_META, makeRevisionInfo } from "../../plugins/suggestionMode.js";
 import { listLevelAttrPatch } from "../../styles/resolvedStyleAttrs.js";

package/dist/prosemirror/listMarker.d.ts

@@ -1,5 +1,6 @@
 import { document_d_exports } from "../types/document.js";
 import { ParagraphAttrs } from "./schema/nodes.js";
+import { LIST_RENDERING_ATTR_KEYS } from "./listRenderingAttrs.js";
 //#region src/prosemirror/listMarker.d.ts
 type ListCounterState = {
   counters: Map<number, number[]>;
@@ -42,7 +43,6 @@ type ResolvedListTemplate = {
   components: readonly ResolvedListComponent[];
 };
 declare const MAX_LIST_LEVEL = 8;
-declare const LIST_RENDERING_ATTR_KEYS: readonly ["listIsBullet", "listIsLegal", "listNumFmt", "listMarker", "listMarkerTemplate", "listMarkerHidden", "listMarkerFormatting", "listMarkerAlignment", "listMarkerSuffix", "listMarkerAllCaps", "listImplicitChildLevelAdvances", "listMarkerSecondSlotOffsetTwips", "listLevelNumFmts", "listLevelStarts", "listAbstractNumId", "listStartOverride"];
 declare const CLEARED_LIST_RENDERING_ATTRS: Readonly<{
   listIsBullet: null;
   listIsLegal: null;

package/dist/prosemirror/listMarker.js

@@ -1,25 +1,8 @@
 import { convertBulletToUnicode } from "../docx/bulletMarkers.js";
 import { formatOoxmlCounter } from "../docx/ooxmlCounterFormatter.js";
+import { LIST_RENDERING_ATTR_KEYS } from "./listRenderingAttrs.js";
 //#region src/prosemirror/listMarker.ts
 const MAX_LIST_LEVEL = 8;
-const LIST_RENDERING_ATTR_KEYS = [
-	"listIsBullet",
-	"listIsLegal",
-	"listNumFmt",
-	"listMarker",
-	"listMarkerTemplate",
-	"listMarkerHidden",
-	"listMarkerFormatting",
-	"listMarkerAlignment",
-	"listMarkerSuffix",
-	"listMarkerAllCaps",
-	"listImplicitChildLevelAdvances",
-	"listMarkerSecondSlotOffsetTwips",
-	"listLevelNumFmts",
-	"listLevelStarts",
-	"listAbstractNumId",
-	"listStartOverride"
-];
 const CLEARED_LIST_RENDERING_ATTRS = Object.freeze({
 	listIsBullet: null,
 	listIsLegal: null,

package/dist/prosemirror/listRenderingAttrs.d.ts

@@ -0,0 +1,42 @@
+import { document_d_exports } from "../types/document.js";
+import { ParagraphAttrs } from "./schema/nodes.js";
+//#region src/prosemirror/listRenderingAttrs.d.ts
+/** `ListRendering` fields that have their own editor attr. */
+type ListRenderingAttrField = Exclude<keyof document_d_exports.ListRendering, "level" | "numId">;
+declare const LIST_RENDERING_ATTR_BY_FIELD: {
+  readonly marker: "listMarker";
+  readonly markerTemplate: "listMarkerTemplate";
+  readonly isBullet: "listIsBullet";
+  readonly isLegal: "listIsLegal";
+  readonly numFmt: "listNumFmt";
+  readonly markerHidden: "listMarkerHidden";
+  readonly markerFormatting: "listMarkerFormatting";
+  readonly markerAlignment: "listMarkerAlignment";
+  readonly markerAllCaps: "listMarkerAllCaps";
+  readonly markerSuffix: "listMarkerSuffix";
+  readonly levelNumFmts: "listLevelNumFmts";
+  readonly levelStarts: "listLevelStarts";
+  readonly abstractNumId: "listAbstractNumId";
+  readonly startOverride: "listStartOverride";
+  readonly implicitChildLevelAdvances: "listImplicitChildLevelAdvances";
+  readonly markerSecondSlotOffsetTwips: "listMarkerSecondSlotOffsetTwips";
+};
+type ListRenderingAttrKey = (typeof LIST_RENDERING_ATTR_BY_FIELD)[ListRenderingAttrField];
+declare const LIST_RENDERING_ATTR_KEYS: readonly ListRenderingAttrKey[];
+/**
+ * Editor attrs carrying `rendering`. A falsy marker, flag or format is left
+ * unset: the editor treats `null` and absent alike for those, and the parser
+ * never authors them as `false` or `""` deliberately.
+ */
+declare const listRenderingAttrPatch: (rendering: document_d_exports.ListRendering) => Partial<ParagraphAttrs>;
+type ListRenderingFromAttrsOptions = {
+  attrs: ParagraphAttrs;
+  numId: number;
+};
+/**
+ * Inverse of `listRenderingAttrPatch`. The caller decides whether the
+ * paragraph is a list item at all; this only reassembles the fields.
+ */
+declare const listRenderingFromAttrs: ({ attrs, numId }: ListRenderingFromAttrsOptions) => document_d_exports.ListRendering;
+//#endregion
+export { LIST_RENDERING_ATTR_BY_FIELD, LIST_RENDERING_ATTR_KEYS, ListRenderingAttrField, ListRenderingAttrKey, listRenderingAttrPatch, listRenderingFromAttrs };

package/dist/prosemirror/listRenderingAttrs.js

@@ -0,0 +1,80 @@
+//#region src/prosemirror/listRenderingAttrs.ts
+const LIST_RENDERING_ATTR_BY_FIELD = {
+	marker: "listMarker",
+	markerTemplate: "listMarkerTemplate",
+	isBullet: "listIsBullet",
+	isLegal: "listIsLegal",
+	numFmt: "listNumFmt",
+	markerHidden: "listMarkerHidden",
+	markerFormatting: "listMarkerFormatting",
+	markerAlignment: "listMarkerAlignment",
+	markerAllCaps: "listMarkerAllCaps",
+	markerSuffix: "listMarkerSuffix",
+	levelNumFmts: "listLevelNumFmts",
+	levelStarts: "listLevelStarts",
+	abstractNumId: "listAbstractNumId",
+	startOverride: "listStartOverride",
+	implicitChildLevelAdvances: "listImplicitChildLevelAdvances",
+	markerSecondSlotOffsetTwips: "listMarkerSecondSlotOffsetTwips"
+};
+const LIST_RENDERING_ATTR_KEYS = Object.values(LIST_RENDERING_ATTR_BY_FIELD);
+const isDefinedEntry = ([, value]) => value !== void 0;
+const definedAttrs = (patch) => Object.fromEntries(Object.entries(patch).filter(isDefinedEntry));
+const definedFields = (fields) => Object.fromEntries(Object.entries(fields).filter(isDefinedEntry));
+/**
+* Editor attrs carrying `rendering`. A falsy marker, flag or format is left
+* unset: the editor treats `null` and absent alike for those, and the parser
+* never authors them as `false` or `""` deliberately.
+*/
+const listRenderingAttrPatch = (rendering) => {
+	const patch = {
+		listMarker: rendering.marker || void 0,
+		listMarkerTemplate: rendering.markerTemplate || void 0,
+		listIsBullet: rendering.isBullet || void 0,
+		listIsLegal: rendering.isLegal || void 0,
+		listNumFmt: rendering.numFmt || void 0,
+		listMarkerHidden: rendering.markerHidden || void 0,
+		listMarkerFormatting: rendering.markerFormatting || void 0,
+		listMarkerAlignment: rendering.markerAlignment || void 0,
+		listMarkerAllCaps: rendering.markerAllCaps || void 0,
+		listMarkerSuffix: rendering.markerSuffix || void 0,
+		listLevelNumFmts: rendering.levelNumFmts || void 0,
+		listLevelStarts: rendering.levelStarts || void 0,
+		listAbstractNumId: rendering.abstractNumId,
+		listStartOverride: rendering.startOverride,
+		listImplicitChildLevelAdvances: rendering.implicitChildLevelAdvances,
+		listMarkerSecondSlotOffsetTwips: rendering.markerSecondSlotOffsetTwips
+	};
+	return definedAttrs(patch);
+};
+/**
+* Inverse of `listRenderingAttrPatch`. The caller decides whether the
+* paragraph is a list item at all; this only reassembles the fields.
+*/
+const listRenderingFromAttrs = ({ attrs, numId }) => {
+	const optional = {
+		markerTemplate: attrs.listMarkerTemplate ?? void 0,
+		isLegal: attrs.listIsLegal ?? void 0,
+		numFmt: attrs.listNumFmt ?? void 0,
+		markerHidden: attrs.listMarkerHidden ?? void 0,
+		markerFormatting: attrs.listMarkerFormatting ?? void 0,
+		markerAlignment: attrs.listMarkerAlignment ?? void 0,
+		markerAllCaps: attrs.listMarkerAllCaps ?? void 0,
+		markerSuffix: attrs.listMarkerSuffix ?? void 0,
+		levelNumFmts: attrs.listLevelNumFmts ?? void 0,
+		levelStarts: attrs.listLevelStarts ?? void 0,
+		abstractNumId: attrs.listAbstractNumId ?? void 0,
+		startOverride: attrs.listStartOverride ?? void 0,
+		implicitChildLevelAdvances: attrs.listImplicitChildLevelAdvances ?? void 0,
+		markerSecondSlotOffsetTwips: attrs.listMarkerSecondSlotOffsetTwips ?? void 0
+	};
+	return {
+		marker: attrs.listMarker ?? "",
+		level: attrs.numPr?.ilvl ?? 0,
+		numId,
+		isBullet: attrs.listIsBullet ?? false,
+		...definedFields(optional)
+	};
+};
+//#endregion
+export { LIST_RENDERING_ATTR_BY_FIELD, LIST_RENDERING_ATTR_KEYS, listRenderingAttrPatch, listRenderingFromAttrs };

package/dist/prosemirror/schema/marks.d.ts

@@ -201,7 +201,7 @@ type RunFormattingOverrideAttrs = {
   position?: 0;
   rtl?: false;
   scale?: 100;
-  shading?: ShadingProperties & {
+  shading?: Omit<ShadingProperties, "pattern"> & {
     pattern: "nil";
   };
   spacing?: 0;

package/dist/prosemirror/styles/resolvedStyleAttrs.js

@@ -2,6 +2,7 @@ import { computeListRendering, numberingLevelHasMarkerSlot } from "../../docx/nu
 import { tableOfContentsStyleLevel } from "../../utils/tableOfContentsStyle.js";
 import { setAutospacingBaseValue } from "../autospacingBase.js";
 import { CLEARED_LIST_RENDERING_ATTRS } from "../listMarker.js";
+import { listRenderingAttrPatch } from "../listRenderingAttrs.js";
 //#region src/prosemirror/styles/resolvedStyleAttrs.ts
 /**
 * Shared helper for projecting a resolved paragraph style onto ProseMirror
@@ -103,20 +104,7 @@ function listAttrsFromNumbering(numPr, numbering) {
 	return {
 		...CLEARED_LIST_RENDERING_ATTRS,
 		numPr: targetNumPr,
-		listNumFmt: rendering?.numFmt ?? null,
-		listIsBullet: rendering?.isBullet ?? null,
-		listIsLegal: rendering?.isLegal ?? null,
-		listMarker: rendering?.marker ?? null,
-		listMarkerTemplate: rendering?.markerTemplate ?? null,
-		listMarkerHidden: rendering?.markerHidden ?? null,
-		listMarkerFormatting: rendering?.markerFormatting ?? null,
-		listMarkerAlignment: rendering?.markerAlignment ?? null,
-		listMarkerSuffix: rendering?.markerSuffix ?? null,
-		listMarkerAllCaps: rendering?.markerAllCaps ?? null,
-		listLevelNumFmts: rendering?.levelNumFmts ?? null,
-		listLevelStarts: rendering?.levelStarts ?? null,
-		listAbstractNumId: rendering?.abstractNumId ?? null,
-		listStartOverride: rendering?.startOverride ?? null
+		...rendering && listRenderingAttrPatch(rendering)
 	};
 }
 /** Recompute every level-dependent attr when a paragraph changes list level. */

package/dist/utils/mergeDocumentContent.js

@@ -85,7 +85,7 @@ function mergeDocumentContent(target, source) {
 function remapBlock(block, numIdRemap, abstractNumIdRemap) {
 	if (block.type === "paragraph") return remapParagraph(block, numIdRemap, abstractNumIdRemap);
 	if (block.type === "table") return remapTable(block, numIdRemap, abstractNumIdRemap);
-	if ("content" in block && Array.isArray(block.content)) return {
+	if (block.type === "blockSdt" && Array.isArray(block.content)) return {
 		...block,
 		content: block.content.map((child) => remapBlock(child, numIdRemap, abstractNumIdRemap))
 	};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stll/folio-core",
-  "version": "0.39.1",
+  "version": "0.40.0",
   "description": "Headless, framework-neutral core of folio: the OOXML (.docx) parser, document model, ProseMirror integration, and page-layout engine. No React.",
   "keywords": [
     "document-model",
@@ -121,7 +121,7 @@
     "perf": "bun scripts/profile-editor.ts"
   },
   "dependencies": {
-    "@stll/docx-core": "^0.20.1",
+    "@stll/docx-core": "^0.20.2",
     "@stll/docx-utils": "^0.1.0",
     "@stll/template-conditions": ">=0.4.0 <1.0.0",
     "better-result": "3.0.1",