superdoc 2.28.0 → 2.29.0-next.1

package/dist/chunks/{create-super-doc-ui-BbjHD1ul.es.js → create-super-doc-ui-Duf65d0b.es.js}

@@ -1,4 +1,5 @@
 import { B as renderList, D as normalizeClass, E as nextTick, F as openBlock, G as toDisplayString, N as onMounted, W as shallowRef, Y as unref, a as computed, at as withModifiers, c as createCommentVNode, f as createTextVNode, h as defineComponent, j as onBeforeUnmount, l as createElementBlock, n as Fragment, t as _plugin_vue_export_helper_default, tt as watch, u as createElementVNode, z as ref } from "./_plugin-vue_export-helper-CsJQtMvr.es.js";
+import { t as isFiniteNumber } from "./is-finite-number-BpL4F38c.es.js";
 //#region src/internal/diagnostics/workflow-recording.ts
 var fields$1 = /* @__PURE__ */ new Set([
 	"documentId",
@@ -1096,6 +1097,163 @@ function isPlainObject(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 //#endregion
+//#region src/core/collaboration/permissions.js
+var PERMISSIONS = Object.freeze({
+	RESOLVE_OWN: "RESOLVE_OWN",
+	RESOLVE_OTHER: "RESOLVE_OTHER",
+	REJECT_OWN: "REJECT_OWN",
+	REJECT_OTHER: "REJECT_OTHER",
+	COMMENTS_OVERFLOW_OWN: "COMMENTS_OVERFLOW",
+	COMMENTS_OVERFLOW_OTHER: "COMMENTS_OVERFLOW_OTHER",
+	COMMENTS_DELETE_OWN: "COMMENTS_DELETE_OWN",
+	COMMENTS_DELETE_OTHER: "COMMENTS_DELETE_OTHER",
+	UPLOAD_VERSION: "UPLOAD_VERSION",
+	VERSION_HISTORY: "VERSION_HISTORY"
+});
+var ROLES = Object.freeze({
+	EDITOR: "editor",
+	SUGGESTER: "suggester",
+	VIEWER: "viewer"
+});
+var PERMISSION_MATRIX = Object.freeze({
+	[PERMISSIONS.RESOLVE_OWN]: {
+		internal: [ROLES.EDITOR],
+		external: [ROLES.EDITOR]
+	},
+	[PERMISSIONS.RESOLVE_OTHER]: {
+		internal: [ROLES.EDITOR],
+		external: [ROLES.EDITOR]
+	},
+	[PERMISSIONS.REJECT_OWN]: {
+		internal: [ROLES.EDITOR, ROLES.SUGGESTER],
+		external: [ROLES.EDITOR, ROLES.SUGGESTER]
+	},
+	[PERMISSIONS.REJECT_OTHER]: {
+		internal: [ROLES.EDITOR],
+		external: [ROLES.EDITOR]
+	},
+	[PERMISSIONS.COMMENTS_OVERFLOW_OWN]: {
+		internal: [ROLES.EDITOR, ROLES.SUGGESTER],
+		external: [ROLES.EDITOR, ROLES.SUGGESTER]
+	},
+	[PERMISSIONS.COMMENTS_OVERFLOW_OTHER]: {
+		internal: [ROLES.EDITOR],
+		external: [ROLES.EDITOR]
+	},
+	[PERMISSIONS.COMMENTS_DELETE_OWN]: {
+		internal: [ROLES.EDITOR, ROLES.SUGGESTER],
+		external: [ROLES.EDITOR, ROLES.SUGGESTER]
+	},
+	[PERMISSIONS.COMMENTS_DELETE_OTHER]: {
+		internal: [ROLES.EDITOR],
+		external: [ROLES.EDITOR]
+	},
+	[PERMISSIONS.UPLOAD_VERSION]: {
+		internal: [ROLES.EDITOR],
+		external: []
+	},
+	[PERMISSIONS.VERSION_HISTORY]: {
+		internal: [ROLES.EDITOR],
+		external: []
+	}
+});
+var pickResolver = (context = {}) => {
+	if (typeof context.permissionResolver === "function") return context.permissionResolver;
+	if (typeof context.superdoc?.config?.permissionResolver === "function") return context.superdoc.config.permissionResolver;
+	const deprecatedResolver = context.superdoc?.config?.modules?.comments?.permissionResolver;
+	if (typeof deprecatedResolver === "function") return deprecatedResolver;
+	return null;
+};
+var BUILT_IN_PERMISSION_METHOD = Symbol.for("superdoc.internal.permission-method.builtin");
+var BUILT_IN_PERMISSION_RESOLVER = Symbol.for("superdoc.internal.permission-resolver.builtin");
+/** Create the shell's internal, live tracked-change permission shim. */
+var createTrackedChangePermissionResolver = (superdoc) => {
+	const isBuiltInPolicy = () => superdoc.canPerformPermission?.[BUILT_IN_PERMISSION_METHOD] === true && pickResolver({ superdoc }) === null;
+	const resolver = (payload = {}) => isBuiltInPolicy() ? defaultDecisionFor(payload.permission, superdoc.config.role, superdoc.config.isInternal) : superdoc.canPerformPermission({
+		...payload,
+		role: superdoc.config.role,
+		isInternal: superdoc.config.isInternal
+	});
+	Object.defineProperty(resolver, BUILT_IN_PERMISSION_RESOLVER, { value: isBuiltInPolicy });
+	return resolver;
+};
+var defaultDecisionFor = (permission, role, isInternal) => {
+	const internalExternal = isInternal ? "internal" : "external";
+	return PERMISSION_MATRIX[permission]?.[internalExternal]?.includes(role) ?? false;
+};
+var NON_DATA_PERMISSION_PROPERTY = Symbol();
+var readPermissionDataProperty = (source, key) => {
+	if (source == null) return void 0;
+	if (typeof source !== "object" && typeof source !== "function") return NON_DATA_PERMISSION_PROPERTY;
+	for (let owner = source; owner !== null; owner = Object.getPrototypeOf(owner)) {
+		const descriptor = Object.getOwnPropertyDescriptor(owner, key);
+		if (descriptor) return "value" in descriptor ? descriptor.value : NON_DATA_PERMISSION_PROPERTY;
+	}
+};
+var readBuiltInTrackedChangePermissionDecision = (superdoc, canPerform, permission, trackedChange) => {
+	try {
+		if (readPermissionDataProperty(superdoc, "canPerformPermission") !== canPerform || readPermissionDataProperty(canPerform, BUILT_IN_PERMISSION_METHOD) !== true) return null;
+		const config = readPermissionDataProperty(superdoc, "config");
+		if (!config || typeof config !== "object") return null;
+		const role = readPermissionDataProperty(config, "role");
+		const isInternal = readPermissionDataProperty(config, "isInternal");
+		const user = readPermissionDataProperty(config, "user");
+		const resolver = readPermissionDataProperty(config, "permissionResolver");
+		const modules = readPermissionDataProperty(config, "modules");
+		const comments = readPermissionDataProperty(modules, "comments");
+		const deprecatedResolver = readPermissionDataProperty(comments, "permissionResolver");
+		const commentsStore = readPermissionDataProperty(superdoc, "commentsStore");
+		if ([
+			role,
+			isInternal,
+			user,
+			resolver,
+			modules,
+			comments,
+			deprecatedResolver,
+			commentsStore,
+			readPermissionDataProperty(commentsStore, "getComment"),
+			readPermissionDataProperty(trackedChange, "comment"),
+			readPermissionDataProperty(trackedChange, "commentId"),
+			readPermissionDataProperty(trackedChange, "id")
+		].includes(NON_DATA_PERMISSION_PROPERTY) || typeof resolver === "function" || typeof deprecatedResolver === "function") return null;
+		return defaultDecisionFor(permission, role, isInternal);
+	} catch {
+		return null;
+	}
+};
+/**
+* Resolve a client-side permission through the built-in matrix and optional
+* resolver.
+*
+* @param {string} permission The permission to check
+* @param {string} role The role to check
+* @param {boolean} isInternal The internal/external flag
+* @param {object} [context] Context passed to the permission resolver
+* @param {object | null} [context.comment] The comment/tracked change being evaluated
+* @param {object | null} [context.superdoc] The SuperDoc instance
+* @param {object | null} [context.currentUser] The active user object performing the action
+* @param {Function} [context.permissionResolver] Explicit resolver override
+* @param {object | null} [context.trackedChange] Tracked change metadata (for tracked-change permissions)
+* @returns {boolean} Whether the permission is allowed
+*/
+var isAllowed = (permission, role, isInternal, context = {}) => {
+	const defaultDecision = defaultDecisionFor(permission, role, isInternal);
+	const resolver = pickResolver(context);
+	if (typeof resolver !== "function") return defaultDecision;
+	const decision = resolver({
+		permission,
+		role,
+		isInternal,
+		defaultDecision,
+		comment: context.comment ?? null,
+		currentUser: context.currentUser ?? context.superdoc?.config?.user ?? null,
+		superdoc: context.superdoc ?? null,
+		trackedChange: context.trackedChange ?? null
+	});
+	return typeof decision === "boolean" ? decision : defaultDecision;
+};
+//#endregion
 //#region src/public/ui/viewport-batch.ts
 /** No rendering or scrolling: read only geometry already acknowledged by the host. */
 async function readViewportBatch(input, read, generation, disposed) {
@@ -2495,7 +2653,7 @@ function toStyleValue(key, value) {
 		case "italic": return value === true;
 		case "underline": return underlineValue(value);
 		case "color": return typeof value === "string" && value.length > 0 ? { val: value.replace(/^#/, "") } : null;
-		case "fontSize": return typeof value === "number" && Number.isFinite(value) ? Math.round(value * 2) : null;
+		case "fontSize": return isFiniteNumber(value) ? Math.round(value * 2) : null;
 		case "rFonts": return fontsValue(value);
 		default: return null;
 	}
@@ -2987,7 +3145,7 @@ function normalizeZoomPayload(payload) {
 		if (!Number.isFinite(parsed)) return payload;
 		return normalizeNumber(parsed, isPercent);
 	}
-	if (typeof payload === "number" && Number.isFinite(payload)) return normalizeNumber(payload, false);
+	if (isFiniteNumber(payload)) return normalizeNumber(payload, false);
 	return payload;
 }
 /**
@@ -5357,9 +5515,6 @@ var PARAGRAPH_INDENT_STEP_TWIPS = 720;
 function pointsToTwips(value) {
 	return Math.round(value * 20);
 }
-function isFiniteNumber(value) {
-	return typeof value === "number" && Number.isFinite(value);
-}
 function readParagraphIndentationFromResult(result) {
 	if (!result || typeof result !== "object") return null;
 	const node = result.node;
@@ -5663,7 +5818,7 @@ function normalizeLayoutFontFamily(value) {
 }
 /** Convert a resolved run font size in CSS px to the toolbar's point value (SD-3652). */
 function normalizeLayoutFontSizePt(value) {
-	if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) return void 0;
+	if (!isFiniteNumber(value) || value <= 0) return void 0;
 	const pt = Math.round(value * .75 * 2) / 2;
 	if (pt <= 0) return void 0;
 	return String(pt);
@@ -6401,7 +6556,7 @@ function createSuperDocUI(options) {
 		if (!pending || !(method in pending)) return void 0;
 		const value = pending[method];
 		if (typeof value === "string" && value !== "") return value;
-		if (typeof value === "number" && Number.isFinite(value)) return String(value);
+		if (isFiniteNumber(value)) return String(value);
 	};
 	/** Record / clear the stored inline mark for a collapsed-caret pick (SD-3654/SD-3652). */
 	const setPendingInlineFormatOnHost = (method, value) => {
@@ -8799,9 +8954,10 @@ function createSuperDocUI(options) {
 			for (const candidate of permissions) {
 				let allowed;
 				try {
-					allowed = canPerform.call(superdoc, {
+					const permissionChange = trackedChange ?? { id };
+					allowed = readBuiltInTrackedChangePermissionDecision(superdoc, canPerform, candidate, permissionChange) ?? canPerform.call(superdoc, {
 						permission: candidate,
-						trackedChange: trackedChange ?? { id },
+						trackedChange: permissionChange,
 						comment: null
 					});
 				} catch {
@@ -9694,7 +9850,7 @@ function createSuperDocUI(options) {
 	};
 	/** Validate normalized payloads before invoking public SuperDoc-instance methods. */
 	const instanceCommandPayloadIsValid = (descriptor, payload) => {
-		if (descriptor.id === "zoom") return typeof payload === "number" && Number.isFinite(payload) && payload > 0;
+		if (descriptor.id === "zoom") return isFiniteNumber(payload) && payload > 0;
 		if (descriptor.id === "document-mode") return payload === "editing" || payload === "suggesting" || payload === "viewing";
 		if (descriptor.id === "measurement-unit") return payload === "in" || payload === "cm";
 		return true;
@@ -10082,7 +10238,7 @@ function createSuperDocUI(options) {
 		const familyValue = state.toolbar.commands["font-family"]?.value;
 		const sizeValue = state.toolbar.commands["font-size"]?.value;
 		const hadFamily = typeof familyValue === "string" && familyValue.length > 0;
-		const hadSize = typeof sizeValue === "string" && sizeValue.length > 0 || typeof sizeValue === "number" && Number.isFinite(sizeValue);
+		const hadSize = typeof sizeValue === "string" && sizeValue.length > 0 || isFiniteNumber(sizeValue);
 		return hadFamily && projected.fontFamily === void 0 || hadSize && projected.fontSize === void 0;
 	};
 	const syncHostSelectionSubscription = () => {
@@ -12276,12 +12432,6 @@ function createSuperDocUI(options) {
 			keys: [...EFFECTIVE_INLINE_UNIFORMITY_KEYS, "highlight"],
 			includeCaret: true
 		} : null);
-		if (effective?.fontFamily?.state === "mixed") {
-			delete inlinePatch.fontFamily;
-			delete inlinePatch.rFonts;
-			mixedInlineKeys.add("fontFamily");
-			mixedInlineKeys.add("rFonts");
-		}
 		for (const [markName, patchKey] of Object.entries(MARK_TO_PATCH)) {
 			const entry = effective?.[markName];
 			if (!entry) continue;
@@ -12293,6 +12443,16 @@ function createSuperDocUI(options) {
 				mixedInlineKeys.add(patchKey);
 			}
 		}
+		const fontFamily = effective?.fontFamily;
+		if (fontFamily?.state === "uniform" && typeof fontFamily.value === "string") {
+			inlinePatch.fontFamily = fontFamily.value;
+			mixedInlineKeys.delete("fontFamily");
+		} else if (fontFamily) {
+			delete inlinePatch.fontFamily;
+			delete inlinePatch.rFonts;
+			mixedInlineKeys.add("fontFamily");
+			mixedInlineKeys.add("rFonts");
+		}
 		const highlight = effective?.highlight;
 		if (highlight?.state === "uniform") {
 			inlinePatch.highlight = highlight.value;
@@ -13914,7 +14074,7 @@ function createSuperDocUI(options) {
 		return null;
 	};
 	const pointHitElements = (x, y) => {
-		if (typeof x !== "number" || typeof y !== "number" || !Number.isFinite(x) || !Number.isFinite(y)) return null;
+		if (!isFiniteNumber(x) || !isFiniteNumber(y)) return null;
 		const dom = globalThis.document;
 		if (!dom || typeof dom.elementFromPoint !== "function") return null;
 		const container = resolveVisibleHost();
@@ -14692,7 +14852,7 @@ function createSuperDocUI(options) {
 		const record = result && typeof result === "object" ? result : null;
 		if (!record) return null;
 		const matches = Array.isArray(record.matches) ? record.matches : [];
-		const total = typeof record.total === "number" && Number.isFinite(record.total) ? record.total : matches.length;
+		const total = isFiniteNumber(record.total) ? record.total : matches.length;
 		const activeIndex = typeof record.activeMatchIndex === "number" ? record.activeMatchIndex : typeof record.activeIndex === "number" ? record.activeIndex : -1;
 		const canReplace = record.canReplace === true || fallbackCanReplace;
 		return {
@@ -15716,4 +15876,4 @@ function commandIsActive(descriptor, selection) {
 	return descriptor.activeMark ? selection.activeMarks.includes(descriptor.activeMark) : false;
 }
 //#endregion
-export { recordInteraction as S, DOM_CLASS_NAMES as _, registerFirstPartyCommandMutation as a, getWorkflowRecording as b, getCommandDescriptor as c, mutationCommittedEventChangedDocument as d, createImageFilePicker as f, isSyntheticTrackedChangeCommentLaneItem as g, isPlainObject as h, readFirstPartyPageNumbers as i, applyV2CommentInvalidationFromMutation as l, shallowEqual as m, executeFirstPartyCommandAsync as n, isRecord as o, resolveImageSrc as p, executeFirstPartyShortcutAsync as r, BUILT_IN_COMMAND_IDS as s, createSuperDocUI as t, getV2TrackedChangeMutationImpact as u, closeInteractionHistory as v, isWorkflowRecordingEnabled as x, createInteractionHistory as y };
+export { getWorkflowRecording as C, createInteractionHistory as S, recordInteraction as T, isAllowed as _, registerFirstPartyCommandMutation as a, DOM_CLASS_NAMES as b, getCommandDescriptor as c, mutationCommittedEventChangedDocument as d, createImageFilePicker as f, createTrackedChangePermissionResolver as g, PERMISSIONS as h, readFirstPartyPageNumbers as i, applyV2CommentInvalidationFromMutation as l, shallowEqual as m, executeFirstPartyCommandAsync as n, isRecord as o, resolveImageSrc as p, executeFirstPartyShortcutAsync as r, BUILT_IN_COMMAND_IDS as s, createSuperDocUI as t, getV2TrackedChangeMutationImpact as u, isPlainObject as v, isWorkflowRecordingEnabled as w, closeInteractionHistory as x, isSyntheticTrackedChangeCommentLaneItem as y };

package/dist/chunks/is-finite-number-BEXgTRgc.cjs

@@ -0,0 +1,11 @@
+//#region src/helpers/is-finite-number.ts
+function isFiniteNumber(value) {
+	return typeof value === "number" && Number.isFinite(value);
+}
+//#endregion
+Object.defineProperty(exports, "isFiniteNumber", {
+	enumerable: true,
+	get: function() {
+		return isFiniteNumber;
+	}
+});

package/dist/chunks/is-finite-number-BpL4F38c.es.js

@@ -0,0 +1,6 @@
+//#region src/helpers/is-finite-number.ts
+function isFiniteNumber(value) {
+	return typeof value === "number" && Number.isFinite(value);
+}
+//#endregion
+export { isFiniteNumber as t };

package/dist/collaboration-upgrade-engine.cjs

@@ -19,7 +19,7 @@ var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = (0, _superdoc_docx_engine_collaboration_upgrade_engine.getCollaborationUpgradeEngineInfo)();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.28.0",
+	superdocVersion: "2.29.0-next.1",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/collaboration-upgrade-engine.es.js

@@ -18,7 +18,7 @@ var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = getCollaborationUpgradeEngineInfo$1();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.28.0",
+	superdocVersion: "2.29.0-next.1",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/document-api/src/capabilities/html-markdown-support.d.ts

@@ -1,6 +1,6 @@
 import { RichContentInsertInput } from '../insert/insert.js';
 import { RichContentReplaceInput, ReplaceMutationOptions } from '../replace/replace.js';
-import { ChangeMode } from '../write/write.js';
+import { ChangeMode, TrackedAttribution } from '../write/write.js';
 import { ProjectHtmlInput, ProjectMarkdownInput, SDContentProjectionResult, SDProjectionReviewMode, SDResolvedProjectionScope } from '../types/content-projection.js';
 import { SDFragment } from '../types/fragment.js';
 import { SDError, SDHtmlMarkdownOutcome, SDMutationConversionReport, SDMutationReceipt } from '../types/sd-contract.js';
@@ -17,11 +17,11 @@ export type SDHtmlMarkdownSupportCheckInput = {
     input: RichContentInsertInput;
     options?: {
         changeMode?: ChangeMode;
-    };
+    } & TrackedAttribution;
 } | {
     operation: 'replace';
     input: RichContentReplaceInput;
-    options?: Pick<ReplaceMutationOptions, 'changeMode' | 'replaceMode' | 'expectedSnapshotId'>;
+    options?: Pick<ReplaceMutationOptions, 'changeMode' | 'replaceMode' | 'expectedSnapshotId'> & TrackedAttribution;
 } | {
     operation: 'projectHtml';
     input?: ProjectHtmlInput;

package/dist/document-api/src/index.d.ts

@@ -109,7 +109,7 @@ export type { GetMarkdownAdapter, GetMarkdownInput } from './get-markdown/get-ma
 export type { GetHtmlAdapter, GetHtmlInput } from './get-html/get-html.js';
 export type { InfoAdapter, InfoInput } from './info/info.js';
 export type { ExtractAdapter, ExtractInput } from './extract/extract.js';
-export type { WriteAdapter, WriteRequest, RichContentMutationOptions, TrackedTextMutationOptions, TextMutationOptions, } from './write/write.js';
+export type { WriteAdapter, WriteRequest, RichContentMutationOptions, TrackedAttribution, TrackedTextMutationOptions, TextMutationOptions, } from './write/write.js';
 export type { OperationCancellation, OperationCancellationCode } from './write/operation-cancellation.js';
 export { OperationCancellationError, assertOperationCanStart, indeterminateOperation, splitOperationCancellation, } from './write/operation-cancellation.js';
 export type { FormatInlineAliasApi, FormatInlineAliasInput, FormatBoldInput, FormatItalicInput, FormatRangeInput, FormatUnderlineInput, FormatStrikethroughInput, StyleApplyInput, StyleApplyOptions, } from './format/format.js';

package/dist/document-api/src/lists/lists.d.ts

@@ -1,100 +1,100 @@
-import { MutationOptions } from '../write/write.js';
+import { TextMutationOptions } from '../write/write.js';
 import { ListInsertInput, ListsGetInput, ListsInsertResult, ListsListQuery, ListsListResult, ListsMutateItemResult, ListTargetInput, ListItemInfo, ListsCreateInput, ListsCreateResult, ListsAttachInput, ListsDetachInput, ListsDetachResult, ListsDeleteInput, ListsDeleteResult, ListsJoinInput, ListsJoinResult, ListsCanJoinInput, ListsCanJoinResult, ListsSeparateInput, ListsSeparateResult, ListsMergeInput, ListsMergeResult, ListsSplitInput, ListsSplitResult, ListsSetLevelInput, ListsSetValueInput, ListsContinuePreviousInput, ListsCanContinuePreviousInput, ListsCanContinuePreviousResult, ListsSetLevelRestartInput, ListsConvertToTextInput, ListsConvertToTextResult, ListsApplyTemplateInput, ListsApplyPresetInput, ListsCaptureTemplateInput, ListsCaptureTemplateResult, ListsSetLevelNumberingInput, ListsSetLevelBulletInput, ListsSetLevelPictureBulletInput, ListsSetLevelAlignmentInput, ListsSetLevelIndentsInput, ListsSetLevelTrailingCharacterInput, ListsSetLevelMarkerFontInput, ListsClearLevelOverridesInput, ListsSetTypeInput, ListsGetStyleInput, ListsGetStyleResult, ListsApplyStyleInput, ListsRestartAtInput, ListsSetLevelNumberStyleInput, ListsSetLevelTextInput, ListsSetLevelStartInput, ListsSetLevelLayoutInput, ListsGetStateInput, ListsGetStateResult, ListsApplyInput, ListsContinueV2Input, ListsRestartV2Input, ListsRemoveV2Input } from './lists.types.js';
 export type { ListInsertInput, ListsGetInput, ListsInsertResult, ListsListQuery, ListsListResult, ListsMutateItemResult, ListTargetInput, ListItemInfo, ListsCreateInput, ListsCreateResult, ListsAttachInput, ListsDetachInput, ListsDetachResult, ListsDeleteInput, ListsDeleteResult, ListsJoinInput, ListsJoinResult, ListsCanJoinInput, ListsCanJoinResult, ListsSeparateInput, ListsSeparateResult, ListsMergeInput, ListsMergeResult, ListsSplitInput, ListsSplitResult, ListsSetLevelInput, ListsSetValueInput, ListsContinuePreviousInput, ListsCanContinuePreviousInput, ListsCanContinuePreviousResult, ListsSetLevelRestartInput, ListsConvertToTextInput, ListsConvertToTextResult, ListsApplyTemplateInput, ListsApplyPresetInput, ListsCaptureTemplateInput, ListsCaptureTemplateResult, ListsSetLevelNumberingInput, ListsSetLevelBulletInput, ListsSetLevelPictureBulletInput, ListsSetLevelAlignmentInput, ListsSetLevelIndentsInput, ListsSetLevelTrailingCharacterInput, ListsSetLevelMarkerFontInput, ListsClearLevelOverridesInput, ListsSetTypeInput, ListsGetStyleInput, ListsGetStyleResult, ListsApplyStyleInput, ListsRestartAtInput, ListsSetLevelNumberStyleInput, ListsSetLevelTextInput, ListsSetLevelStartInput, ListsSetLevelLayoutInput, ListsBlockTarget, ListsGetStateInput, ListsGetStateResult, ListsApplyInput, ListsContinueV2Input, ListsRestartV2Input, ListsRemoveV2Input, } from './lists.types.js';
 export interface ListsAdapter {
     list(query?: ListsListQuery): ListsListResult;
     get(input: ListsGetInput): ListItemInfo;
-    insert(input: ListInsertInput, options?: MutationOptions): ListsInsertResult;
-    indent(input: ListTargetInput, options?: MutationOptions): ListsMutateItemResult;
-    outdent(input: ListTargetInput, options?: MutationOptions): ListsMutateItemResult;
-    create(input: ListsCreateInput, options?: MutationOptions): ListsCreateResult;
-    attach(input: ListsAttachInput, options?: MutationOptions): ListsMutateItemResult;
-    detach(input: ListsDetachInput, options?: MutationOptions): ListsDetachResult;
-    delete(input: ListsDeleteInput, options?: MutationOptions): ListsDeleteResult;
-    join(input: ListsJoinInput, options?: MutationOptions): ListsJoinResult;
+    insert(input: ListInsertInput, options?: TextMutationOptions): ListsInsertResult;
+    indent(input: ListTargetInput, options?: TextMutationOptions): ListsMutateItemResult;
+    outdent(input: ListTargetInput, options?: TextMutationOptions): ListsMutateItemResult;
+    create(input: ListsCreateInput, options?: TextMutationOptions): ListsCreateResult;
+    attach(input: ListsAttachInput, options?: TextMutationOptions): ListsMutateItemResult;
+    detach(input: ListsDetachInput, options?: TextMutationOptions): ListsDetachResult;
+    delete(input: ListsDeleteInput, options?: TextMutationOptions): ListsDeleteResult;
+    join(input: ListsJoinInput, options?: TextMutationOptions): ListsJoinResult;
     canJoin(input: ListsCanJoinInput): ListsCanJoinResult;
-    separate(input: ListsSeparateInput, options?: MutationOptions): ListsSeparateResult;
-    merge(input: ListsMergeInput, options?: MutationOptions): ListsMergeResult;
-    split(input: ListsSplitInput, options?: MutationOptions): ListsSplitResult;
-    setLevel(input: ListsSetLevelInput, options?: MutationOptions): ListsMutateItemResult;
-    setValue(input: ListsSetValueInput, options?: MutationOptions): ListsMutateItemResult;
-    continuePrevious(input: ListsContinuePreviousInput, options?: MutationOptions): ListsMutateItemResult;
+    separate(input: ListsSeparateInput, options?: TextMutationOptions): ListsSeparateResult;
+    merge(input: ListsMergeInput, options?: TextMutationOptions): ListsMergeResult;
+    split(input: ListsSplitInput, options?: TextMutationOptions): ListsSplitResult;
+    setLevel(input: ListsSetLevelInput, options?: TextMutationOptions): ListsMutateItemResult;
+    setValue(input: ListsSetValueInput, options?: TextMutationOptions): ListsMutateItemResult;
+    continuePrevious(input: ListsContinuePreviousInput, options?: TextMutationOptions): ListsMutateItemResult;
     canContinuePrevious(input: ListsCanContinuePreviousInput): ListsCanContinuePreviousResult;
-    setLevelRestart(input: ListsSetLevelRestartInput, options?: MutationOptions): ListsMutateItemResult;
-    convertToText(input: ListsConvertToTextInput, options?: MutationOptions): ListsConvertToTextResult;
-    applyTemplate(input: ListsApplyTemplateInput, options?: MutationOptions): ListsMutateItemResult;
-    applyPreset(input: ListsApplyPresetInput, options?: MutationOptions): ListsMutateItemResult;
+    setLevelRestart(input: ListsSetLevelRestartInput, options?: TextMutationOptions): ListsMutateItemResult;
+    convertToText(input: ListsConvertToTextInput, options?: TextMutationOptions): ListsConvertToTextResult;
+    applyTemplate(input: ListsApplyTemplateInput, options?: TextMutationOptions): ListsMutateItemResult;
+    applyPreset(input: ListsApplyPresetInput, options?: TextMutationOptions): ListsMutateItemResult;
     captureTemplate(input: ListsCaptureTemplateInput): ListsCaptureTemplateResult;
-    setLevelNumbering(input: ListsSetLevelNumberingInput, options?: MutationOptions): ListsMutateItemResult;
-    setLevelBullet(input: ListsSetLevelBulletInput, options?: MutationOptions): ListsMutateItemResult;
-    setLevelPictureBullet(input: ListsSetLevelPictureBulletInput, options?: MutationOptions): ListsMutateItemResult;
-    setLevelAlignment(input: ListsSetLevelAlignmentInput, options?: MutationOptions): ListsMutateItemResult;
-    setLevelIndents(input: ListsSetLevelIndentsInput, options?: MutationOptions): ListsMutateItemResult;
-    setLevelTrailingCharacter(input: ListsSetLevelTrailingCharacterInput, options?: MutationOptions): ListsMutateItemResult;
-    setLevelMarkerFont(input: ListsSetLevelMarkerFontInput, options?: MutationOptions): ListsMutateItemResult;
-    clearLevelOverrides(input: ListsClearLevelOverridesInput, options?: MutationOptions): ListsMutateItemResult;
-    setType(input: ListsSetTypeInput, options?: MutationOptions): ListsMutateItemResult;
+    setLevelNumbering(input: ListsSetLevelNumberingInput, options?: TextMutationOptions): ListsMutateItemResult;
+    setLevelBullet(input: ListsSetLevelBulletInput, options?: TextMutationOptions): ListsMutateItemResult;
+    setLevelPictureBullet(input: ListsSetLevelPictureBulletInput, options?: TextMutationOptions): ListsMutateItemResult;
+    setLevelAlignment(input: ListsSetLevelAlignmentInput, options?: TextMutationOptions): ListsMutateItemResult;
+    setLevelIndents(input: ListsSetLevelIndentsInput, options?: TextMutationOptions): ListsMutateItemResult;
+    setLevelTrailingCharacter(input: ListsSetLevelTrailingCharacterInput, options?: TextMutationOptions): ListsMutateItemResult;
+    setLevelMarkerFont(input: ListsSetLevelMarkerFontInput, options?: TextMutationOptions): ListsMutateItemResult;
+    clearLevelOverrides(input: ListsClearLevelOverridesInput, options?: TextMutationOptions): ListsMutateItemResult;
+    setType(input: ListsSetTypeInput, options?: TextMutationOptions): ListsMutateItemResult;
     getStyle(input: ListsGetStyleInput): ListsGetStyleResult;
-    applyStyle(input: ListsApplyStyleInput, options?: MutationOptions): ListsMutateItemResult;
-    restartAt(input: ListsRestartAtInput, options?: MutationOptions): ListsMutateItemResult;
-    setLevelNumberStyle(input: ListsSetLevelNumberStyleInput, options?: MutationOptions): ListsMutateItemResult;
-    setLevelText(input: ListsSetLevelTextInput, options?: MutationOptions): ListsMutateItemResult;
-    setLevelStart(input: ListsSetLevelStartInput, options?: MutationOptions): ListsMutateItemResult;
-    setLevelLayout(input: ListsSetLevelLayoutInput, options?: MutationOptions): ListsMutateItemResult;
+    applyStyle(input: ListsApplyStyleInput, options?: TextMutationOptions): ListsMutateItemResult;
+    restartAt(input: ListsRestartAtInput, options?: TextMutationOptions): ListsMutateItemResult;
+    setLevelNumberStyle(input: ListsSetLevelNumberStyleInput, options?: TextMutationOptions): ListsMutateItemResult;
+    setLevelText(input: ListsSetLevelTextInput, options?: TextMutationOptions): ListsMutateItemResult;
+    setLevelStart(input: ListsSetLevelStartInput, options?: TextMutationOptions): ListsMutateItemResult;
+    setLevelLayout(input: ListsSetLevelLayoutInput, options?: TextMutationOptions): ListsMutateItemResult;
     getState?(input: ListsGetStateInput): ListsGetStateResult;
-    apply?(input: ListsApplyInput, options?: MutationOptions): ListsMutateItemResult;
-    continue?(input: ListsContinueV2Input, options?: MutationOptions): ListsMutateItemResult;
-    restart?(input: ListsRestartV2Input, options?: MutationOptions): ListsMutateItemResult;
-    remove?(input: ListsRemoveV2Input, options?: MutationOptions): ListsMutateItemResult;
+    apply?(input: ListsApplyInput, options?: TextMutationOptions): ListsMutateItemResult;
+    continue?(input: ListsContinueV2Input, options?: TextMutationOptions): ListsMutateItemResult;
+    restart?(input: ListsRestartV2Input, options?: TextMutationOptions): ListsMutateItemResult;
+    remove?(input: ListsRemoveV2Input, options?: TextMutationOptions): ListsMutateItemResult;
 }
 export interface ListsApi extends ListsAdapter {
     getState(input: ListsGetStateInput): ListsGetStateResult;
-    apply(input: ListsApplyInput, options?: MutationOptions): ListsMutateItemResult;
-    continue(input: ListsContinueV2Input, options?: MutationOptions): ListsMutateItemResult;
-    restart(input: ListsRestartV2Input, options?: MutationOptions): ListsMutateItemResult;
-    remove(input: ListsRemoveV2Input, options?: MutationOptions): ListsMutateItemResult;
+    apply(input: ListsApplyInput, options?: TextMutationOptions): ListsMutateItemResult;
+    continue(input: ListsContinueV2Input, options?: TextMutationOptions): ListsMutateItemResult;
+    restart(input: ListsRestartV2Input, options?: TextMutationOptions): ListsMutateItemResult;
+    remove(input: ListsRemoveV2Input, options?: TextMutationOptions): ListsMutateItemResult;
 }
 export declare function executeListsList(adapter: ListsAdapter, query?: ListsListQuery): ListsListResult;
 export declare function executeListsGet(adapter: ListsAdapter, input: ListsGetInput): ListItemInfo;
-export declare function executeListsInsert(adapter: ListsAdapter, input: ListInsertInput, options?: MutationOptions): ListsInsertResult;
-export declare function executeListsIndent(adapter: ListsAdapter, input: ListTargetInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsOutdent(adapter: ListsAdapter, input: ListTargetInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsCreate(adapter: ListsAdapter, input: ListsCreateInput, options?: MutationOptions): ListsCreateResult;
-export declare function executeListsAttach(adapter: ListsAdapter, input: ListsAttachInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsDetach(adapter: ListsAdapter, input: ListsDetachInput, options?: MutationOptions): ListsDetachResult;
-export declare function executeListsDelete(adapter: ListsAdapter, input: ListsDeleteInput, options?: MutationOptions): ListsDeleteResult;
-export declare function executeListsJoin(adapter: ListsAdapter, input: ListsJoinInput, options?: MutationOptions): ListsJoinResult;
+export declare function executeListsInsert(adapter: ListsAdapter, input: ListInsertInput, options?: TextMutationOptions): ListsInsertResult;
+export declare function executeListsIndent(adapter: ListsAdapter, input: ListTargetInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsOutdent(adapter: ListsAdapter, input: ListTargetInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsCreate(adapter: ListsAdapter, input: ListsCreateInput, options?: TextMutationOptions): ListsCreateResult;
+export declare function executeListsAttach(adapter: ListsAdapter, input: ListsAttachInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsDetach(adapter: ListsAdapter, input: ListsDetachInput, options?: TextMutationOptions): ListsDetachResult;
+export declare function executeListsDelete(adapter: ListsAdapter, input: ListsDeleteInput, options?: TextMutationOptions): ListsDeleteResult;
+export declare function executeListsJoin(adapter: ListsAdapter, input: ListsJoinInput, options?: TextMutationOptions): ListsJoinResult;
 export declare function executeListsCanJoin(adapter: ListsAdapter, input: ListsCanJoinInput): ListsCanJoinResult;
-export declare function executeListsSeparate(adapter: ListsAdapter, input: ListsSeparateInput, options?: MutationOptions): ListsSeparateResult;
-export declare function executeListsMerge(adapter: ListsAdapter, input: ListsMergeInput, options?: MutationOptions): ListsMergeResult;
-export declare function executeListsSplit(adapter: ListsAdapter, input: ListsSplitInput, options?: MutationOptions): ListsSplitResult;
-export declare function executeListsSetLevel(adapter: ListsAdapter, input: ListsSetLevelInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsSetValue(adapter: ListsAdapter, input: ListsSetValueInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsContinuePrevious(adapter: ListsAdapter, input: ListsContinuePreviousInput, options?: MutationOptions): ListsMutateItemResult;
+export declare function executeListsSeparate(adapter: ListsAdapter, input: ListsSeparateInput, options?: TextMutationOptions): ListsSeparateResult;
+export declare function executeListsMerge(adapter: ListsAdapter, input: ListsMergeInput, options?: TextMutationOptions): ListsMergeResult;
+export declare function executeListsSplit(adapter: ListsAdapter, input: ListsSplitInput, options?: TextMutationOptions): ListsSplitResult;
+export declare function executeListsSetLevel(adapter: ListsAdapter, input: ListsSetLevelInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsSetValue(adapter: ListsAdapter, input: ListsSetValueInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsContinuePrevious(adapter: ListsAdapter, input: ListsContinuePreviousInput, options?: TextMutationOptions): ListsMutateItemResult;
 export declare function executeListsCanContinuePrevious(adapter: ListsAdapter, input: ListsCanContinuePreviousInput): ListsCanContinuePreviousResult;
-export declare function executeListsSetLevelRestart(adapter: ListsAdapter, input: ListsSetLevelRestartInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsConvertToText(adapter: ListsAdapter, input: ListsConvertToTextInput, options?: MutationOptions): ListsConvertToTextResult;
-export declare function executeListsApplyTemplate(adapter: ListsAdapter, input: ListsApplyTemplateInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsApplyPreset(adapter: ListsAdapter, input: ListsApplyPresetInput, options?: MutationOptions): ListsMutateItemResult;
+export declare function executeListsSetLevelRestart(adapter: ListsAdapter, input: ListsSetLevelRestartInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsConvertToText(adapter: ListsAdapter, input: ListsConvertToTextInput, options?: TextMutationOptions): ListsConvertToTextResult;
+export declare function executeListsApplyTemplate(adapter: ListsAdapter, input: ListsApplyTemplateInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsApplyPreset(adapter: ListsAdapter, input: ListsApplyPresetInput, options?: TextMutationOptions): ListsMutateItemResult;
 export declare function executeListsCaptureTemplate(adapter: ListsAdapter, input: ListsCaptureTemplateInput): ListsCaptureTemplateResult;
-export declare function executeListsSetLevelNumbering(adapter: ListsAdapter, input: ListsSetLevelNumberingInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsSetLevelBullet(adapter: ListsAdapter, input: ListsSetLevelBulletInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsSetLevelPictureBullet(adapter: ListsAdapter, input: ListsSetLevelPictureBulletInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsSetLevelAlignment(adapter: ListsAdapter, input: ListsSetLevelAlignmentInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsSetLevelIndents(adapter: ListsAdapter, input: ListsSetLevelIndentsInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsSetLevelTrailingCharacter(adapter: ListsAdapter, input: ListsSetLevelTrailingCharacterInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsSetLevelMarkerFont(adapter: ListsAdapter, input: ListsSetLevelMarkerFontInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsClearLevelOverrides(adapter: ListsAdapter, input: ListsClearLevelOverridesInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsSetType(adapter: ListsAdapter, input: ListsSetTypeInput, options?: MutationOptions): ListsMutateItemResult;
+export declare function executeListsSetLevelNumbering(adapter: ListsAdapter, input: ListsSetLevelNumberingInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsSetLevelBullet(adapter: ListsAdapter, input: ListsSetLevelBulletInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsSetLevelPictureBullet(adapter: ListsAdapter, input: ListsSetLevelPictureBulletInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsSetLevelAlignment(adapter: ListsAdapter, input: ListsSetLevelAlignmentInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsSetLevelIndents(adapter: ListsAdapter, input: ListsSetLevelIndentsInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsSetLevelTrailingCharacter(adapter: ListsAdapter, input: ListsSetLevelTrailingCharacterInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsSetLevelMarkerFont(adapter: ListsAdapter, input: ListsSetLevelMarkerFontInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsClearLevelOverrides(adapter: ListsAdapter, input: ListsClearLevelOverridesInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsSetType(adapter: ListsAdapter, input: ListsSetTypeInput, options?: TextMutationOptions): ListsMutateItemResult;
 export declare function executeListsGetStyle(adapter: ListsAdapter, input: ListsGetStyleInput): ListsGetStyleResult;
-export declare function executeListsApplyStyle(adapter: ListsAdapter, input: ListsApplyStyleInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsRestartAt(adapter: ListsAdapter, input: ListsRestartAtInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsSetLevelNumberStyle(adapter: ListsAdapter, input: ListsSetLevelNumberStyleInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsSetLevelText(adapter: ListsAdapter, input: ListsSetLevelTextInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsSetLevelStart(adapter: ListsAdapter, input: ListsSetLevelStartInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsSetLevelLayout(adapter: ListsAdapter, input: ListsSetLevelLayoutInput, options?: MutationOptions): ListsMutateItemResult;
+export declare function executeListsApplyStyle(adapter: ListsAdapter, input: ListsApplyStyleInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsRestartAt(adapter: ListsAdapter, input: ListsRestartAtInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsSetLevelNumberStyle(adapter: ListsAdapter, input: ListsSetLevelNumberStyleInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsSetLevelText(adapter: ListsAdapter, input: ListsSetLevelTextInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsSetLevelStart(adapter: ListsAdapter, input: ListsSetLevelStartInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsSetLevelLayout(adapter: ListsAdapter, input: ListsSetLevelLayoutInput, options?: TextMutationOptions): ListsMutateItemResult;
 export declare function executeListsGetState(adapter: ListsAdapter, input: ListsGetStateInput): ListsGetStateResult;
-export declare function executeListsApply(adapter: ListsAdapter, input: ListsApplyInput, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsContinueV2(adapter: ListsAdapter, input: ListsContinueV2Input, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsRestartV2(adapter: ListsAdapter, input: ListsRestartV2Input, options?: MutationOptions): ListsMutateItemResult;
-export declare function executeListsRemoveV2(adapter: ListsAdapter, input: ListsRemoveV2Input, options?: MutationOptions): ListsMutateItemResult;
+export declare function executeListsApply(adapter: ListsAdapter, input: ListsApplyInput, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsContinueV2(adapter: ListsAdapter, input: ListsContinueV2Input, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsRestartV2(adapter: ListsAdapter, input: ListsRestartV2Input, options?: TextMutationOptions): ListsMutateItemResult;
+export declare function executeListsRemoveV2(adapter: ListsAdapter, input: ListsRemoveV2Input, options?: TextMutationOptions): ListsMutateItemResult;

package/dist/document-api/src/write/write.d.ts

@@ -42,23 +42,24 @@ export interface MutationOptions extends RevisionGuardOptions {
      */
     dryRun?: boolean;
 }
-export interface RichContentMutationOptions extends MutationOptions {
-    author?: never;
-    date?: never;
-    /** Guard returned by `doc.capabilities.check` for an exact rich write. */
-    supportCheck?: SDHtmlMarkdownCheckGuard;
-}
-/** Display-only attribution for one tracked plain-text or inline-format mutation. */
-export interface TrackedTextMutationOptions extends MutationOptions {
-    changeMode: 'tracked';
+/** Display-only attribution for one tracked mutation. */
+export interface TrackedAttribution {
     author?: {
         name: string;
     };
     /** ISO 8601 UTC revision timestamp. Omitted values use the transaction time. */
     date?: string;
 }
+export interface RichContentMutationOptions extends MutationOptions, TrackedAttribution {
+    /** Guard returned by `doc.capabilities.check` for an exact rich write. */
+    supportCheck?: SDHtmlMarkdownCheckGuard;
+}
+export interface TrackedTextMutationOptions extends MutationOptions, TrackedAttribution {
+    changeMode: 'tracked';
+}
 export type TextMutationOptions = MutationOptions | TrackedTextMutationOptions;
 export declare function normalizeTextMutationOptions(options?: RichContentMutationOptions | TextMutationOptions): RichContentMutationOptions | TrackedTextMutationOptions;
+export declare function normalizeRichMutationOptions(options: (MutationOptions & TrackedAttribution & Partial<RichContentMutationOptions>) | undefined, supportCheckOperation?: 'insert' | 'replace'): RichContentMutationOptions;
 /**
  * Text insertion request: target-less insert at document end.
  *

package/dist/layout-engine/painters/dom/src/page-content.d.ts

@@ -5,7 +5,7 @@ import { BetweenBorderInfo } from './paragraph/borders/index.js';
 import { PageStyles } from './styles.js';
 import { TableFragmentPatchResult } from './table/renderTableFragment.js';
 import { DerivedRunTextPlane } from './derived-run-text-plane.js';
-export declare function refreshPageBreakReviewPlacements(state: PageDomState, page: ResolvedPage, recordChangedRoot?: (root: HTMLElement) => void): void;
+export declare function refreshPageBreakReviewPlacements(state: PageDomState, page: ResolvedPage, recordChangedRoot?: (root: HTMLElement) => void, beforePlacementChange?: () => void): void;
 export type FragmentDomState = {
     key: string;
     signature: string;

package/dist/layout-engine/painters/dom/src/persistent-page-surface.d.ts

@@ -72,6 +72,8 @@ export type DomPainterPersistentPageInput = {
     documentBackground?: DocumentBackground | null;
     derivedRunTextPlane?: DerivedRunTextPlane | null;
     captureSnapshot?: boolean;
+    beforePageContentChange?: (pageIndex: number) => void;
+    onPageContentRetained?: (pageIndex: number) => void;
 };
 /** Shell registry entry: the persistent page root and its geometry/style reuse key. */
 export type PersistentShellEntry = {