superdoc 2.27.0-next.1 → 2.27.0-next.11

package/dist/chunks/{create-super-doc-ui-BCQ5RHxy.es.js → create-super-doc-ui-B29zw5qD.es.js}

@@ -1078,6 +1078,15 @@ var decodeLayoutStoryDataset = (raw) => {
 `${DOM_CLASS_NAMES.BLOCK_SDT}${DATA_ATTRS.SDT_ID}`;
 `${DATA_ATTRS.DRAGGABLE}`;
 //#endregion
+//#region src/helpers/tracked-change-comment-lane.ts
+var TRACKED_CHANGE_COMMENT_LANE_ID_PREFIX = "tc-comment:";
+function isSyntheticTrackedChangeCommentLaneItem(item) {
+	if (!item || typeof item !== "object") return false;
+	const { id, commentId } = item;
+	const itemId = id ?? commentId;
+	return typeof itemId === "string" && itemId.startsWith(TRACKED_CHANGE_COMMENT_LANE_ID_PREFIX);
+}
+//#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) {
@@ -2449,6 +2458,69 @@ function createDialogWorkflow(editor, options, onSuccess) {
 	};
 }
 //#endregion
+//#region src/public/ui/style-match-patch.ts
+var STYLE_MATCH_KEYS = [
+	["bold", "bold"],
+	["italic", "italic"],
+	["underline", "underline"],
+	["color", "color"],
+	["fontSize", "fontSize"],
+	["rFonts", "fontFamily"]
+];
+var STYLE_MATCH_READ_KEYS = [...STYLE_MATCH_KEYS.map(([readKey]) => readKey), "rStyle"];
+function buildStyleMatchPatch(effective, direct, options) {
+	const patch = {};
+	const characterStyle = direct.properties.rStyle;
+	const hasCharacterStyle = characterStyle != null && characterStyle.state !== "unset";
+	for (const [readKey, styleKey] of STYLE_MATCH_KEYS) {
+		const read = effective.properties[readKey];
+		if (read?.state !== "uniform") continue;
+		if (options.selectionUsesStyle && !hasCharacterStyle && direct.properties[readKey]?.state === "unset") continue;
+		patch[styleKey] = toStyleValue(readKey, read.value);
+	}
+	return patch;
+}
+function toStyleValue(key, value) {
+	switch (key) {
+		case "bold":
+		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 "rFonts": return fontsValue(value);
+		default: return null;
+	}
+}
+function underlineValue(value) {
+	if (value === true) return { val: "single" };
+	if (!value || typeof value !== "object") return { val: "none" };
+	const underline = value;
+	const result = { val: typeof underline.style === "string" && underline.style ? underline.style : "single" };
+	if (typeof underline.color === "string") result.color = underline.color;
+	if (typeof underline.themeColor === "string") result.themeColor = underline.themeColor;
+	return result;
+}
+var FONT_SLOTS = {
+	ascii: "ascii",
+	hAnsi: "hAnsi",
+	eastAsia: "eastAsia",
+	cs: "cs",
+	asciiTheme: "asciiTheme",
+	hAnsiTheme: "hAnsiTheme",
+	eastAsiaTheme: "eastAsiaTheme",
+	csTheme: "cstheme",
+	hint: "hint"
+};
+function fontsValue(value) {
+	if (!value || typeof value !== "object") return null;
+	const result = {};
+	for (const [slot, styleSlot] of Object.entries(FONT_SLOTS)) {
+		const font = value[slot];
+		if (typeof font === "string" && font.length > 0) result[styleSlot] = font;
+	}
+	return Object.keys(result).length > 0 ? result : null;
+}
+//#endregion
 //#region src/public/ui/format-painter-helpers.js
 /**
 * Maps SDRunProps field names to InlineRunPatch field names.
@@ -2634,12 +2706,6 @@ function getV2TrackedChangeMutationImpact(event) {
 }
 /**
 * Comment ids retired by a committed v2 mutation.
-*
-* AIDEV-NOTE: History commits put invalidated comment ids on `result`; cut and
-* other command receipts use `receipt`. Same origin split as
-* getV2TrackedChangeMutationImpact. Reading the wrong field, or treating a
-* tracked-change entity as a comment, leaves a sidebar card after cut or
-* undo/redo.
 */
 function collectV2InvalidatedCommentIds(event) {
 	const removedIds = /* @__PURE__ */ new Set();
@@ -7096,7 +7162,7 @@ function createSuperDocUI(options) {
 			failureCount: retryingSameToken ? prev.failureCount ?? 0 : 0,
 			retryAtMs: 0
 		});
