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

package/dist/chunks/{create-super-doc-ui-B4c55pFy.cjs → create-super-doc-ui-0OA8hCNb.cjs}

@@ -1,4 +1,5 @@
-const require__plugin_vue_export_helper = require("./_plugin-vue_export-helper-BUdjGKyl.cjs");
+const require__plugin_vue_export_helper = require("./_plugin-vue_export-helper-6MBoygIY.cjs");
+const require_is_finite_number = require("./is-finite-number-BEXgTRgc.cjs");
 //#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) {
@@ -2487,7 +2654,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 require_is_finite_number.isFiniteNumber(value) ? Math.round(value * 2) : null;
 		case "rFonts": return fontsValue(value);
 		default: return null;
 	}
@@ -2641,16 +2808,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.
 *
@@ -2978,7 +3146,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 (require_is_finite_number.isFiniteNumber(payload)) return normalizeNumber(payload, false);
 	return payload;
 }
 /**
@@ -5348,9 +5516,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;
@@ -5361,10 +5526,10 @@ function readParagraphIndentationFromResult(result) {
 	const props = paragraphPayload.props;
 	const indent = resolved?.indent ?? props?.indent;
 	if (!indent || typeof indent !== "object") return null;
-	const left = isFiniteNumber(indent.left) ? pointsToTwips(indent.left) : isFiniteNumber(indent.start) ? pointsToTwips(indent.start) : void 0;
-	const right = isFiniteNumber(indent.right) ? pointsToTwips(indent.right) : isFiniteNumber(indent.end) ? pointsToTwips(indent.end) : void 0;
-	const firstLine = isFiniteNumber(indent.firstLine) ? pointsToTwips(indent.firstLine) : void 0;
-	const hanging = isFiniteNumber(indent.hanging) ? pointsToTwips(indent.hanging) : void 0;
+	const left = require_is_finite_number.isFiniteNumber(indent.left) ? pointsToTwips(indent.left) : require_is_finite_number.isFiniteNumber(indent.start) ? pointsToTwips(indent.start) : void 0;
+	const right = require_is_finite_number.isFiniteNumber(indent.right) ? pointsToTwips(indent.right) : require_is_finite_number.isFiniteNumber(indent.end) ? pointsToTwips(indent.end) : void 0;
+	const firstLine = require_is_finite_number.isFiniteNumber(indent.firstLine) ? pointsToTwips(indent.firstLine) : void 0;
+	const hanging = require_is_finite_number.isFiniteNumber(indent.hanging) ? pointsToTwips(indent.hanging) : void 0;
 	if (left == null && right == null && firstLine == null && hanging == null) return null;
 	return {
 		...left != null ? { left } : {},
@@ -5654,7 +5819,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 (!require_is_finite_number.isFiniteNumber(value) || value <= 0) return void 0;
 	const pt = Math.round(value * .75 * 2) / 2;
 	if (pt <= 0) return void 0;
 	return String(pt);
@@ -5763,17 +5928,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;
@@ -6367,7 +6557,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 (require_is_finite_number.isFiniteNumber(value)) return String(value);
 	};
 	/** Record / clear the stored inline mark for a collapsed-caret pick (SD-3654/SD-3652). */
 	const setPendingInlineFormatOnHost = (method, value) => {
@@ -6682,9 +6872,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);
 	};
@@ -8095,6 +8295,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");
@@ -8728,9 +8955,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 {
@@ -9623,7 +9851,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 require_is_finite_number.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;
@@ -9907,6 +10135,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))
 		};
@@ -10010,7 +10239,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 || require_is_finite_number.isFiniteNumber(sizeValue);
 		return hadFamily && projected.fontFamily === void 0 || hadSize && projected.fontSize === void 0;
 	};
 	const syncHostSelectionSubscription = () => {
@@ -10196,6 +10425,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;
@@ -10214,15 +10478,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);
@@ -10254,6 +10522,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);
@@ -10263,7 +10532,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();
@@ -12172,6 +12444,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;
@@ -12354,7 +12636,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;
 		}
@@ -13695,6 +13981,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,
@@ -13755,6 +14042,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 = () => {
@@ -13766,7 +14075,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 (!require_is_finite_number.isFiniteNumber(x) || !require_is_finite_number.isFiniteNumber(y)) return null;
 		const dom = globalThis.document;
 		if (!dom || typeof dom.elementFromPoint !== "function") return null;
 		const container = resolveVisibleHost();
@@ -14544,7 +14853,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 = require_is_finite_number.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 {
@@ -15237,6 +15546,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 {
@@ -15323,6 +15637,7 @@ function createSuperDocUI(options) {
 		painterCaptureEpoch += 1;
 		painterCommandDoc = null;
 		painterModeListeners.clear();
+		documentChangeListeners.clear();
 		searchRequestGeneration += 1;
 		customCommands.clear();
 	};
@@ -15340,6 +15655,7 @@ function createSuperDocUI(options) {
 		bookmarks,
 		fonts,
 		zoom,
+		history,
 		document: documentHandle,
 		viewport,
 		decorations,
@@ -15573,6 +15889,12 @@ Object.defineProperty(exports, "DOM_CLASS_NAMES", {
 		return DOM_CLASS_NAMES;
 	}
 });
+Object.defineProperty(exports, "PERMISSIONS", {
+	enumerable: true,
+	get: function() {
+		return PERMISSIONS;
+	}
+});
 Object.defineProperty(exports, "applyV2CommentInvalidationFromMutation", {
 	enumerable: true,
 	get: function() {
@@ -15603,6 +15925,12 @@ Object.defineProperty(exports, "createSuperDocUI", {
 		return createSuperDocUI;
 	}
 });
+Object.defineProperty(exports, "createTrackedChangePermissionResolver", {
+	enumerable: true,
+	get: function() {
+		return createTrackedChangePermissionResolver;
+	}
+});
 Object.defineProperty(exports, "executeFirstPartyCommandAsync", {
 	enumerable: true,
 	get: function() {
@@ -15615,6 +15943,12 @@ Object.defineProperty(exports, "executeFirstPartyShortcutAsync", {
 		return executeFirstPartyShortcutAsync;
 	}
 });
+Object.defineProperty(exports, "getCommandDescriptor", {
+	enumerable: true,
+	get: function() {
+		return getCommandDescriptor;
+	}
+});
 Object.defineProperty(exports, "getV2TrackedChangeMutationImpact", {
 	enumerable: true,
 	get: function() {
@@ -15627,6 +15961,12 @@ Object.defineProperty(exports, "getWorkflowRecording", {
 		return getWorkflowRecording;
 	}
 });
+Object.defineProperty(exports, "isAllowed", {
+	enumerable: true,
+	get: function() {
+		return isAllowed;
+	}
+});
 Object.defineProperty(exports, "isPlainObject", {
 	enumerable: true,
 	get: function() {
@@ -15651,6 +15991,12 @@ Object.defineProperty(exports, "isWorkflowRecordingEnabled", {
 		return isWorkflowRecordingEnabled;
 	}
 });
+Object.defineProperty(exports, "mutationCommittedEventChangedDocument", {
+	enumerable: true,
+	get: function() {
+		return mutationCommittedEventChangedDocument;
+	}
+});
 Object.defineProperty(exports, "readFirstPartyPageNumbers", {
 	enumerable: true,
 	get: function() {