superdoc 2.25.0-next.3 → 2.25.0-next.5

package/dist/superdoc.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_rolldown_runtime = require("./chunks/rolldown-runtime-74VwNCz7.cjs");
 const require_blank_docx = require("./chunks/blank-docx-BuFAbRjs.cjs");
-const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-D8ss5E0J.cjs");
+const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-B-A8sK47.cjs");
 const require_eventemitter3 = require("./chunks/eventemitter3-C_TAnXOl.cjs");
 const require_uuid = require("./chunks/uuid-BhG0ngwk.cjs");
 const require__plugin_vue_export_helper = require("./chunks/_plugin-vue_export-helper-BUdjGKyl.cjs");
@@ -304,7 +304,7 @@ var awarenessStatesToArray = (context, states) => {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.25.0-next.3";
+		return "2.25.0-next.5";
 	} catch {
 		return "unknown";
 	}
@@ -7847,6 +7847,7 @@ var useCommentsStore = defineStore("comments", () => {
 	const editorCommentPositions = require__plugin_vue_export_helper.ref({});
 	const isCommentHighlighted = require__plugin_vue_export_helper.ref(false);
 	const floatingCommentsOffset = require__plugin_vue_export_helper.ref(0);
+	const committedReviewPresentations = require__plugin_vue_export_helper.shallowRef({});
 	const sortedConversations = require__plugin_vue_export_helper.ref([]);
 	const visibleConversations = require__plugin_vue_export_helper.ref([]);
 	const skipSelectionUpdate = require__plugin_vue_export_helper.ref(false);
@@ -8862,7 +8863,17 @@ var useCommentsStore = defineStore("comments", () => {
 			resolvedComments: resolvedComments.sort(sorter)
 		};
 	};
-	const buildGroupedComments = (sorter) => buildGroupedCommentsFrom(commentsList.value, sorter);
+	const buildGroupedComments = (sorter) => {
+		const presentations = committedReviewPresentations.value;
+		if (!Object.keys(presentations).length) return buildGroupedCommentsFrom(commentsList.value, sorter);
+		const rows = new Map(commentsList.value.map((row) => [JSON.stringify([String(row.fileId), String(row.commentId)]), row]));
+		const legacy = buildGroupedCommentsFrom(commentsList.value.filter((row) => !presentations[String(row.fileId)]), sorter);
+		for (const [documentId, presentation] of Object.entries(presentations)) {
+			legacy.parentComments.push(...presentation.groupOrder.open.map((id) => rows.get(JSON.stringify([documentId, String(id)]))).filter((row) => row && isThreadVisible(row)));
+			legacy.resolvedComments.push(...presentation.groupOrder.resolved.map((id) => rows.get(JSON.stringify([documentId, String(id)]))).filter((row) => row && isThreadVisible(row)));
+		}
+		return legacy;
+	};
 	/** @type {import('vue').ComputedRef<{parentComments: Array, resolvedComments: Array}>} Comments grouped and sorted by creation time */
 	const getGroupedComments = require__plugin_vue_export_helper.computed(() => buildGroupedComments(compareByCreatedTime));
 	const getGroupedReviewDirectory = require__plugin_vue_export_helper.computed(() => buildGroupedCommentsFrom(reviewDirectoryList.value, compareByCreatedTime));
@@ -9835,7 +9846,7 @@ var useCommentsStore = defineStore("comments", () => {
 	* wraps this action in one Pinia `$patch`; all fallible mapping completes
 	* before either row family mutates.
 	*/
-	const applyReviewWindowFromV2 = ({ superdoc, commentsAdapter, trackedChangesAdapter, documentId, commentItems, trackedChangeItems, requestedCommentIds, requestedTrackedChangeIds, unresolvedCommentIds, trackedList, sourceCoverageRevision, evaluatedRevision, patch } = {}) => withInteractionSpan("store.reviewWindow.apply", "store-reconciliation", {
+	const applyReviewWindowFromV2 = ({ superdoc, commentsAdapter, trackedChangesAdapter, documentId, commentItems, trackedChangeItems, preparedReview, requestedCommentIds, requestedTrackedChangeIds, unresolvedCommentIds, trackedList, sourceCoverageRevision, evaluatedRevision, patch } = {}) => withInteractionSpan("store.reviewWindow.apply", "store-reconciliation", {
 		commentItemCount: Array.isArray(commentItems) ? commentItems.length : null,
 		trackedItemCount: Array.isArray(trackedChangeItems) ? trackedChangeItems.length : null
 	}, () => {
@@ -9861,6 +9872,10 @@ var useCommentsStore = defineStore("comments", () => {
 			ok: false,
 			reason: "document-mismatch"
 		};
+		if (preparedReview && (!Array.isArray(preparedReview.comments) || !Array.isArray(preparedReview.trackedChanges) || preparedReview.comments.length > 4096 || preparedReview.trackedChanges.length > 4096)) return {
+			ok: false,
+			reason: "items-invalid"
+		};
 		if (!Array.isArray(commentItems) || !Array.isArray(trackedChangeItems)) return {
 			ok: false,
 			reason: "items-invalid"
@@ -9874,7 +9889,7 @@ var useCommentsStore = defineStore("comments", () => {
 			reason: "adapter-mapper-missing"
 		};
 		let effectiveCommentItems = commentItems;
-		if (typeof commentsAdapter.seedReviewCatalog === "function") {
+		if (!preparedReview && typeof commentsAdapter.seedReviewCatalog === "function") {
 			const seeded = commentsAdapter.seedReviewCatalog(commentItems, {
 				sourceCoverageRevision,
 				evaluatedRevision
@@ -9890,11 +9905,22 @@ var useCommentsStore = defineStore("comments", () => {
 		let preparedInputs;
 		let preparedParams;
 		try {
-			preparedInputs = effectiveCommentItems.filter((item) => !isSyntheticTrackedChangeCommentLaneItem(item)).map((item) => commentsAdapter.mapV2CommentToUseCommentInput(item, {
+			preparedInputs = preparedReview ? preparedReview.comments.map((input) => ({
+				...input,
+				fileId: normalizedDocumentId,
+				fileType,
+				selection: {
+					...input.selection,
+					documentId: normalizedDocumentId
+				}
+			})) : effectiveCommentItems.filter((item) => !isSyntheticTrackedChangeCommentLaneItem(item)).map((item) => commentsAdapter.mapV2CommentToUseCommentInput(item, {
 				fileId: normalizedDocumentId,
 				fileType
 			})).filter(Boolean);
-			preparedParams = trackedChangeItems.map((item) => trackedChangesAdapter.mapV2TrackedChangeToCommentParams(item)).filter(Boolean);
+			preparedParams = preparedReview ? preparedReview.trackedChanges.map((params) => ({
+				...params,
+				documentId: normalizedDocumentId
+			})) : trackedChangeItems.map((item) => trackedChangesAdapter.mapV2TrackedChangeToCommentParams(item)).filter(Boolean);
 		} catch (error) {
 			return {
 				ok: false,
@@ -9929,6 +9955,10 @@ var useCommentsStore = defineStore("comments", () => {
 			])
 		].map((value) => normalizeCommentId(value)).filter(Boolean));
 		patch(() => {
+			if (preparedReview?.presentation) committedReviewPresentations.value = {
+				...committedReviewPresentations.value,
+				[normalizedDocumentId]: preparedReview.presentation
+			};
 			reconcileTrackedChangesFromV2({
 				superdoc,
 				adapter: trackedChangesAdapter,
@@ -10331,6 +10361,11 @@ var useCommentsStore = defineStore("comments", () => {
 	function removeCommentsForDocument(documentId) {
 		const activeDocumentId = documentId != null ? String(documentId) : null;
 		if (!activeDocumentId) return;
+		if (committedReviewPresentations.value[activeDocumentId]) {
+			const next = { ...committedReviewPresentations.value };
+			delete next[activeDocumentId];
+			committedReviewPresentations.value = next;
+		}
 		cancelImportedTrackedChangeBootstrap(activeDocumentId);
 		const removedComments = commentsList.value.filter((comment) => belongsToDocument(comment, activeDocumentId, { allowSingleDocumentMismatch: true }));
 		if (!removedComments.length) return;
@@ -11990,6 +12025,7 @@ var useCommentsStore = defineStore("comments", () => {
 		hasInitializedLocations,
 		isCommentHighlighted,
 		floatingCommentsOffset,
+		committedReviewPresentations,
 		sortedConversations,
 		visibleConversations,
 		skipSelectionUpdate,
@@ -15258,6 +15294,50 @@ var composeAuthorColorResolver = (config) => {
 	};
 };
 //#endregion
+//#region ../document-api/src/permission-ranges/permission-ranges.ts
+function editorKey(editor) {
+	return editor.id?.trim() ? editor.id : editor.email?.trim() || void 0;
+}
+function editorMatches(editor, id) {
+	return Boolean(id.trim()) && (editor.id === id || Boolean(editor.email?.trim() && editor.email.trim().toLowerCase() === id.toLowerCase()));
+}
+/**
+* Resolve a host ID or imported Word email against an explicitly supplied roster.
+* Word receives the email when available; opaque IDs remain host-specific.
+* Duplicate IDs/emails are ambiguous. This does not authenticate a user.
+*/
+function resolvePermissionRangeEditor(editors, id) {
+	const matches = editors.filter((editor) => editorMatches(editor, id));
+	if (matches.length === 0) return {
+		status: "unknown",
+		id
+	};
+	if (matches.length !== 1) return {
+		status: "ambiguous",
+		id
+	};
+	const editor = matches[0];
+	const wordId = editor.email?.trim() || editor.id;
+	if (editors.filter((candidate) => editorMatches(candidate, wordId)).length !== 1) return {
+		status: "ambiguous",
+		id
+	};
+	return {
+		status: "resolved",
+		id,
+		editor: { ...editor },
+		principal: {
+			kind: "editor",
+			id: wordId
+		}
+	};
+}
+/** Enumerate the host roster for an editor picker, including ambiguous entries. */
+function listPermissionRangeEditors(editors) {
+	const ids = new Set(editors.map(editorKey).filter((id) => id !== void 0));
+	return Array.from(ids, (id) => resolvePermissionRangeEditor(editors, id));
+}
+//#endregion
 //#region src/core/superdoc-ui-owner.js
 var ownerIds = /* @__PURE__ */ new WeakMap();
 function getSuperDocUiOwnerId(superdoc) {
@@ -15379,7 +15459,22 @@ var _sfc_main$31 = {
 		const { clearInstantSidebarAlignment } = commentsStore;
 		const { activeComment, activeFloatingCommentInstanceId, editorCommentPositions, pendingComment, editingCommentId, instantSidebarAlignmentTargetY, instantSidebarAlignmentThreadId, instantSidebarAlignmentInstanceId } = storeToRefs(commentsStore);
 		const { activeZoom } = storeToRefs(superdocStore);
+		const committedPresentation = require__plugin_vue_export_helper.computed(() => commentsStore.committedReviewPresentations?.[String(props.currentDocument?.id)] ?? null);
+		const committedInstances = require__plugin_vue_export_helper.computed(() => {
+			const presentation = committedPresentation.value;
+			if (!presentation) return null;
+			const rows = new Map(commentsStore.commentsList.filter((row) => String(row.fileId) === String(props.currentDocument?.id)).map((row) => [String(row.commentId), row]));
+			return presentation.instances.flatMap((instance) => {
+				const comment = instance.rowId === "pending" ? pendingComment.value : rows.get(instance.rowId);
+				return comment ? [{
+					...instance,
+					comment,
+					rowVersion: presentation.rowVersions[instance.rowId] ?? 0
+				}] : [];
+			});
+		});
 		const floatingCommentInstances = require__plugin_vue_export_helper.computed(() => {
+			if (committedInstances.value) return committedInstances.value.filter((instance) => instance.rowId !== "pending");
 			const currentFloatingCommentInstances = commentsStore.getFloatingCommentInstances;
 			if (!Array.isArray(currentFloatingCommentInstances)) return [];
 			const documentId = props.currentDocument?.id;
@@ -15497,7 +15592,7 @@ var _sfc_main$31 = {
 		const shouldRenderDialog = (position) => {
 			return shouldMountFloatingCommentDialog({
 				id: position?.id,
-				visibleIds: visibleIds.value,
+				visibleIds: committedPresentation.value ? new Set(allPositions.value.filter((item) => item.instanceRef?.mount).map((item) => item.id)) : visibleIds.value,
 				activeCommentInstanceId: activeCommentInstanceId.value,
 				comment: position?.commentRef
 			});
@@ -15543,6 +15638,19 @@ var _sfc_main$31 = {
 		});
 		const allPositions = require__plugin_vue_export_helper.computed(() => {
 			viewportRevision.value;
+			if (committedInstances.value) return committedInstances.value.map((instance) => ({
+				id: instance.id,
+				threadId: instance.threadId,
+				pageIndex: instance.pageIndex,
+				anchorTop: instance.anchorTop,
+				anchorBottom: instance.anchorBottom,
+				top: instance.top,
+				height: instance.height,
+				hasAnchorGeometry: instance.positionEntry != null || instance.rowId === "pending",
+				isOffscreenReviewCard: instance.isOffscreenReviewCard,
+				commentRef: instance.comment,
+				instanceRef: instance
+			}));
 			const positionedInstances = geometryBearingInstances.value;
 			const hasPending = pendingComment.value && pendingComment.value.fileId === props.currentDocument.id;
 			if (!positionedInstances.length && !floatingCommentInstances.value.length && !hasPending) return [];
@@ -15641,6 +15749,43 @@ var _sfc_main$31 = {
 			resolveCollisions(collisionPositions, activeIndex, 15);
 			return positions;
 		});
+		require__plugin_vue_export_helper.watch(() => {
+			const presentation = committedPresentation.value, container = floatingCommentsContainer.value;
+			if (!presentation || !container) return null;
+			viewportRevision.value;
+			const viewport = getFloatingViewportRange();
+			if (!viewport) return null;
+			const rail = container.getBoundingClientRect(), stage = props.parent?.getBoundingClientRect?.();
+			const instances = committedInstances.value ?? [];
+			return {
+				activeThreadId: activeComment.value == null ? null : String(activeComment.value),
+				activeInstanceId: activeCommentInstanceId.value == null ? null : String(activeCommentInstanceId.value),
+				editingRowId: editingCommentId.value == null ? null : String(editingCommentId.value),
+				retainedThreadIds: [],
+				visibility: {
+					comments: commentsStore.viewingVisibility?.documentMode !== "viewing" || commentsStore.viewingVisibility?.commentsVisible === true,
+					trackedChanges: commentsStore.viewingVisibility?.documentMode !== "viewing" || commentsStore.viewingVisibility?.trackChangesVisible === true
+				},
+				viewport: {
+					...viewport,
+					width: Math.max(1, rail.width),
+					scale: 1,
+					stageOffsetX: (stage?.left ?? rail.left) - rail.left,
+					stageOffsetY: (stage?.top ?? rail.top) - rail.top
+				},
+				pending: pendingComment.value?.fileId === props.currentDocument.id && getPendingAnchorTop() != null ? {
+					anchorTop: getPendingAnchorTop(),
+					height: measuredHeights.value.pending || ESTIMATED_HEIGHT
+				} : null,
+				measurements: instances.filter((instance) => measuredHeights.value[instance.id] > 0).map((instance) => ({
+					instanceId: instance.id,
+					rowVersion: instance.rowVersion,
+					height: measuredHeights.value[instance.id]
+				}))
+			};
+		}, (input) => {
+			if (input) committedPresentation.value?.updateContext(input);
+		}, { immediate: true });
 		const wrapperMinHeight = require__plugin_vue_export_helper.computed(() => {
 			viewportRevision.value;
 			return Math.max(0, props.parent?.clientHeight || 0, props.parent?.scrollHeight || 0);
@@ -16156,7 +16301,7 @@ var _sfc_main$31 = {
 			}, [require__plugin_vue_export_helper.createElementVNode("div", {
 				class: "sidebar-container",
 				style: require__plugin_vue_export_helper.normalizeStyle({
-					transform: `translateY(${sidebarOffsetY.value}px)`,
+					transform: `translateY(${committedPresentation.value ? 0 : sidebarOffsetY.value}px)`,
 					transition: disableInstantLayoutTransitions.value ? "none" : void 0
 				})
 			}, [(require__plugin_vue_export_helper.openBlock(true), require__plugin_vue_export_helper.createElementBlock(require__plugin_vue_export_helper.Fragment, null, require__plugin_vue_export_helper.renderList(allPositions.value, (pos) => {
@@ -16199,7 +16344,7 @@ var _sfc_main$31 = {
 		};
 	}
 };
-var FloatingComments_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_vue_export_helper_default(_sfc_main$31, [["__scopeId", "data-v-15b59a51"]]);
+var FloatingComments_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_vue_export_helper_default(_sfc_main$31, [["__scopeId", "data-v-f0b1fd79"]]);
 //#endregion
 //#region src/components/CommentsLayer/PdfCommentsLayer.vue
 var _hoisted_1$23 = {
@@ -22587,6 +22732,7 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 			documentId: ctx?.documentId,
 			commentItems: result?.comments?.items,
 			trackedChangeItems: result?.trackedChanges?.items,
+			preparedReview: result?.preparedReview,
 			requestedCommentIds: result?.comments?.requestedIds,
 			requestedTrackedChangeIds: result?.trackedChanges?.requestedIds,
 			unresolvedCommentIds: result?.comments?.unresolvedCommentIds,
@@ -23705,7 +23851,6 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 			const onFontsResolvedFn = proxy.$superdoc.listeners?.("fonts-resolved")?.length > 0 ? proxy.$superdoc.listeners("fonts-resolved")[0] : null;
 			const useLayoutEngine = proxy.$superdoc.config.useLayoutEngine !== false;
 			const isNewFile = doc.isNewFile;
-			const benchmarkExecutionMode = proxy.$superdoc.config?.benchmarkExecutionMode;
 			const benchmarkTraceEnabled = proxy.$superdoc.config?.benchmarkTraceEnabled === true;
 			const collaborationResolution = resolveDocumentV2Collaboration(doc);
 			const v2Collaboration = collaborationResolution.state === "valid" ? collaborationResolution.config : null;
@@ -23722,7 +23867,6 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 				html: doc.html,
 				markdown: doc.markdown,
 				documentMode: proxy.$superdoc.config.documentMode,
-				...benchmarkExecutionMode ? { benchmarkExecutionMode } : {},
 				...benchmarkTraceEnabled ? { benchmarkTraceEnabled: true } : {},
 				allowSelectionInViewMode: proxy.$superdoc.config.allowSelectionInViewMode,
 				rulers: doc.rulers,
@@ -24834,7 +24978,7 @@ var SuperDoc_default = /*#__PURE__*/ require__plugin_vue_export_helper._plugin_v
 			], 46, _hoisted_1$17);
 		};
 	}
-}, [["__scopeId", "data-v-e8f59dd7"]]);
+}, [["__scopeId", "data-v-c57da6ae"]]);
 //#endregion
 //#region src/core/create-app.js
 var PINIA_DEVTOOLS_SETUP_EVENT = "devtools-plugin:setup";
@@ -46424,6 +46568,8 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		return this.#surfacesConfig;
 	}
 	#surfaceManager;
+	#sourceLifecycleReady;
+	#pendingSourceLifecycle;
 	/**
 	* SuperDoc-owned editor runtime registry. This is the internal place to ask
 	* which mounted editor runtime is active and which runtime owns a DOM event
@@ -46496,6 +46642,8 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		this.whiteboard = null;
 		this.colors = [];
 		this.readyEditors = 0;
+		this.#sourceLifecycleReady = false;
+		this.#pendingSourceLifecycle = [];
 		this.#editorRuntimeRegistry = new EditorRuntimeRegistry();
 		this.#editorRuntimeRegistryUnsub = null;
 		this.#applyingRuntimeActiveChange = false;
@@ -46649,7 +46797,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		}
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.25.0-next.3";
+		this.version = "2.25.0-next.5";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4();
 		this.colors = this.config.colors ?? [];
@@ -46686,6 +46834,8 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 	* Mount the Vue app, stores, and editor runtime.
 	*/
 	#startRuntime() {
+		this.#sourceLifecycleReady = false;
+		this.#pendingSourceLifecycle = [];
 		this.#initVueApp();
 		this.readyEditors = 0;
 		if (!this.app) throw new Error("SuperDoc: #startRuntime called before #initVueApp populated this.app");
@@ -47721,7 +47871,13 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 	* Triggered when the superdoc is ready
 	*/
 	broadcastReady() {
-		if (this.readyEditors === this.requiredNumberOfEditors) this.emit("ready", { superdoc: this });
+		if (this.#destroyed) return;
+		if (this.readyEditors === this.requiredNumberOfEditors) {
+			this.emit("ready", { superdoc: this });
+			if (this.#destroyed) return;
+			this.#sourceLifecycleReady = true;
+			for (const type of this.#pendingSourceLifecycle.splice(0)) this.emit(type);
+		}
 	}
 	/**
 	* Triggered before an editor is created
@@ -47740,11 +47896,19 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		this.#wireFontsChangedRelay(editor);
 		this.emit("editorCreate", { editor: createDeprecatedEditorProxy(editor) });
 	}
+	#broadcastSourceLifecycle(type) {
+		if (this.#destroyed) return;
+		if (!this.#sourceLifecycleReady) {
+			this.#pendingSourceLifecycle.push(type);
+			return;
+		}
+		this.emit(type);
+	}
 	broadcastSourceComplete() {
-		this.emit("source:complete");
+		this.#broadcastSourceLifecycle("source:complete");
 	}
 	broadcastSourceSignalsComplete() {
-		this.emit("source:signals-complete");
+		this.#broadcastSourceLifecycle("source:signals-complete");
 	}
 	/** Editors whose `fonts-changed` we already relay, so a repeated create wires once. */
 	#fontsRelayEditors;
@@ -49006,6 +49170,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 	destroy() {
 		require_create_super_doc_ui.closeInteractionHistory(this);
 		this.#destroyed = true;
+		this.#pendingSourceLifecycle = [];
 		this.#contentControlClickRoot?.removeEventListener("click", this.#handleContentControlClick, true);
 		this.#contentControlClickRoot?.removeEventListener("pointerdown", this.#handleContentControlPointerDown, true);
 		this.#contentControlClickRoot?.ownerDocument.removeEventListener("pointerup", this.#handleContentControlPointerEnd, true);
@@ -49243,3 +49408,5 @@ exports.compareVersions = compareVersions;
 exports.createTheme = createTheme;
 exports.defineSuperDocExtension = defineSuperDocExtension;
 exports.getFileObject = getFileObject;
+exports.listPermissionRangeEditors = listPermissionRangeEditors;
+exports.resolvePermissionRangeEditor = resolvePermissionRangeEditor;