superdoc 2.29.0-next.1 → 2.29.0-next.16

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

@@ -1079,6 +1079,11 @@ var decodeLayoutStoryDataset = (raw) => {
 `${DOM_CLASS_NAMES.BLOCK_SDT}${DATA_ATTRS.SDT_ID}`;
 `${DATA_ATTRS.DRAGGABLE}`;
 //#endregion
+//#region src/helpers/object-guards.ts
+function isPlainObject(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//#endregion
 //#region src/helpers/tracked-change-comment-lane.ts
 var TRACKED_CHANGE_COMMENT_LANE_ID_PREFIX = "tc-comment:";
 function isSyntheticTrackedChangeCommentLaneItem(item) {
@@ -1088,16 +1093,7 @@ 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
+//#region src/core/collaboration/permissions.ts
 var PERMISSIONS = Object.freeze({
 	RESOLVE_OWN: "RESOLVE_OWN",
 	RESOLVE_OTHER: "RESOLVE_OTHER",
@@ -1160,15 +1156,16 @@ var PERMISSION_MATRIX = Object.freeze({
 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;
+	const comments = context.superdoc?.config?.modules?.comments;
+	const deprecatedResolver = comments ? comments.permissionResolver : void 0;
 	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 hasBuiltInPermissionMethodBrand = (method) => (typeof method === "object" && method !== null || typeof method === "function") && Reflect.get(method, BUILT_IN_PERMISSION_METHOD) === true;
 var createTrackedChangePermissionResolver = (superdoc) => {
-	const isBuiltInPolicy = () => superdoc.canPerformPermission?.[BUILT_IN_PERMISSION_METHOD] === true && pickResolver({ superdoc }) === null;
+	const isBuiltInPolicy = () => hasBuiltInPermissionMethodBrand(superdoc.canPerformPermission) && pickResolver({ superdoc }) === null;
 	const resolver = (payload = {}) => isBuiltInPolicy() ? defaultDecisionFor(payload.permission, superdoc.config.role, superdoc.config.isInternal) : superdoc.canPerformPermission({
 		...payload,
 		role: superdoc.config.role,
@@ -1178,6 +1175,7 @@ var createTrackedChangePermissionResolver = (superdoc) => {
 	return resolver;
 };
 var defaultDecisionFor = (permission, role, isInternal) => {
+	if (permission === void 0 || typeof role !== "string") return false;
 	const internalExternal = isInternal ? "internal" : "external";
 	return PERMISSION_MATRIX[permission]?.[internalExternal]?.includes(role) ?? false;
 };
@@ -1222,21 +1220,6 @@ var readBuiltInTrackedChangePermissionDecision = (superdoc, canPerform, permissi
 		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);
@@ -2023,13 +2006,9 @@ var WatermarkSurface_default = /* @__PURE__ */ _plugin_vue_export_helper_default
 	}
 }), [["__scopeId", "data-v-df56c82c"]]);
 //#endregion
-//#region src/components/surfaces/watermark-surface-runtime.js
-/**
-* Keeps Vue rendering and post-dismissal announcements outside the public type graph.
-* @param {(() => HTMLElement | null) | undefined} getContainer
-*/
+//#region src/components/surfaces/watermark-surface-runtime.ts
+/** Keeps Vue rendering and post-dismissal announcements outside the public type graph. */
 function createWatermarkSurfaceRuntime(getContainer) {
-	/** @type {HTMLDivElement | null} */
 	let status = null;
 	let disposed = false;
 	return {
@@ -2040,7 +2019,6 @@ function createWatermarkSurfaceRuntime(getContainer) {
 			const item = opener?.closest("[data-sd-part=\"toolbar-item\"]") ?? opener?.querySelector("[data-sd-part=\"toolbar-item\"]");
 			const container = (item?.closest("[data-sd-part=\"toolbar\"]"))?.parentElement;
 			const isWatermarkEntry = item?.querySelector("[data-item=\"btn-watermark\"], [data-item=\"btn-overflow\"]");
-			/** @param {() => boolean} isCurrent */
 			return async (isCurrent) => {
 				await nextTick();
 				if (disposed || !isCurrent() || !isWatermarkEntry || opener?.isConnected || !container?.isConnected) return;
@@ -2072,7 +2050,6 @@ function createWatermarkSurfaceRuntime(getContainer) {
 			});
 			container.appendChild(status);
 		},
-		/** @param {string} message */
 		announce(message) {
 			if (!disposed && status) status.textContent = message;
 		},
@@ -2688,34 +2665,33 @@ function fontsValue(value) {
 	return Object.keys(result).length > 0 ? result : null;
 }
 //#endregion
-//#region src/public/ui/format-painter-helpers.js
+//#region src/public/ui/format-painter-helpers.ts
 /**
 * Maps SDRunProps field names to InlineRunPatch field names.
 * SDRunProps (read-side) and InlineRunPatch (write-side) use different keys
 * for the same properties; direct assignment between them is forbidden.
-*
-* @param {Record<string, unknown>} props - SDRunProps object from doc.getNodeById
-* @returns {Record<string, unknown>} InlineRunPatch ready for doc.format.apply
 */
 function sdRunPropsToInlineRunPatch(props) {
 	if (!props || typeof props !== "object") return {};
 	const patch = {};
-	if (props.fonts) patch.rFonts = {
-		ascii: props.fonts.ascii,
-		hAnsi: props.fonts.hAnsi,
-		eastAsia: props.fonts.eastAsia,
-		cs: props.fonts.cs,
-		asciiTheme: props.fonts.asciiTheme,
-		hAnsiTheme: props.fonts.hAnsiTheme,
-		eastAsiaTheme: props.fonts.eastAsiaTheme,
-		csTheme: props.fonts.csTheme,
-		hint: props.fonts.hint
+	const fonts = props.fonts;
+	if (isPlainObject(fonts)) patch.rFonts = {
+		ascii: fonts.ascii,
+		hAnsi: fonts.hAnsi,
+		eastAsia: fonts.eastAsia,
+		cs: fonts.cs,
+		asciiTheme: fonts.asciiTheme,
+		hAnsiTheme: fonts.hAnsiTheme,
+		eastAsiaTheme: fonts.eastAsiaTheme,
+		csTheme: fonts.csTheme,
+		hint: fonts.hint
 	};
 	if (props.fontFamily != null) patch.fontFamily = props.fontFamily;
-	if (props.lang) patch.lang = {
-		val: props.lang.val,
-		eastAsia: props.lang.eastAsia,
-		bidi: props.lang.bidi
+	const lang = props.lang;
+	if (isPlainObject(lang)) patch.lang = {
+		val: lang.val,
+		eastAsia: lang.eastAsia,
+		bidi: lang.bidi
 	};
 	if (props.fontSize != null) patch.fontSize = props.fontSize;
 	if (props.fontSizeCs != null) patch.fontSizeCs = props.fontSizeCs;
@@ -2756,19 +2732,24 @@ function sdRunPropsToInlineRunPatch(props) {
 function projectColorRefToInlineColor(color) {
 	if (!color) return void 0;
 	if (typeof color === "string") return color;
+	if (!isPlainObject(color)) return void 0;
 	if (color.model === "rgb") return color.value;
 	if (color.model === "auto") return "auto";
 }
 function projectUnderlineToInlinePatch(underline) {
 	if (underline == null) return void 0;
+	if (!isPlainObject(underline)) return true;
 	const patch = {};
 	if (underline.style != null) patch.style = underline.style;
-	if (underline.color?.model === "rgb") patch.color = underline.color.value;
-	if (underline.color?.model === "theme") patch.themeColor = underline.color.theme;
+	const color = underline.color;
+	if (isPlainObject(color)) {
+		if (color.model === "rgb") patch.color = color.value;
+		else if (color.model === "theme") patch.themeColor = color.theme;
+	}
 	return Object.keys(patch).length > 0 ? patch : true;
 }
 function projectShadingToInlinePatch(shading) {
-	if (!shading) return void 0;
+	if (!isPlainObject(shading)) return void 0;
 	const patch = {};
 	const fill = projectColorRefToInlineColor(shading.fill);
 	if (fill != null) patch.fill = fill;
@@ -2778,7 +2759,7 @@ function projectShadingToInlinePatch(shading) {
 	return Object.keys(patch).length > 0 ? patch : void 0;
 }
 function projectBorderToInlinePatch(border) {
-	if (!border) return void 0;
+	if (!isPlainObject(border)) return void 0;
 	const patch = {};
 	if (border.style != null) patch.val = border.style;
 	if (border.width != null) patch.sz = border.width;
@@ -2793,9 +2774,6 @@ function projectBorderToInlinePatch(border) {
 *
 * Falls back to the plain text target when the host has not populated an
 * explicit `selectionTarget` yet.
-*
-* @param {{ selectionTarget?: unknown; target?: unknown } | null | undefined} selection
-* @returns {string}
 */
 function selectionKey(selection) {
 	const target = selection?.selectionTarget ?? selection?.target;
@@ -2904,7 +2882,7 @@ function readAllResolvedFact(event, receipt) {
 	return fact;
 }
 //#endregion
-//#region src/helpers/v2-typing-mutation-event.js
+//#region src/helpers/v2-typing-mutation-event.ts
 /**
 * Command kinds whose committed mutations belong to the sustained typing
 * cadence class (insert / replace / plain paste / Backspace / Delete).
@@ -2945,9 +2923,6 @@ var V2_TYPING_COMMAND_KINDS = /* @__PURE__ */ new Set([
 * Events without a forwarded `editableCommandKind` (programmatic Document API
 * mutations, history commits, unclassified structural commands) return false
 * so they keep hydrating immediately.
-*
-* @param {{ type?: string, origin?: string, editableCommandKind?: string } | null | undefined} event
-* @returns {boolean}
 */
 var isV2EditableTextMutationEvent = (event) => {
 	if (event?.type !== "mutation:committed" || event.origin !== "command") return false;
@@ -15876,4 +15851,4 @@ function commandIsActive(descriptor, selection) {
 	return descriptor.activeMark ? selection.activeMarks.includes(descriptor.activeMark) : false;
 }
 //#endregion
-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 };
+export { createInteractionHistory as C, recordInteraction as E, closeInteractionHistory as S, isWorkflowRecordingEnabled as T, createTrackedChangePermissionResolver as _, registerFirstPartyCommandMutation as a, isPlainObject as b, getCommandDescriptor as c, mutationCommittedEventChangedDocument as d, createImageFilePicker as f, PERMISSIONS as g, BUILT_IN_PERMISSION_METHOD 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, isAllowed as v, getWorkflowRecording as w, DOM_CLASS_NAMES as x, isSyntheticTrackedChangeCommentLaneItem as y };

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

@@ -1079,6 +1079,11 @@ var decodeLayoutStoryDataset = (raw) => {
 `${DOM_CLASS_NAMES.BLOCK_SDT}${DATA_ATTRS.SDT_ID}`;
 `${DATA_ATTRS.DRAGGABLE}`;
 //#endregion
+//#region src/helpers/object-guards.ts
+function isPlainObject(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//#endregion
 //#region src/helpers/tracked-change-comment-lane.ts
 var TRACKED_CHANGE_COMMENT_LANE_ID_PREFIX = "tc-comment:";
 function isSyntheticTrackedChangeCommentLaneItem(item) {
@@ -1088,16 +1093,7 @@ 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
+//#region src/core/collaboration/permissions.ts
 var PERMISSIONS = Object.freeze({
 	RESOLVE_OWN: "RESOLVE_OWN",
 	RESOLVE_OTHER: "RESOLVE_OTHER",
@@ -1160,15 +1156,16 @@ var PERMISSION_MATRIX = Object.freeze({
 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;
+	const comments = context.superdoc?.config?.modules?.comments;
+	const deprecatedResolver = comments ? comments.permissionResolver : void 0;
 	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 hasBuiltInPermissionMethodBrand = (method) => (typeof method === "object" && method !== null || typeof method === "function") && Reflect.get(method, BUILT_IN_PERMISSION_METHOD) === true;
 var createTrackedChangePermissionResolver = (superdoc) => {
-	const isBuiltInPolicy = () => superdoc.canPerformPermission?.[BUILT_IN_PERMISSION_METHOD] === true && pickResolver({ superdoc }) === null;
+	const isBuiltInPolicy = () => hasBuiltInPermissionMethodBrand(superdoc.canPerformPermission) && pickResolver({ superdoc }) === null;
 	const resolver = (payload = {}) => isBuiltInPolicy() ? defaultDecisionFor(payload.permission, superdoc.config.role, superdoc.config.isInternal) : superdoc.canPerformPermission({
 		...payload,
 		role: superdoc.config.role,
@@ -1178,6 +1175,7 @@ var createTrackedChangePermissionResolver = (superdoc) => {
 	return resolver;
 };
 var defaultDecisionFor = (permission, role, isInternal) => {
+	if (permission === void 0 || typeof role !== "string") return false;
 	const internalExternal = isInternal ? "internal" : "external";
 	return PERMISSION_MATRIX[permission]?.[internalExternal]?.includes(role) ?? false;
 };
@@ -1222,21 +1220,6 @@ var readBuiltInTrackedChangePermissionDecision = (superdoc, canPerform, permissi
 		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);
@@ -2024,13 +2007,9 @@ var WatermarkSurface_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/
 //#region src/components/surfaces/WatermarkSurface.vue
 var WatermarkSurface_default = /* @__PURE__ */ require__plugin_vue_export_helper._plugin_vue_export_helper_default(WatermarkSurface_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-df56c82c"]]);
 //#endregion
-//#region src/components/surfaces/watermark-surface-runtime.js
-/**
-* Keeps Vue rendering and post-dismissal announcements outside the public type graph.
-* @param {(() => HTMLElement | null) | undefined} getContainer
-*/
+//#region src/components/surfaces/watermark-surface-runtime.ts
+/** Keeps Vue rendering and post-dismissal announcements outside the public type graph. */
 function createWatermarkSurfaceRuntime(getContainer) {
-	/** @type {HTMLDivElement | null} */
 	let status = null;
 	let disposed = false;
 	return {
@@ -2041,7 +2020,6 @@ function createWatermarkSurfaceRuntime(getContainer) {
 			const item = opener?.closest("[data-sd-part=\"toolbar-item\"]") ?? opener?.querySelector("[data-sd-part=\"toolbar-item\"]");
 			const container = (item?.closest("[data-sd-part=\"toolbar\"]"))?.parentElement;
 			const isWatermarkEntry = item?.querySelector("[data-item=\"btn-watermark\"], [data-item=\"btn-overflow\"]");
-			/** @param {() => boolean} isCurrent */
 			return async (isCurrent) => {
 				await require__plugin_vue_export_helper.nextTick();
 				if (disposed || !isCurrent() || !isWatermarkEntry || opener?.isConnected || !container?.isConnected) return;
@@ -2073,7 +2051,6 @@ function createWatermarkSurfaceRuntime(getContainer) {
 			});
 			container.appendChild(status);
 		},
-		/** @param {string} message */
 		announce(message) {
 			if (!disposed && status) status.textContent = message;
 		},
@@ -2689,34 +2666,33 @@ function fontsValue(value) {
 	return Object.keys(result).length > 0 ? result : null;
 }
 //#endregion
-//#region src/public/ui/format-painter-helpers.js
+//#region src/public/ui/format-painter-helpers.ts
 /**
 * Maps SDRunProps field names to InlineRunPatch field names.
 * SDRunProps (read-side) and InlineRunPatch (write-side) use different keys
 * for the same properties; direct assignment between them is forbidden.
-*
-* @param {Record<string, unknown>} props - SDRunProps object from doc.getNodeById
-* @returns {Record<string, unknown>} InlineRunPatch ready for doc.format.apply
 */
 function sdRunPropsToInlineRunPatch(props) {
 	if (!props || typeof props !== "object") return {};
 	const patch = {};
-	if (props.fonts) patch.rFonts = {
-		ascii: props.fonts.ascii,
-		hAnsi: props.fonts.hAnsi,
-		eastAsia: props.fonts.eastAsia,
-		cs: props.fonts.cs,
-		asciiTheme: props.fonts.asciiTheme,
-		hAnsiTheme: props.fonts.hAnsiTheme,
-		eastAsiaTheme: props.fonts.eastAsiaTheme,
-		csTheme: props.fonts.csTheme,
-		hint: props.fonts.hint
+	const fonts = props.fonts;
+	if (isPlainObject(fonts)) patch.rFonts = {
+		ascii: fonts.ascii,
+		hAnsi: fonts.hAnsi,
+		eastAsia: fonts.eastAsia,
+		cs: fonts.cs,
+		asciiTheme: fonts.asciiTheme,
+		hAnsiTheme: fonts.hAnsiTheme,
+		eastAsiaTheme: fonts.eastAsiaTheme,
+		csTheme: fonts.csTheme,
+		hint: fonts.hint
 	};
 	if (props.fontFamily != null) patch.fontFamily = props.fontFamily;
-	if (props.lang) patch.lang = {
-		val: props.lang.val,
-		eastAsia: props.lang.eastAsia,
-		bidi: props.lang.bidi
+	const lang = props.lang;
+	if (isPlainObject(lang)) patch.lang = {
+		val: lang.val,
+		eastAsia: lang.eastAsia,
+		bidi: lang.bidi
 	};
 	if (props.fontSize != null) patch.fontSize = props.fontSize;
 	if (props.fontSizeCs != null) patch.fontSizeCs = props.fontSizeCs;
@@ -2757,19 +2733,24 @@ function sdRunPropsToInlineRunPatch(props) {
 function projectColorRefToInlineColor(color) {
 	if (!color) return void 0;
 	if (typeof color === "string") return color;
+	if (!isPlainObject(color)) return void 0;
 	if (color.model === "rgb") return color.value;
 	if (color.model === "auto") return "auto";
 }
 function projectUnderlineToInlinePatch(underline) {
 	if (underline == null) return void 0;
+	if (!isPlainObject(underline)) return true;
 	const patch = {};
 	if (underline.style != null) patch.style = underline.style;
-	if (underline.color?.model === "rgb") patch.color = underline.color.value;
-	if (underline.color?.model === "theme") patch.themeColor = underline.color.theme;
+	const color = underline.color;
+	if (isPlainObject(color)) {
+		if (color.model === "rgb") patch.color = color.value;
+		else if (color.model === "theme") patch.themeColor = color.theme;
+	}
 	return Object.keys(patch).length > 0 ? patch : true;
 }
 function projectShadingToInlinePatch(shading) {
-	if (!shading) return void 0;
+	if (!isPlainObject(shading)) return void 0;
 	const patch = {};
 	const fill = projectColorRefToInlineColor(shading.fill);
 	if (fill != null) patch.fill = fill;
@@ -2779,7 +2760,7 @@ function projectShadingToInlinePatch(shading) {
 	return Object.keys(patch).length > 0 ? patch : void 0;
 }
 function projectBorderToInlinePatch(border) {
-	if (!border) return void 0;
+	if (!isPlainObject(border)) return void 0;
 	const patch = {};
 	if (border.style != null) patch.val = border.style;
 	if (border.width != null) patch.sz = border.width;
@@ -2794,9 +2775,6 @@ function projectBorderToInlinePatch(border) {
 *
 * Falls back to the plain text target when the host has not populated an
 * explicit `selectionTarget` yet.
-*
-* @param {{ selectionTarget?: unknown; target?: unknown } | null | undefined} selection
-* @returns {string}
 */
 function selectionKey(selection) {
 	const target = selection?.selectionTarget ?? selection?.target;
@@ -2905,7 +2883,7 @@ function readAllResolvedFact(event, receipt) {
 	return fact;
 }
 //#endregion
-//#region src/helpers/v2-typing-mutation-event.js
+//#region src/helpers/v2-typing-mutation-event.ts
 /**
 * Command kinds whose committed mutations belong to the sustained typing
 * cadence class (insert / replace / plain paste / Backspace / Delete).
@@ -2946,9 +2924,6 @@ var V2_TYPING_COMMAND_KINDS = /* @__PURE__ */ new Set([
 * Events without a forwarded `editableCommandKind` (programmatic Document API
 * mutations, history commits, unclassified structural commands) return false
 * so they keep hydrating immediately.
-*
-* @param {{ type?: string, origin?: string, editableCommandKind?: string } | null | undefined} event
-* @returns {boolean}
 */
 var isV2EditableTextMutationEvent = (event) => {
 	if (event?.type !== "mutation:committed" || event.origin !== "command") return false;
@@ -15883,6 +15858,12 @@ Object.defineProperty(exports, "BUILT_IN_COMMAND_IDS", {
 		return BUILT_IN_COMMAND_IDS;
 	}
 });
+Object.defineProperty(exports, "BUILT_IN_PERMISSION_METHOD", {
+	enumerable: true,
+	get: function() {
+		return BUILT_IN_PERMISSION_METHOD;
+	}
+});
 Object.defineProperty(exports, "DOM_CLASS_NAMES", {
 	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.29.0-next.1",
+	superdocVersion: "2.29.0-next.16",
 	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.29.0-next.1",
+	superdocVersion: "2.29.0-next.16",
 	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, TrackedAttribution } from '../write/write.js';
+import { RichContentReplaceInput, ReplaceMutationOptions, TrackedReplaceMutationOptions } from '../replace/replace.js';
+import { ChangeMode, RichContentMutationOptions, TrackedRichContentMutationOptions } 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';
@@ -15,13 +15,11 @@ export interface SDHtmlMarkdownCheckGuard {
 export type SDHtmlMarkdownSupportCheckInput = {
     operation: 'insert';
     input: RichContentInsertInput;
-    options?: {
-        changeMode?: ChangeMode;
-    } & TrackedAttribution;
+    options?: Pick<RichContentMutationOptions, 'changeMode' | 'author' | 'date'> | Pick<TrackedRichContentMutationOptions, 'changeMode' | 'author' | 'date'>;
 } | {
     operation: 'replace';
     input: RichContentReplaceInput;
-    options?: Pick<ReplaceMutationOptions, 'changeMode' | 'replaceMode' | 'expectedSnapshotId'> & TrackedAttribution;
+    options?: Pick<ReplaceMutationOptions, 'changeMode' | 'replaceMode' | 'expectedSnapshotId' | 'author' | 'date'> | Pick<TrackedReplaceMutationOptions, 'changeMode' | 'replaceMode' | 'expectedSnapshotId' | 'author' | 'date'>;
 } | {
     operation: 'projectHtml';
     input?: ProjectHtmlInput;

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

@@ -25,6 +25,7 @@ export interface AddCommentInput extends CommentCreateAttributionInput {
     target?: CommentTarget;
     /** The comment body text. */
     text: string;
+    expectedText?: string;
 }
 export interface EditCommentInput {
     commentId: string;
@@ -114,6 +115,7 @@ export interface CommentsCreateInput extends CommentCreateAttributionInput {
      * both when they contain the same value.
      */
     parentId?: string;
+    expectedText?: string;
 }
 /**
  * Input for `comments.patch`: field-level patch on an existing comment.

package/dist/document-api/src/contract/metadata-types.d.ts

@@ -3,7 +3,7 @@ export declare const OPERATION_IDEMPOTENCY_VALUES: readonly ["idempotent", "cond
 export type OperationIdempotency = (typeof OPERATION_IDEMPOTENCY_VALUES)[number];
 export declare const OPERATION_TRACKED_SUPPORT_VALUES: readonly ["always", "conditional", "never"];
 export type OperationTrackedSupport = (typeof OPERATION_TRACKED_SUPPORT_VALUES)[number];
-export declare const PRE_APPLY_THROW_CODES: readonly ["TARGET_NOT_FOUND", "CAPABILITY_UNAVAILABLE", "INVALID_TARGET", "AMBIGUOUS_TARGET", "REVISION_MISMATCH", "MATCH_NOT_FOUND", "AMBIGUOUS_MATCH", "STYLE_CONFLICT", "PRECONDITION_FAILED", "INVALID_INPUT", "CROSS_BLOCK_MATCH", "SPAN_FRAGMENTED", "TARGET_MOVED", "PLAN_CONFLICT_OVERLAP", "INVALID_STEP_COMBINATION", "REVISION_CHANGED_SINCE_COMPILE", "INVALID_INSERTION_CONTEXT", "DOCUMENT_IDENTITY_CONFLICT", "INTERNAL_ERROR", "ADDRESS_STALE", "DUPLICATE_ID", "INVALID_CONTEXT", "RAW_MODE_REQUIRED", "PRESERVE_ONLY_VIOLATION", "CAPABILITY_UNSUPPORTED", "LOCK_VIOLATION", "TYPE_MISMATCH", "STORY_NOT_FOUND", "STORY_MISMATCH", "STORY_NOT_SUPPORTED", "CROSS_STORY_PLAN", "MATERIALIZATION_FAILED", "RESOURCE_LIMIT"];
+export declare const PRE_APPLY_THROW_CODES: readonly ["TARGET_NOT_FOUND", "CAPABILITY_UNAVAILABLE", "INVALID_TARGET", "AMBIGUOUS_TARGET", "REVISION_MISMATCH", "MATCH_NOT_FOUND", "AMBIGUOUS_MATCH", "STYLE_CONFLICT", "PRECONDITION_FAILED", "INVALID_INPUT", "INVALID_ARGUMENT", "CROSS_BLOCK_MATCH", "SPAN_FRAGMENTED", "TARGET_MOVED", "PLAN_CONFLICT_OVERLAP", "INVALID_STEP_COMBINATION", "REVISION_CHANGED_SINCE_COMPILE", "INVALID_INSERTION_CONTEXT", "DOCUMENT_IDENTITY_CONFLICT", "INTERNAL_ERROR", "ADDRESS_STALE", "DUPLICATE_ID", "INVALID_CONTEXT", "RAW_MODE_REQUIRED", "PRESERVE_ONLY_VIOLATION", "CAPABILITY_UNSUPPORTED", "LOCK_VIOLATION", "TYPE_MISMATCH", "STORY_NOT_FOUND", "STORY_MISMATCH", "STORY_NOT_SUPPORTED", "CROSS_STORY_PLAN", "MATERIALIZATION_FAILED", "RESOURCE_LIMIT"];
 export type PreApplyThrowCode = (typeof PRE_APPLY_THROW_CODES)[number];
 export interface CommandThrowPolicy {
     preApply: readonly PreApplyThrowCode[];

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

@@ -933,8 +933,8 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'comments.create': {
         readonly memberPath: "comments.create";
-        readonly description: "Create a new comment thread (or reply when parentCommentId is given). Accepts TextAddress / TextTarget anchors, or a TrackedChangeCommentTarget that names a logical tracked-change id. The tracked-change target accepts both the explicit kind form and the Labs-compatible trackedChangeId-only form; the adapter normalizes it to a Word-compatible content anchor on the requested revision side. Callers may supply a durable externalId, or use the v1-compatible caller-supplied commentId alias, plus author fields and arbitrary JSON metadata for integration correlation. The caller-owned id remains distinct from the generated Word-compatible commentId.";
-        readonly expectedResult: "Returns a Receipt with the new commentId in `id` and `inserted` on success; rejects whitespace-only bodies, unsupported anchor contexts, and cross-story targets. Tracked-change comment targets support insertion, deletion, replacement, and paired-move revisions; they fail with `TARGET_NOT_FOUND` for stale ids, `CAPABILITY_UNAVAILABLE` for formatting / structural revisions and unpaired move sides, and `INVALID_TARGET` for incompatible side requests or ambiguous replacement targets that omit a required `side`.";
+        readonly description: "Create a new comment thread (or reply when parentCommentId is given). Accepts TextAddress / TextTarget anchors, or a TrackedChangeCommentTarget that names a logical tracked-change id. The tracked-change target accepts both the explicit kind form and the Labs-compatible trackedChangeId-only form; the adapter normalizes it to a Word-compatible content anchor on the requested revision side. Callers may supply a durable externalId, or use the v1-compatible caller-supplied commentId alias, plus author fields and arbitrary JSON metadata for integration correlation. The caller-owned id remains distinct from the generated Word-compatible commentId. Pass expectedText with a single-paragraph text target to refuse the comment when the text at that target has changed since it was selected.";
+        readonly expectedResult: "Returns a Receipt with the new commentId in `id` and `inserted` on success; rejects whitespace-only bodies, unsupported anchor contexts, and cross-story targets. When expectedText is given and the target text differs, fails with `PRECONDITION_FAILED` before any change. Tracked-change comment targets support insertion, deletion, replacement, and paired-move revisions; they fail with `TARGET_NOT_FOUND` for stale ids, `CAPABILITY_UNAVAILABLE` for formatting / structural revisions and unpaired move sides, and `INVALID_TARGET` for incompatible side requests or ambiguous replacement targets that omit a required `side`.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
         readonly referenceDocPath: "comments/create.mdx";
@@ -1448,7 +1448,7 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'tables.sort': {
         readonly memberPath: "tables.sort";
-        readonly description: "Sort table rows by a column value.";
+        readonly description: "Sort table rows by column values, preserving the leading repeating-header prefix unless skipHeaderRows specifies an exact override. Repetition flags and styling remain attached to their rows. Collaborative sessions reject structural table rewrites without mutation.";
         readonly expectedResult: "Returns a TableMutationResult receipt confirming rows were reordered.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;

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

@@ -1,9 +1,9 @@
 import { DocumentApiSurface } from '../index.js';
-import { PlainTextInsertInput } from '../insert/insert.js';
-import { TextReplaceInput } from '../replace/replace.js';
+import { InsertInput } from '../insert/insert.js';
+import { ReplaceInput, TrackedReplaceMutationOptions } from '../replace/replace.js';
 import { BodyStoryLocator } from '../types/story.types.js';
 import { OperationCancellation } from '../write/operation-cancellation.js';
-import { TrackedTextMutationOptions } from '../write/write.js';
+import { TrackedRichContentMutationOptions } from '../write/write.js';
 import { OPERATION_DEFINITIONS } from './operation-definitions.js';
 import { OperationId } from './types.js';
 type ResolveMemberPath<T, Path extends string> = Path extends `${infer Head}.${infer Tail}` ? Head extends keyof T ? ResolveMemberPath<T[Head], Tail> : never : Path extends keyof T ? T[Path] : never;
@@ -32,19 +32,20 @@ type MethodInvokeRequest<T extends OperationId> = OperationRegistry[T]['options'
     input: OperationRegistry[T]['input'];
     options?: OperationRegistry[T]['options'];
 };
-type AttributedTextInvokeRequest<T extends OperationId> = T extends 'insert' ? {
+type AttributedInvokeRequest<T extends OperationId> = T extends 'insert' ? {
     operationId: T;
-    input: PlainTextInsertInput;
-    options: TrackedTextMutationOptions & OperationCancellation;
+    input: InsertInput;
+    options: TrackedRichContentMutationOptions & OperationCancellation;
 } : T extends 'replace' ? {
     operationId: T;
-    input: Exclude<TextReplaceInput, {
+    input: Exclude<ReplaceInput, {
         target: BodyStoryLocator;
+        text: string;
     }>;
-    options: TrackedTextMutationOptions;
+    options: TrackedReplaceMutationOptions;
 } : never;
 /** Typed invoke request narrowed by `operationId` and supported content shape. */
-export type InvokeRequest<T extends OperationId> = MethodInvokeRequest<T> | AttributedTextInvokeRequest<T>;
+export type InvokeRequest<T extends OperationId> = MethodInvokeRequest<T> | AttributedInvokeRequest<T>;
 /** Typed invoke result narrowed by `operationId`. */
 export type InvokeResult<T extends OperationId> = T extends 'mutations.preview' | 'mutations.apply' ? Promise<OperationRegistry[T]['output']> : T extends 'plan.execute' ? OperationRegistry[T]['output'] | Promise<OperationRegistry[T]['output']> : OperationRegistry[T]['output'];
 export type OperationCall<T extends OperationId> = InvokeRequest<T> extends infer Request ? (Request extends unknown ? Omit<Request, 'operationId'> : never) : never;