-		Promise.resolve(raw).then((resolved) => {
+		const settled = Promise.resolve(raw).then((resolved) => {
 			const entry = asyncReads.get(key);
 			if (!entry || entry.inflightToken !== token) return;
 			asyncReads.set(key, {
@@ -7135,6 +7201,7 @@ function createSuperDocUI(options) {
 			const retryAtMs = Date.now() + retryDelayMs;
 			asyncReads.set(key, {
 				...entry,
+				settled: void 0,
 				inflightToken: null,
 				failedToken: token,
 				failureCount,
@@ -7142,6 +7209,8 @@ function createSuperDocUI(options) {
 			});
 			scheduleAsyncReadFailureRetry(retryAtMs);
 		});
+		const entry = asyncReads.get(key);
+		if (entry?.inflightToken === token) entry.settled = settled;
 		return null;
 	};
 	/**
@@ -7451,7 +7520,10 @@ function createSuperDocUI(options) {
 			if (hostSelection && info && typeof info === "object") selectionHostSnapshots.set(info, hostSelection);
 			return info;
 		};
-		const result = current({ includeText: true });
+		const result = current({
+			includeText: true,
+			...getEditor()?.editorVersion === 2 ? { offsetSpace: "selection" } : {}
+		});
 		return isPromiseLike(result) ? Promise.resolve(result).then(tag) : tag(result);
 	}
 	/** True when a host sync snapshot is a resolved collapsed caret (not a range). */
@@ -7588,7 +7660,10 @@ function createSuperDocUI(options) {
 		}
 		let raw;
 		try {
-			raw = current.call(selectionApi, { includeText: true });
+			raw = current.call(selectionApi, {
+				includeText: true,
+				...getEditor()?.editorVersion === 2 ? { offsetSpace: "selection" } : {}
+			});
 			if (isPromiseLike(raw)) raw = await Promise.resolve(raw);
 		} catch {
 			raw = null;
@@ -7606,9 +7681,26 @@ function createSuperDocUI(options) {
 		recompute();
 		return selection;
 	};
+	const realComments = (items) => items.filter((item) => !isSyntheticTrackedChangeCommentLaneItem(item));
+	let lastWindowComments = null;
+	const realCommentsOfWindow = (window) => {
+		const items = window?.commentItems;
+		if (!Array.isArray(items)) return null;
+		const last = lastWindowComments;
+		if (last?.source === items && shallowEqual(last.rows, items)) return last.real;
+		lastWindowComments = {
+			source: items,
+			rows: [...items],
+			real: realComments(items)
+		};
+		return lastWindowComments.real;
+	};
 	const readCommentsDirectory = () => {
 		const listComments = hostMethod(getDoc()?.comments, "list");
-		return readAsync("comments", contentToken(), () => listComments ? listComments() : void 0, (raw) => raw && Array.isArray(raw.items) ? raw.items : []);
+		return readAsync("comments", contentToken(), () => listComments ? listComments() : void 0, (raw) => {
+			const items = isPlainObject(raw) ? raw.items : void 0;
+			return Array.isArray(items) ? realComments(items) : [];
+		});
 	};
 	const readTrackChangesDirectory = (key = "trackChanges") => {
 		const token = contentToken();
@@ -7641,7 +7733,7 @@ function createSuperDocUI(options) {
 		const reviewWindow = getV2ReviewWindowSnapshot();
 		const hasWindowFeed = hasV2ReviewWindowFeed();
 		const catalog = !hasWindowFeed ? readCommentsDirectory() : null;
-		const windowItems = hasWindowFeed && Array.isArray(reviewWindow?.commentItems) ? reviewWindow.commentItems : null;
+		const windowItems = hasWindowFeed ? realCommentsOfWindow(reviewWindow) : null;
 		const value = hasWindowFeed ? windowItems : catalog.value;
 		const listStatus = hasWindowFeed ? reviewWindowSliceStatus(reviewWindow) : catalog.status;
 		const items = value ?? [];
@@ -14704,6 +14796,92 @@ function createSuperDocUI(options) {
 			}
 		}, 120);
 	};
+	const updateStyleToMatchSelection = (input) => {
+		const mode = readDocumentMode();
+		if (mode === "viewing") return failedReceipt("The document is read-only.", "DOCUMENT_READONLY");
+		if (mode === "suggesting") return failedReceipt("A style definition cannot be changed as a tracked suggestion.", "PRECONDITION_FAILED");
+		const sourceToken = contentToken();
+		const readPositionKey = () => {
+			const snapshot = readHostSelectionSnapshot();
+			if (!snapshot) return null;
+			return JSON.stringify({
+				story: snapshot.story,
+				tableCells: snapshot.tableCells,
+				points: ["anchor", "focus"].map((side) => {
+					const point = snapshot[side];
+					return point ? [
+						point.blockId,
+						point.blockOffset,
+						point.trackedBlockOffset,
+						point.story,
+						point.inlineAffinity,
+						point.outsideContentControl,
+						point.visualCaret
+					] : null;
+				})
+			});
+		};
+		const requestedPosition = readPositionKey();
+		const stale = failedReceipt("The selection or document changed while reading its style.", "REVISION_MISMATCH");
+		return readSelectionInfoFresh().then((selection) => {
+			const selectionToken = selectionKey(selection);
+			const isCurrent = () => !disposed && contentToken() === sourceToken && readPositionKey() === requestedPosition && selectionKey(state.selection) === selectionToken && readDocumentMode() === mode;
+			if (!isCurrent()) return stale;
+			const active = computeActiveParagraphStyle(selection, getStyleCatalog().cache).style;
+			const story = storyLocatorSignature(selectionStory(selection));
+			const keys = [styleCatalogReadKey({ includePreview: true }), ...selectionBlockIds(selection).map((id) => `node:${story}:${id}`)];
+			const unreadable = failedReceipt("The selection formatting could not be read.", "PRECONDITION_FAILED");
+			const run = (active) => {
+				if (keys.some((key) => {
+					const entry = asyncReads.get(key);
+					return entry && (!entry.hasSettled || entry.token !== sourceToken || entry.failedToken === sourceToken);
+				})) return unreadable;
+				const styleId = input?.styleId ?? active.styleId;
+				if (!styleId) return failedReceipt("Choose a style to update: the selection does not have a single paragraph style.", "INVALID_TARGET");
+				const doc = getDoc();
+				const readSelection = resolveDocOperation(doc, "format.readSelection");
+				const apply = resolveDocOperation(doc, "styles.apply");
+				if (!readSelection || !apply) return failedReceipt("Updating a style to match the selection is unavailable.");
+				let reads;
+				try {
+					reads = [readSelection({
+						selection: "current",
+						keys: STYLE_MATCH_READ_KEYS,
+						view: "effective"
+					}), readSelection({
+						selection: "current",
+						keys: STYLE_MATCH_READ_KEYS,
+						view: "direct"
+					})];
+				} catch {
+					return unreadable;
+				}
+				return Promise.all(reads).then(([effective, direct]) => {
+					if (!isCurrent()) return stale;
+					const patch = buildStyleMatchPatch(effective, direct, { selectionUsesStyle: !active.mixed && active.styleId === styleId });
+					if (Object.keys(patch).length === 0) return failedReceipt("The selection already matches the style.", "NO_OP");
+					const fallback = failedReceipt("Updating the style failed.");
+					return safeCall(() => settleWorkflowReceipt(apply({
+						target: {
+							scope: "style",
+							styleId,
+							channel: "run"
+						},
+						patch
+					}), fallback), fallback);
+				}, () => unreadable);
+			};
+			const pending = keys.flatMap((key) => {
+				const entry = asyncReads.get(key);
+				return entry?.inflightToken === sourceToken && entry.settled ? [entry.settled] : [];
+			});
+			if (pending.length === 0) return run(active);
+			return Promise.all(pending).then(() => {
+				if (!isCurrent()) return stale;
+				return run(computeActiveParagraphStyle(selection, getStyleCatalog().cache).style);
+			});
+		});
+	};
 	const stylesSub = sliceHandle((s) => s.styles);
 	const stylesSnap = snapshotHandle(stylesSub);
 	const styles = {
@@ -14716,7 +14894,8 @@ function createSuperDocUI(options) {
 			return readStyleCatalogLive(options).value;
 		},
 		getQuickGallery: () => stylesSub.get().quickGallery,
-		getActiveParagraphStyle: () => computeActiveParagraphStyle(state.selection, getStyleCatalog().cache).style
+		getActiveParagraphStyle: () => computeActiveParagraphStyle(state.selection, getStyleCatalog().cache).style,
+		updateToMatchSelection: (input) => updateStyleToMatchSelection(input)
 	};
 	const openWatermarkSurface = hostMethod(superdoc, "openSurface");
 	const watermark = createWatermarkController({
@@ -15051,4 +15230,4 @@ function commandIsActive(descriptor, selection) {
 	return descriptor.activeMark ? selection.activeMarks.includes(descriptor.activeMark) : false;
 }
 //#endregion
-export { isWorkflowRecordingEnabled as _, registerFirstPartyCommandMutation as a, getV2TrackedChangeMutationImpact as c, resolveImageSrc as d, shallowEqual as f, getWorkflowRecording as g, createInteractionHistory as h, readFirstPartyPageNumbers as i, isPlainObject as l, closeInteractionHistory as m, executeFirstPartyCommandAsync as n, BUILT_IN_COMMAND_IDS as o, DOM_CLASS_NAMES as p, executeFirstPartyShortcutAsync as r, applyV2CommentInvalidationFromMutation as s, createSuperDocUI as t, createImageFilePicker as u, recordInteraction as v };
+export { getWorkflowRecording as _, registerFirstPartyCommandMutation as a, getV2TrackedChangeMutationImpact as c, resolveImageSrc as d, shallowEqual as f, createInteractionHistory as g, closeInteractionHistory as h, readFirstPartyPageNumbers as i, isPlainObject as l, DOM_CLASS_NAMES as m, executeFirstPartyCommandAsync as n, BUILT_IN_COMMAND_IDS as o, isSyntheticTrackedChangeCommentLaneItem as p, executeFirstPartyShortcutAsync as r, applyV2CommentInvalidationFromMutation as s, createSuperDocUI as t, createImageFilePicker as u, isWorkflowRecordingEnabled as v, recordInteraction as y };

package/dist/chunks/{create-super-doc-ui-DK14sCrT.cjs → create-super-doc-ui-D1eOhAjv.cjs}

@@ -1078,6 +1078,15 @@ var decodeLayoutStoryDataset = (raw) => {
 `${DOM_CLASS_NAMES.BLOCK_SDT}${DATA_ATTRS.SDT_ID}`;
 `${DATA_ATTRS.DRAGGABLE}`;
 //#endregion
+//#region src/helpers/tracked-change-comment-lane.ts
+var TRACKED_CHANGE_COMMENT_LANE_ID_PREFIX = "tc-comment:";
+function isSyntheticTrackedChangeCommentLaneItem(item) {
+	if (!item || typeof item !== "object") return false;
+	const { id, commentId } = item;
+	const itemId = id ?? commentId;
+	return typeof itemId === "string" && itemId.startsWith(TRACKED_CHANGE_COMMENT_LANE_ID_PREFIX);
+}
+//#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) {
@@ -2450,6 +2459,69 @@ function createDialogWorkflow(editor, options, onSuccess) {
 	};
 }
 //#endregion
+//#region src/public/ui/style-match-patch.ts
+var STYLE_MATCH_KEYS = [
+	["bold", "bold"],
+	["italic", "italic"],
+	["underline", "underline"],
+	["color", "color"],
+	["fontSize", "fontSize"],
+	["rFonts", "fontFamily"]
+];
+var STYLE_MATCH_READ_KEYS = [...STYLE_MATCH_KEYS.map(([readKey]) => readKey), "rStyle"];
+function buildStyleMatchPatch(effective, direct, options) {
+	const patch = {};
+	const characterStyle = direct.properties.rStyle;
+	const hasCharacterStyle = characterStyle != null && characterStyle.state !== "unset";
+	for (const [readKey, styleKey] of STYLE_MATCH_KEYS) {
+		const read = effective.properties[readKey];
+		if (read?.state !== "uniform") continue;
+		if (options.selectionUsesStyle && !hasCharacterStyle && direct.properties[readKey]?.state === "unset") continue;
+		patch[styleKey] = toStyleValue(readKey, read.value);
+	}
+	return patch;
+}
+function toStyleValue(key, value) {
+	switch (key) {
+		case "bold":
+		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 "rFonts": return fontsValue(value);
+		default: return null;
+	}
+}
+function underlineValue(value) {
+	if (value === true) return { val: "single" };
+	if (!value || typeof value !== "object") return { val: "none" };
+	const underline = value;
+	const result = { val: typeof underline.style === "string" && underline.style ? underline.style : "single" };
+	if (typeof underline.color === "string") result.color = underline.color;
+	if (typeof underline.themeColor === "string") result.themeColor = underline.themeColor;
+	return result;
+}
+var FONT_SLOTS = {
+	ascii: "ascii",
+	hAnsi: "hAnsi",
+	eastAsia: "eastAsia",
+	cs: "cs",
+	asciiTheme: "asciiTheme",
+	hAnsiTheme: "hAnsiTheme",
+	eastAsiaTheme: "eastAsiaTheme",
+	csTheme: "cstheme",
+	hint: "hint"
+};
+function fontsValue(value) {
+	if (!value || typeof value !== "object") return null;
+	const result = {};
+	for (const [slot, styleSlot] of Object.entries(FONT_SLOTS)) {
+		const font = value[slot];
+		if (typeof font === "string" && font.length > 0) result[styleSlot] = font;
+	}
+	return Object.keys(result).length > 0 ? result : null;
+}
+//#endregion
 //#region src/public/ui/format-painter-helpers.js
 /**
 * Maps SDRunProps field names to InlineRunPatch field names.
@@ -2635,12 +2707,6 @@ function getV2TrackedChangeMutationImpact(event) {
 }
 /**
 * Comment ids retired by a committed v2 mutation.
-*
-* AIDEV-NOTE: History commits put invalidated comment ids on `result`; cut and
-* other command receipts use `receipt`. Same origin split as
-* getV2TrackedChangeMutationImpact. Reading the wrong field, or treating a
-* tracked-change entity as a comment, leaves a sidebar card after cut or
-* undo/redo.
 */
 function collectV2InvalidatedCommentIds(event) {
 	const removedIds = /* @__PURE__ */ new Set();
@@ -7097,7 +7163,7 @@ function createSuperDocUI(options) {
 			failureCount: retryingSameToken ? prev.failureCount ?? 0 : 0,
 			retryAtMs: 0
 		});
-		Promise.resolve(raw).then((resolved) => {
+		const settled = Promise.resolve(raw).then((resolved) => {
 			const entry = asyncReads.get(key);
 			if (!entry || entry.inflightToken !== token) return;
 			asyncReads.set(key, {
@@ -7136,6 +7202,7 @@ function createSuperDocUI(options) {
 			const retryAtMs = Date.now() + retryDelayMs;
 			asyncReads.set(key, {
 				...entry,
+				settled: void 0,
 				inflightToken: null,
 				failedToken: token,
 				failureCount,
@@ -7143,6 +7210,8 @@ function createSuperDocUI(options) {
 			});
 			scheduleAsyncReadFailureRetry(retryAtMs);
 		});
+		const entry = asyncReads.get(key);
+		if (entry?.inflightToken === token) entry.settled = settled;
 		return null;
 	};
 	/**
@@ -7452,7 +7521,10 @@ function createSuperDocUI(options) {
 			if (hostSelection && info && typeof info === "object") selectionHostSnapshots.set(info, hostSelection);
 			return info;
 		};
-		const result = current({ includeText: true });
+		const result = current({
+			includeText: true,
+			...getEditor()?.editorVersion === 2 ? { offsetSpace: "selection" } : {}
+		});
 		return isPromiseLike(result) ? Promise.resolve(result).then(tag) : tag(result);
 	}
 	/** True when a host sync snapshot is a resolved collapsed caret (not a range). */
@@ -7589,7 +7661,10 @@ function createSuperDocUI(options) {
 		}
 		let raw;
 		try {
-			raw = current.call(selectionApi, { includeText: true });
+			raw = current.call(selectionApi, {
+				includeText: true,
+				...getEditor()?.editorVersion === 2 ? { offsetSpace: "selection" } : {}
+			});
 			if (isPromiseLike(raw)) raw = await Promise.resolve(raw);
 		} catch {
 			raw = null;
@@ -7607,9 +7682,26 @@ function createSuperDocUI(options) {
 		recompute();
 		return selection;
 	};
+	const realComments = (items) => items.filter((item) => !isSyntheticTrackedChangeCommentLaneItem(item));
+	let lastWindowComments = null;
+	const realCommentsOfWindow = (window) => {
+		const items = window?.commentItems;
+		if (!Array.isArray(items)) return null;
+		const last = lastWindowComments;
+		if (last?.source === items && shallowEqual(last.rows, items)) return last.real;
+		lastWindowComments = {
+			source: items,
+			rows: [...items],
+			real: realComments(items)
+		};
+		return lastWindowComments.real;
+	};
 	const readCommentsDirectory = () => {
 		const listComments = hostMethod(getDoc()?.comments, "list");
-		return readAsync("comments", contentToken(), () => listComments ? listComments() : void 0, (raw) => raw && Array.isArray(raw.items) ? raw.items : []);
+		return readAsync("comments", contentToken(), () => listComments ? listComments() : void 0, (raw) => {
+			const items = isPlainObject(raw) ? raw.items : void 0;
+			return Array.isArray(items) ? realComments(items) : [];
+		});
 	};
 	const readTrackChangesDirectory = (key = "trackChanges") => {
 		const token = contentToken();
@@ -7642,7 +7734,7 @@ function createSuperDocUI(options) {
 		const reviewWindow = getV2ReviewWindowSnapshot();
 		const hasWindowFeed = hasV2ReviewWindowFeed();
 		const catalog = !hasWindowFeed ? readCommentsDirectory() : null;
-		const windowItems = hasWindowFeed && Array.isArray(reviewWindow?.commentItems) ? reviewWindow.commentItems : null;
+		const windowItems = hasWindowFeed ? realCommentsOfWindow(reviewWindow) : null;
 		const value = hasWindowFeed ? windowItems : catalog.value;
 		const listStatus = hasWindowFeed ? reviewWindowSliceStatus(reviewWindow) : catalog.status;
 		const items = value ?? [];
@@ -14705,6 +14797,92 @@ function createSuperDocUI(options) {
 			}
 		}, 120);
 	};
+	const updateStyleToMatchSelection = (input) => {
+		const mode = readDocumentMode();
+		if (mode === "viewing") return failedReceipt("The document is read-only.", "DOCUMENT_READONLY");
+		if (mode === "suggesting") return failedReceipt("A style definition cannot be changed as a tracked suggestion.", "PRECONDITION_FAILED");
+		const sourceToken = contentToken();
+		const readPositionKey = () => {
+			const snapshot = readHostSelectionSnapshot();
+			if (!snapshot) return null;
+			return JSON.stringify({
+				story: snapshot.story,
+				tableCells: snapshot.tableCells,
+				points: ["anchor", "focus"].map((side) => {
+					const point = snapshot[side];
+					return point ? [
+						point.blockId,
+						point.blockOffset,
+						point.trackedBlockOffset,
+						point.story,
+						point.inlineAffinity,
+						point.outsideContentControl,
+						point.visualCaret
+					] : null;
+				})
+			});
+		};
+		const requestedPosition = readPositionKey();
+		const stale = failedReceipt("The selection or document changed while reading its style.", "REVISION_MISMATCH");
+		return readSelectionInfoFresh().then((selection) => {
+			const selectionToken = selectionKey(selection);
+			const isCurrent = () => !disposed && contentToken() === sourceToken && readPositionKey() === requestedPosition && selectionKey(state.selection) === selectionToken && readDocumentMode() === mode;
+			if (!isCurrent()) return stale;
+			const active = computeActiveParagraphStyle(selection, getStyleCatalog().cache).style;
+			const story = storyLocatorSignature(selectionStory(selection));
+			const keys = [styleCatalogReadKey({ includePreview: true }), ...selectionBlockIds(selection).map((id) => `node:${story}:${id}`)];
+			const unreadable = failedReceipt("The selection formatting could not be read.", "PRECONDITION_FAILED");
+			const run = (active) => {
+				if (keys.some((key) => {
+					const entry = asyncReads.get(key);
+					return entry && (!entry.hasSettled || entry.token !== sourceToken || entry.failedToken === sourceToken);
+				})) return unreadable;
+				const styleId = input?.styleId ?? active.styleId;
+				if (!styleId) return failedReceipt("Choose a style to update: the selection does not have a single paragraph style.", "INVALID_TARGET");
+				const doc = getDoc();
+				const readSelection = resolveDocOperation(doc, "format.readSelection");
+				const apply = resolveDocOperation(doc, "styles.apply");
+				if (!readSelection || !apply) return failedReceipt("Updating a style to match the selection is unavailable.");
+				let reads;
+				try {
+					reads = [readSelection({
+						selection: "current",
+						keys: STYLE_MATCH_READ_KEYS,
+						view: "effective"
+					}), readSelection({
+						selection: "current",
+						keys: STYLE_MATCH_READ_KEYS,
+						view: "direct"
+					})];
+				} catch {
+					return unreadable;
+				}
+				return Promise.all(reads).then(([effective, direct]) => {
+					if (!isCurrent()) return stale;
+					const patch = buildStyleMatchPatch(effective, direct, { selectionUsesStyle: !active.mixed && active.styleId === styleId });
+					if (Object.keys(patch).length === 0) return failedReceipt("The selection already matches the style.", "NO_OP");
+					const fallback = failedReceipt("Updating the style failed.");
+					return safeCall(() => settleWorkflowReceipt(apply({
+						target: {
+							scope: "style",
+							styleId,
+							channel: "run"
+						},
+						patch
+					}), fallback), fallback);
+				}, () => unreadable);
+			};
+			const pending = keys.flatMap((key) => {
+				const entry = asyncReads.get(key);
+				return entry?.inflightToken === sourceToken && entry.settled ? [entry.settled] : [];
+			});
+			if (pending.length === 0) return run(active);
+			return Promise.all(pending).then(() => {
+				if (!isCurrent()) return stale;
+				return run(computeActiveParagraphStyle(selection, getStyleCatalog().cache).style);
+			});
+		});
+	};
 	const stylesSub = sliceHandle((s) => s.styles);
 	const stylesSnap = snapshotHandle(stylesSub);
 	const styles = {
@@ -14717,7 +14895,8 @@ function createSuperDocUI(options) {
 			return readStyleCatalogLive(options).value;
 		},
 		getQuickGallery: () => stylesSub.get().quickGallery,
-		getActiveParagraphStyle: () => computeActiveParagraphStyle(state.selection, getStyleCatalog().cache).style
+		getActiveParagraphStyle: () => computeActiveParagraphStyle(state.selection, getStyleCatalog().cache).style,
+		updateToMatchSelection: (input) => updateStyleToMatchSelection(input)
 	};
 	const openWatermarkSurface = hostMethod(superdoc, "openSurface");
 	const watermark = createWatermarkController({
@@ -15124,6 +15303,12 @@ Object.defineProperty(exports, "isPlainObject", {
 		return isPlainObject;
 	}
 });
+Object.defineProperty(exports, "isSyntheticTrackedChangeCommentLaneItem", {
+	enumerable: true,
+	get: function() {
+		return isSyntheticTrackedChangeCommentLaneItem;
+	}
+});
 Object.defineProperty(exports, "isWorkflowRecordingEnabled", {
 	enumerable: true,
 	get: function() {

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.27.0-next.1",
+	superdocVersion: "2.27.0-next.11",
 	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.27.0-next.1",
+	superdocVersion: "2.27.0-next.11",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/document-api/src/contract/operation-definitions.d.ts

@@ -42,7 +42,7 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'styles.apply': {
         readonly memberPath: "styles.apply";
-        readonly description: "Apply document-level default style changes to the active Style Definitions part. Targets docDefaults run and paragraph channels with set-style patch semantics.";
+        readonly description: "Apply style changes to the active Style Definitions part. Targets docDefaults run and paragraph channels, or the run properties of an existing named paragraph style (scope \"style\"), with set-style patch semantics. Redefining a named style updates every paragraph that references it; its linked character style receives the same patch, null removes a property so the style inherits it again, and an object value replaces that property whole.";
         readonly expectedResult: "Returns a StylesApplyReceipt with per-channel success/failure details for each property change.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
@@ -2523,7 +2523,7 @@ export declare const OPERATION_DEFINITIONS: {
     readonly 'contentControls.validateWordCompatibility': {
         readonly memberPath: "contentControls.validateWordCompatibility";
         readonly description: "Validate a content control for Word compatibility issues.";
-        readonly expectedResult: "Returns a compatibility result with diagnostics.";
+        readonly expectedResult: "Returns read-only diagnostics for incompatible content structure and metadata or configuration issues. `compatible` is false only when a diagnostic has error severity; warnings leave it true.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
         readonly referenceDocPath: "content-controls/validate-word-compatibility.mdx";

package/dist/document-api/src/history/history.types.d.ts

@@ -43,12 +43,6 @@ export interface SDHistoryCollaborationMeta {
  * Result of a history.undo or history.redo action.
  * Mirrors PlanReceipt's revision shape for consistency.
  *
- * AIDEV-NOTE: this shape carries optional ref-effect
- * fields. v1 callers leave them undefined; v2 (`V2HistoryAdapter`) populates
- * them from the stored semantic delta of the undone/redone transaction so
- * callers' held refs stay accurate across history actions. Never make any
- * of the new fields required — v1 adapters MUST keep compiling unchanged.
- *
  * The shape also carries three optional collaboration fields:
  * `status`, `diagnosticCode`, and `collaboration`. v1 leaves them
  * undefined; collaborative v2 sessions populate them so callers can react