superdoc 2.28.0-next.9 → 2.29.0-next.1

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

@@ -1,4 +1,5 @@
-import { D as normalizeClass, E as nextTick, F as openBlock, J as unref, N as onMounted, R as ref, U as shallowRef, W as toDisplayString, a as computed, c as createCommentVNode, et as watch, f as createTextVNode, h as defineComponent, it as withModifiers, j as onBeforeUnmount, l as createElementBlock, n as Fragment, t as _plugin_vue_export_helper_default, u as createElementVNode, z as renderList } from "./_plugin-vue_export-helper-7ZiLY07t.es.js";
+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",
@@ -1087,6 +1088,172 @@ function isSyntheticTrackedChangeCommentLaneItem(item) {
 	return typeof itemId === "string" && itemId.startsWith(TRACKED_CHANGE_COMMENT_LANE_ID_PREFIX);
 }
 //#endregion
+//#region src/helpers/object-guards.js
+/**
+* @param {unknown} value
+* @returns {value is Record<string, unknown>}
+*/
+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) {
@@ -2486,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;
 	}
@@ -2640,16 +2807,17 @@ function selectionKey(selection) {
 	}
 }
 //#endregion
-//#region src/helpers/object-guards.js
-/**
-* @param {unknown} value
-* @returns {value is Record<string, unknown>}
-*/
-function isPlainObject(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-//#endregion
 //#region src/helpers/v2-review-mutation-impact.ts
+function mutationCommittedEventChangedVisibleContent(event) {
+	if (event.dryRun === true) return false;
+	if (isPlainObject(event.result) && event.result.noop === true) return false;
+	const receipt = isPlainObject(event.receipt) ? event.receipt : null;
+	if (receipt?.changed === false || receipt?.noop === true || receipt?.status === "NO_OP") return false;
+	return true;
+}
+function mutationCommittedEventChangedDocument(event) {
+	return event.cause !== "preview" && mutationCommittedEventChangedVisibleContent(event);
+}
 /**
 * Classify the tracked-change identities carried by a v2 mutation event.
 *
@@ -2977,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;
 }
 /**
@@ -5347,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;
@@ -5653,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);
@@ -5762,17 +5927,42 @@ function commandResultFromOperationResult(result) {
 function isSuccessfulReceipt(result) {
 	return Boolean(result) && typeof result === "object" && result.success === true;
 }
-/**
-* The host also emits `mutation:committed` for previews and no-op receipts;
-* those events must not mark the document as having unsaved edits.
-*/
-function mutationCommittedEventChangedDocument(event) {
-	if (event.dryRun === true) return false;
-	const receipt = event.receipt;
-	if (receipt && typeof receipt === "object" && receipt.changed === false) return false;
-	if (receipt && typeof receipt === "object" && receipt.noop === true) return false;
-	if (receipt && typeof receipt === "object" && receipt.status === "NO_OP") return false;
-	return true;
+function readTxId(value) {
+	return typeof value === "string" && value.length > 0 ? value : null;
+}
+function documentChangeScope(stories) {
+	return Array.isArray(stories) && stories.length > 0 ? {
+		kind: "known",
+		stories
+	} : { kind: "unknown" };
+}
+function documentChangeFromHostEvent(event) {
+	if (event.type === "collaboration:remote-changed") return {
+		cause: "remote",
+		changeTag: null,
+		txId: null,
+		scope: { kind: "unknown" }
+	};
+	if (event.type !== "mutation:committed") return null;
+	if (event.origin === "history") {
+		const result = isPlainObject(event.result) ? event.result : null;
+		if (!result || result.noop === true) return null;
+		const history = isPlainObject(result.history) ? result.history : null;
+		return {
+			cause: event.direction === "redo" ? "redo" : "undo",
+			changeTag: null,
+			txId: readTxId(history?.txId),
+			scope: documentChangeScope(result.affectedStories)
+		};
+	}
+	if (!mutationCommittedEventChangedDocument(event)) return null;
+	const receipt = isPlainObject(event.receipt) ? event.receipt : {};
+	return {
+		cause: event.cause === "user" ? "user" : "api",
+		changeTag: typeof receipt.changeTag === "string" ? receipt.changeTag : null,
+		txId: readTxId(receipt.txId),
+		scope: documentChangeScope(receipt.affectedStories)
+	};
 }
 function commandResultSucceeded(result) {
 	if (result === false) return false;
@@ -6366,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) => {
@@ -6681,9 +6871,19 @@ function createSuperDocUI(options) {
 		if (seeded > 0) dirtyHosts.add(host);
 		else if (revision === 0) dirtyHosts.delete(host);
 	};
-	const hasLocalDocumentMutation = () => {
+	const savedPoint = () => {
 		const host = getHost();
+		return {
+			host,
+			isDirty: hostMethod(host, "isDirty"),
+			getDocumentVersion: hostMethod(host, "getDocumentVersion"),
+			markSaved: hostMethod(host, "markSaved")
+		};
+	};
+	const hasLocalDocumentMutation = () => {
+		const { host, isDirty } = savedPoint();
 		if (!host) return false;
+		if (isDirty) return Boolean(safeCall(() => isDirty(), false));
 		seedLocalDocumentMutation(host);
 		return dirtyHosts.has(host);
 	};
@@ -8094,6 +8294,33 @@ function createSuperDocUI(options) {
 			sizeOptions: DEFAULT_FONT_SIZE_OPTIONS
 		};
 	};
+	const EMPTY_HISTORY = {
+		canUndo: false,
+		canRedo: false,
+		undoDepth: 0,
+		redoDepth: 0
+	};
+	let historySlice = EMPTY_HISTORY;
+	let historySource = null;
+	const computeHistory = () => {
+		const source = getEditCommands();
+		if (source !== historySource) {
+			historySource = source;
+			historySlice = EMPTY_HISTORY;
+		}
+		const getSnapshot = hostMethod(source, "getSnapshot");
+		const snapshot = getSnapshot ? safeCall(() => getSnapshot(), null) : null;
+		const { undoDepth, redoDepth } = (isPlainObject(snapshot) && isPlainObject(snapshot.history) ? snapshot.history : null) ?? {};
+		if (typeof undoDepth !== "number" || typeof redoDepth !== "number") return historySlice;
+		const next = {
+			canUndo: undoDepth > 0,
+			canRedo: redoDepth > 0,
+			undoDepth,
+			redoDepth
+		};
+		if (!shallowEqual(next, historySlice)) historySlice = next;
+		return historySlice;
+	};
 	let zoomFitWidth;
 	const computeZoom = () => {
 		const getZoomState = hostMethod(superdoc, "getZoomState");
@@ -8727,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 {
@@ -9622,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;
@@ -9906,6 +10134,7 @@ function createSuperDocUI(options) {
 			trackChanges: measure("trackChanges", () => computeTrackChanges(selection)),
 			contentControls: measure("contentControls", () => computeContentControls(selection)),
 			zoom: measure("zoom", computeZoom),
+			history: measure("history", computeHistory),
 			fonts: measure("fonts", computeFonts),
 			styles: measure("styles", () => computeStyles(selection))
 		};
@@ -10009,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 = () => {
@@ -10195,6 +10424,41 @@ function createSuperDocUI(options) {
 	state = computeState("initial");
 	lastOptimisticInlineSelectionSignature = selectionInlineValueSignature(state.selection);
 	let scheduleActiveSearchRefresh = () => {};
+	const documentChangeListeners = /* @__PURE__ */ new Set();
+	const documentChangeCounters = /* @__PURE__ */ new WeakMap();
+	let documentEpochCount = 0;
+	const readDocumentReplacement = (host) => safeCall(() => hostMethod(host, "getDocumentReplacementVersion")?.(), null);
+	const startDocumentChangeEpoch = (host) => {
+		documentEpochCount += 1;
+		const counter = {
+			epoch: `document-${documentEpochCount}`,
+			seq: 0,
+			replacement: readDocumentReplacement(host)
+		};
+		documentChangeCounters.set(host, counter);
+		return counter;
+	};
+	const currentDocumentChangeCounter = (host) => {
+		const counter = documentChangeCounters.get(host);
+		return counter && counter.replacement === readDocumentReplacement(host) ? counter : startDocumentChangeEpoch(host);
+	};
+	const publishDocumentChange = (host, event) => {
+		if (event.type === "collaboration:document-replaced" || event.documentReplaced === true) {
+			startDocumentChangeEpoch(host);
+			return;
+		}
+		if (documentChangeListeners.size === 0) return;
+		const facts = documentChangeFromHostEvent(event);
+		if (!facts) return;
+		const counter = currentDocumentChangeCounter(host);
+		counter.seq += 1;
+		const change = {
+			documentEpoch: counter.epoch,
+			seq: counter.seq,
+			...facts
+		};
+		for (const listener of Array.from(documentChangeListeners)) safeCall(() => listener(change), void 0);
+	};
 	const syncHostEventsSubscription = () => {
 		const host = getEditor()?.host;
 		const events = host?.events;
@@ -10213,15 +10477,19 @@ function createSuperDocUI(options) {
 		try {
 			const off = hostMethod(next, "subscribe")?.((event) => {
 				const type = event?.type;
+				if (host) publishDocumentChange(host, event);
 				const isStandaloneDocumentMutation = type === "document:mutated" && event.hasCommitEvent !== true;
-				if (type === "collaboration:document-replaced" || isStandaloneDocumentMutation || type === "mutation:committed" && mutationCommittedEventChangedDocument(event) || type === "collaboration:remote-changed") {
+				if (type === "collaboration:document-replaced" || isStandaloneDocumentMutation || type === "mutation:committed" && mutationCommittedEventChangedVisibleContent(event) || type === "collaboration:remote-changed") {
 					for (const [commandId, optimistic] of optimisticInlineToggles) if (optimistic.settled || type === "collaboration:document-replaced") optimisticInlineToggles.delete(commandId);
 				}
-				if (isStandaloneDocumentMutation || type === "mutation:committed" && mutationCommittedEventChangedDocument(event) || type === "collaboration:remote-changed" && Array.isArray(event.changedStoryIds) && event.changedStoryIds.length > 0) scheduleActiveSearchRefresh();
-				if ((type === "document:mutated" || type === "mutation:committed" && mutationCommittedEventChangedDocument(event)) && host && !dirtyHosts.has(host)) {
+				if (isStandaloneDocumentMutation || type === "mutation:committed" && mutationCommittedEventChangedVisibleContent(event) || type === "collaboration:remote-changed" && Array.isArray(event.changedStoryIds) && event.changedStoryIds.length > 0) scheduleActiveSearchRefresh();
+				const documentEdited = type === "document:mutated" || type === "mutation:committed" && mutationCommittedEventChangedDocument(event);
+				if (documentEdited && host && hostMethod(host, "isDirty")) recompute("document-dirty");
+				else if (documentEdited && host && !dirtyHosts.has(host)) {
 					dirtyHosts.add(host);
 					recompute("document-dirty");
 				}
+				if (type === "document:saved-point-changed") recompute("document-dirty");
 				if (type === "collaboration:document-replaced" && host) {
 					dirtyHosts.delete(host);
 					hostSeededMutationRevision.delete(host);
@@ -10253,6 +10521,7 @@ function createSuperDocUI(options) {
 					if (impact?.allResolved) {
 						replaceTrackedChangeItemsInCache([]);
 						publishAllTrackedChangesResolved(event.receipt);
+						if (event.cause === "preview") invalidateDocumentContent();
 						return;
 					}
 					if (impact?.removedIds.size) markPostDecisionTrackChanges(new Set(impact.removedIds), event.receipt);
@@ -10262,7 +10531,10 @@ function createSuperDocUI(options) {
 						scheduleTypingDocumentContentInvalidation();
 						return;
 					}
-					if (impact?.removedIds.size && impact.upsertIds.size === 0) return;
+					if (impact?.removedIds.size && impact.upsertIds.size === 0) {
+						if (event.cause === "preview") invalidateDocumentContent();
+						return;
+					}
 					if (isStandaloneDocumentMutation || type === "collaboration:remote-changed" || type === "mutation:committed" && !isTypingBurst) schedulePostPaintContentRefresh();
 					const remoteCommentsPartChanged = type === "collaboration:remote-changed" && Array.isArray(event.changedPartUris) && event.changedPartUris.some((partUri) => typeof partUri === "string" && COMMENTS_CATALOG_PART_URIS.has(partUri));
 					const loadedCommentAnchorsMayHaveChanged = type === "collaboration:remote-changed" && Array.isArray(event.changedStoryIds) && event.changedStoryIds.length > 0 && commentsCatalogMayHaveRows();
@@ -12171,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;
@@ -12353,7 +12635,11 @@ function createSuperDocUI(options) {
 				const node = (await readBlockNode(paragraphTarget(segment.blockId, targetStory)))?.node;
 				const para = node ? getParagraphLikeData(node) : null;
 				const runs = Array.isArray(para?.inlines) ? para.inlines : [];
-				for (const props of sliceRunProps(runs, segment.range)) for (const key of Object.keys(sdRunPropsToInlineRunPatch(props))) if (!(key in inline) && !snap.mixedInlineKeys.includes(key)) inline[key] = FORMAT_PAINTER_BOOLEAN_KEYS.has(key) ? false : null;
+				for (const props of sliceRunProps(runs, segment.range)) for (const key of Object.keys(sdRunPropsToInlineRunPatch(props))) {
+					const fontAlias = key === "rFonts" ? "fontFamily" : key === "fontFamily" ? "rFonts" : null;
+					const capturedFontAlias = fontAlias && (fontAlias in inline || snap.mixedInlineKeys.includes(fontAlias));
+					if (!(key in inline) && !snap.mixedInlineKeys.includes(key) && !capturedFontAlias) inline[key] = FORMAT_PAINTER_BOOLEAN_KEYS.has(key) ? false : null;
+				}
 			}
 			if (disposed || painter.snapshot !== snap || getEditor() !== ownerEditor || ownerEditor?.doc !== ownerDoc || readDocumentMode() !== ownerMode) return;
 		}
@@ -13694,6 +13980,7 @@ function createSuperDocUI(options) {
 		getFamilyOptions: () => state.fonts.options,
 		getSizeOptions: () => state.fonts.sizeOptions
 	};
+	const history = snapshotHandle(sliceHandle((s) => s.history));
 	const zoomSnap = snapshotHandle(sliceHandle((s) => s.zoom));
 	const zoom = {
 		get: zoomSnap.get,
@@ -13754,6 +14041,28 @@ function createSuperDocUI(options) {
 			} catch {
 				return;
 			}
+		},
+		onChange: (listener) => {
+			if (disposed) return () => {};
+			documentChangeListeners.add(listener);
+			return () => documentChangeListeners.delete(listener);
+		},
+		getVersion: () => {
+			const { getDocumentVersion } = savedPoint();
+			const version = getDocumentVersion ? safeCall(() => getDocumentVersion(), null) : null;
+			return typeof version === "string" ? version : null;
+		},
+		markClean: (version) => {
+			const { markSaved } = savedPoint();
+			if (!markSaved) return {
+				ok: false,
+				reason: "unavailable"
+			};
+			const result = safeCall(() => markSaved(version), null);
+			return isPlainObject(result) && result.ok === true ? { ok: true } : {
+				ok: false,
+				reason: isPlainObject(result) && result.reason === "document-changed" ? "document-changed" : "unavailable"
+			};
 		}
 	};
 	const resolveVisibleHost = () => {
@@ -13765,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();
@@ -14543,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 {
@@ -15236,6 +15545,11 @@ function createSuperDocUI(options) {
 		const scopeUnsubs = [];
 		return {
 			decorations: createDecorationsHandle((handle) => scopeUnsubs.push(() => handle.dispose())),
+			document: { onChange: (listener) => {
+				const unsub = documentHandle.onChange(listener);
+				scopeUnsubs.push(unsub);
+				return unsub;
+			} },
 			select: (selector, equality) => {
 				const sub = select(selector, equality);
 				return {
@@ -15322,6 +15636,7 @@ function createSuperDocUI(options) {
 		painterCaptureEpoch += 1;
 		painterCommandDoc = null;
 		painterModeListeners.clear();
+		documentChangeListeners.clear();
 		searchRequestGeneration += 1;
 		customCommands.clear();
 	};
@@ -15339,6 +15654,7 @@ function createSuperDocUI(options) {
 		bookmarks,
 		fonts,
 		zoom,
+		history,
 		document: documentHandle,
 		viewport,
 		decorations,
@@ -15560,4 +15876,4 @@ function commandIsActive(descriptor, selection) {
 	return descriptor.activeMark ? selection.activeMarks.includes(descriptor.activeMark) : false;
 }
 //#endregion
-export { createInteractionHistory as _, registerFirstPartyCommandMutation as a, recordInteraction as b, applyV2CommentInvalidationFromMutation as c, createImageFilePicker as d, resolveImageSrc as f, closeInteractionHistory as g, DOM_CLASS_NAMES as h, readFirstPartyPageNumbers as i, getV2TrackedChangeMutationImpact as l, isSyntheticTrackedChangeCommentLaneItem as m, executeFirstPartyCommandAsync as n, isRecord as o, shallowEqual as p, executeFirstPartyShortcutAsync as r, BUILT_IN_COMMAND_IDS as s, createSuperDocUI as t, isPlainObject as u, getWorkflowRecording as v, isWorkflowRecordingEnabled 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-next.9",
+	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-next.9",
+	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;