superdoc 2.28.0 → 2.29.0-next.13

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

@@ -1,4 +1,5 @@
 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",
@@ -1078,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) {
@@ -1087,14 +1093,149 @@ 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);
-}
+//#region src/core/collaboration/permissions.ts
+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 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");
+var hasBuiltInPermissionMethodBrand = (method) => (typeof method === "object" && method !== null || typeof method === "function") && Reflect.get(method, BUILT_IN_PERMISSION_METHOD) === true;
+var createTrackedChangePermissionResolver = (superdoc) => {
+	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,
+		isInternal: superdoc.config.isInternal
+	});
+	Object.defineProperty(resolver, BUILT_IN_PERMISSION_RESOLVER, { value: isBuiltInPolicy });
+	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;
+};
+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;
+	}
+};
+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. */
@@ -1866,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 {
@@ -1883,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;
@@ -1915,7 +2051,6 @@ function createWatermarkSurfaceRuntime(getContainer) {
 			});
 			container.appendChild(status);
 		},
-		/** @param {string} message */
 		announce(message) {
 			if (!disposed && status) status.textContent = message;
 		},
@@ -2496,7 +2631,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;
 	}
@@ -2531,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;
@@ -2599,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;
@@ -2621,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;
@@ -2636,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;
@@ -2747,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).
@@ -2788,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;
@@ -2988,7 +3121,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;
 }
 /**
@@ -5358,9 +5491,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;
@@ -5371,10 +5501,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 } : {},
@@ -5664,7 +5794,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);
@@ -6402,7 +6532,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) => {
@@ -8800,9 +8930,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 {
@@ -9695,7 +9826,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;
@@ -10083,7 +10214,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 = () => {
@@ -12277,12 +12408,6 @@ function createSuperDocUI(options) {
 			keys: [...EFFECTIVE_INLINE_UNIFORMITY_KEYS, "highlight"],
 			includeCaret: true
 		} : null);
-		if (effective?.fontFamily?.state === "mixed") {
-			delete inlinePatch.fontFamily;
-			delete inlinePatch.rFonts;
-			mixedInlineKeys.add("fontFamily");
-			mixedInlineKeys.add("rFonts");
-		}
 		for (const [markName, patchKey] of Object.entries(MARK_TO_PATCH)) {
 			const entry = effective?.[markName];
 			if (!entry) continue;
@@ -12294,6 +12419,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;
@@ -13915,7 +14050,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();
@@ -14693,7 +14828,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 {
@@ -15723,12 +15858,24 @@ 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() {
 		return DOM_CLASS_NAMES;
 	}
 });
+Object.defineProperty(exports, "PERMISSIONS", {
+	enumerable: true,
+	get: function() {
+		return PERMISSIONS;
+	}
+});
 Object.defineProperty(exports, "applyV2CommentInvalidationFromMutation", {
 	enumerable: true,
 	get: function() {
@@ -15759,6 +15906,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() {
@@ -15789,6 +15942,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() {

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

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

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

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

package/dist/collaboration-upgrade-engine.cjs

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

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

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

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

@@ -1,6 +1,6 @@
 import { RichContentInsertInput } from '../insert/insert.js';
-import { RichContentReplaceInput, ReplaceMutationOptions } from '../replace/replace.js';
-import { ChangeMode } from '../write/write.js';
+import { 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;
-    };
+    options?: Pick<RichContentMutationOptions, 'changeMode' | 'author' | 'date'> | Pick<TrackedRichContentMutationOptions, 'changeMode' | 'author' | 'date'>;
 } | {
     operation: 'replace';
     input: RichContentReplaceInput;
-    options?: Pick<ReplaceMutationOptions, 'changeMode' | 'replaceMode' | 'expectedSnapshotId'>;
+    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;