superdoc 2.4.0-next.61 → 2.4.0-next.63

package/dist/chunks/{create-super-doc-ui-DNtHxzz_.cjs → create-super-doc-ui-Bom7oDPv.cjs}

@@ -1874,6 +1874,23 @@ INLINE_PROPERTY_REGISTRY.filter((entry) => entry.storage === "mark").map((entry)
 * `false` when the surface is unavailable (view mode, a pre-ready editor, or a
 * host that has not exposed a Document API facade) rather than throwing.
 */
+function uiBenchNowMs() {
+	return typeof performance !== "undefined" && typeof performance.now === "function" ? performance.now() : Date.now();
+}
+function readUiBenchRuntime() {
+	const benchGlobal = globalThis;
+	return {
+		sink: typeof benchGlobal.__superdocV2BenchPipelineTiming === "function" ? benchGlobal.__superdocV2BenchPipelineTiming : null,
+		workerContext: benchGlobal.__superdocV2BenchWorkerMessageContext ?? null
+	};
+}
+function emitUiBenchTiming(event) {
+	const { sink } = readUiBenchRuntime();
+	if (!sink) return;
+	try {
+		sink(event);
+	} catch {}
+}
 var sharedUiTrackedChangesCatalogByHost = /* @__PURE__ */ new WeakMap();
 function acquireSharedUiTrackedChangesCatalog(host) {
 	let state = sharedUiTrackedChangesCatalogByHost.get(host);
@@ -3716,12 +3733,13 @@ function createSuperDocUI(options) {
 	let foregroundAsyncRetryTimer = null;
 	let pendingSelectionSeedValidationToken = null;
 	let typingContentInvalidationTimer = null;
+	const pendingAsyncReadSettlements = [];
 	const scheduleAsyncRefresh = () => {
 		if (asyncRefreshScheduled || disposed) return;
 		asyncRefreshScheduled = true;
 		const run = () => {
 			asyncRefreshScheduled = false;
-			if (!disposed) recompute();
+			if (!disposed) recompute("async-read-settled");
 		};
 		if (typeof queueMicrotask === "function") queueMicrotask(run);
 		else Promise.resolve().then(run);
@@ -4275,6 +4293,24 @@ function createSuperDocUI(options) {
 				failureCount: 0,
 				retryAtMs: 0
 			});
+			const { sink, workerContext } = readUiBenchRuntime();
+			if (sink) {
+				const settledAtMs = uiBenchNowMs();
+				pendingAsyncReadSettlements.push({
+					key,
+					settledAtMs,
+					commandId: workerContext?.commandId ?? null,
+					commandKind: workerContext?.commandKind ?? null
+				});
+				emitUiBenchTiming({
+					stage: "superdoc-ui-async-read-settled",
+					atMs: settledAtMs,
+					key,
+					settledAtMs,
+					commandId: workerContext?.commandId ?? null,
+					commandKind: workerContext?.commandKind ?? null
+				});
+			}
 			scheduleAsyncRefresh();
 		}, () => {
 			const entry = asyncReads.get(key);
@@ -6535,31 +6571,57 @@ function createSuperDocUI(options) {
 			diagnostics
 		};
 	};
-	const computeState = () => {
-		const documentMode = readDocumentMode();
-		const selection = computeSelection();
+	const computeState = (reason = "direct") => {
+		const { sink } = readUiBenchRuntime();
+		const startedAtMs = sink ? uiBenchNowMs() : 0;
+		const phaseMs = {};
+		const measure = (phase, run) => {
+			if (!sink) return run();
+			const phaseStartedAtMs = uiBenchNowMs();
+			try {
+				return run();
+			} finally {
+				phaseMs[phase] = uiBenchNowMs() - phaseStartedAtMs;
+			}
+		};
+		const documentMode = measure("documentMode", readDocumentMode);
+		const selection = measure("selection", computeSelection);
 		if (selection.status === "ready") pruneSelectionScopedAsyncReads(selection);
 		reconcilePendingInlineFormat(selection);
 		const selectionSignature = selectionInlineValueSignature(selection);
 		for (const [commandId, optimistic] of optimisticInlineToggles) if (!selectionSignature || optimistic.selectionSignature !== selectionSignature) optimisticInlineToggles.delete(commandId);
 		else if (optimistic.settled && selection.status === "ready") optimisticInlineToggles.delete(commandId);
-		return {
+		const nextState = {
 			ready: getEditor() != null,
 			documentMode,
-			document: computeDocument(),
+			document: measure("document", computeDocument),
 			selection,
 			toolbar: {
 				context: documentMode,
-				commands: computeCommandStates(selection),
+				commands: measure("toolbarCommands", () => computeCommandStates(selection)),
 				copyFormatActive: painter.mode !== "idle"
 			},
-			comments: computeComments(selection),
-			trackChanges: computeTrackChanges(selection),
-			contentControls: computeContentControls(selection),
-			zoom: computeZoom(),
-			fonts: computeFonts(),
-			styles: computeStyles(selection)
-		};
+			comments: measure("comments", () => computeComments(selection)),
+			trackChanges: measure("trackChanges", () => computeTrackChanges(selection)),
+			contentControls: measure("contentControls", () => computeContentControls(selection)),
+			zoom: measure("zoom", computeZoom),
+			fonts: measure("fonts", computeFonts),
+			styles: measure("styles", () => computeStyles(selection))
+		};
+		if (sink) {
+			const completedAtMs = uiBenchNowMs();
+			emitUiBenchTiming({
+				stage: "superdoc-ui-compute-state",
+				atMs: completedAtMs,
+				reason,
+				startedAtMs,
+				completedAtMs,
+				durationMs: completedAtMs - startedAtMs,
+				phaseMs,
+				asyncReadSettlements: pendingAsyncReadSettlements.splice(0)
+			});
+		}
+		return nextState;
 	};
 	const syncOptimisticInlineSelection = (selection) => {
 		const nextSignature = selectionInlineValueSignature(selection);
@@ -6644,7 +6706,7 @@ function createSuperDocUI(options) {
 			const unsubscribe = next.subscribe((snapshot) => {
 				selectionEpoch += 1;
 				seedCaretSelectionFromHost(snapshot);
-				recompute();
+				recompute("host-selection");
 			});
 			if (typeof unsubscribe === "function") detachHostSelection = unsubscribe;
 		} catch {
@@ -6752,7 +6814,7 @@ function createSuperDocUI(options) {
 	};
 	syncCoordinatorEditor();
 	syncTrackedChangeFocusFromHostReviewTarget(readHostActiveReviewTarget(readHostReviewSource()));
-	state = computeState();
+	state = computeState("initial");
 	lastOptimisticInlineSelectionSignature = selectionInlineValueSignature(state.selection);
 	const syncHostEventsSubscription = () => {
 		const events = (getEditor()?.host)?.events;
@@ -6820,8 +6882,10 @@ function createSuperDocUI(options) {
 			currentHostEventsSource = null;
 		}
 	};
-	const recompute = () => {
+	const recompute = (reason = "unspecified") => {
 		if (disposed) return;
+		const { sink } = readUiBenchRuntime();
+		const startedAtMs = sink ? uiBenchNowMs() : 0;
 		editCommandsRecomputeQueued = false;
 		syncCoordinatorEditor();
 		syncHostSelectionSubscription();
@@ -6830,10 +6894,36 @@ function createSuperDocUI(options) {
 		syncHostReviewSubscription();
 		syncDocumentSelectionFallbackSubscription();
 		syncHostEventsSubscription();
-		const nextState = computeState();
+		const nextState = computeState(reason);
 		syncOptimisticInlineSelection(nextState.selection);
 		state = nextState;
-		for (const listener of [...listeners]) listener(state);
+		let listenerTotalMs = 0;
+		let listenerMaxMs = 0;
+		for (const listener of [...listeners]) {
+			if (!sink) {
+				listener(state);
+				continue;
+			}
+			const listenerStartedAtMs = uiBenchNowMs();
+			listener(state);
+			const listenerMs = uiBenchNowMs() - listenerStartedAtMs;
+			listenerTotalMs += listenerMs;
+			listenerMaxMs = Math.max(listenerMaxMs, listenerMs);
+		}
+		if (sink) {
+			const completedAtMs = uiBenchNowMs();
+			emitUiBenchTiming({
+				stage: "superdoc-ui-recompute",
+				atMs: completedAtMs,
+				reason,
+				startedAtMs,
+				completedAtMs,
+				durationMs: completedAtMs - startedAtMs,
+				listenerCount: listeners.size,
+				listenerTotalMs,
+				listenerMaxMs
+			});
+		}
 	};
 	/**
 	* Work that is bound to one specific active editor and cannot survive a swap.
@@ -7423,7 +7513,7 @@ function createSuperDocUI(options) {
 		if (options && options.success === false) return options;
 		if (!selection.selectionTarget) return options ? op(input, options) : op(input);
 		return op(input, {
-			...options ?? {},
+			...options,
 			offsetSpace: "selection"
 		});
 	};

package/dist/chunks/{create-super-doc-ui-B_1l545i.es.js → create-super-doc-ui-DbzVC0rr.es.js}

@@ -1874,6 +1874,23 @@ INLINE_PROPERTY_REGISTRY.filter((entry) => entry.storage === "mark").map((entry)
 * `false` when the surface is unavailable (view mode, a pre-ready editor, or a
 * host that has not exposed a Document API facade) rather than throwing.
 */
+function uiBenchNowMs() {
+	return typeof performance !== "undefined" && typeof performance.now === "function" ? performance.now() : Date.now();
+}
+function readUiBenchRuntime() {
+	const benchGlobal = globalThis;
+	return {
+		sink: typeof benchGlobal.__superdocV2BenchPipelineTiming === "function" ? benchGlobal.__superdocV2BenchPipelineTiming : null,
+		workerContext: benchGlobal.__superdocV2BenchWorkerMessageContext ?? null
+	};
+}
+function emitUiBenchTiming(event) {
+	const { sink } = readUiBenchRuntime();
+	if (!sink) return;
+	try {
+		sink(event);
+	} catch {}
+}
 var sharedUiTrackedChangesCatalogByHost = /* @__PURE__ */ new WeakMap();
 function acquireSharedUiTrackedChangesCatalog(host) {
 	let state = sharedUiTrackedChangesCatalogByHost.get(host);
@@ -3716,12 +3733,13 @@ function createSuperDocUI(options) {
 	let foregroundAsyncRetryTimer = null;
 	let pendingSelectionSeedValidationToken = null;
 	let typingContentInvalidationTimer = null;
+	const pendingAsyncReadSettlements = [];
 	const scheduleAsyncRefresh = () => {
 		if (asyncRefreshScheduled || disposed) return;
 		asyncRefreshScheduled = true;
 		const run = () => {
 			asyncRefreshScheduled = false;
-			if (!disposed) recompute();
+			if (!disposed) recompute("async-read-settled");
 		};
 		if (typeof queueMicrotask === "function") queueMicrotask(run);
 		else Promise.resolve().then(run);
@@ -4275,6 +4293,24 @@ function createSuperDocUI(options) {
 				failureCount: 0,
 				retryAtMs: 0
 			});
+			const { sink, workerContext } = readUiBenchRuntime();
+			if (sink) {
+				const settledAtMs = uiBenchNowMs();
+				pendingAsyncReadSettlements.push({
+					key,
+					settledAtMs,
+					commandId: workerContext?.commandId ?? null,
+					commandKind: workerContext?.commandKind ?? null
+				});
+				emitUiBenchTiming({
+					stage: "superdoc-ui-async-read-settled",
+					atMs: settledAtMs,
+					key,
+					settledAtMs,
+					commandId: workerContext?.commandId ?? null,
+					commandKind: workerContext?.commandKind ?? null
+				});
+			}
 			scheduleAsyncRefresh();
 		}, () => {
 			const entry = asyncReads.get(key);
@@ -6535,31 +6571,57 @@ function createSuperDocUI(options) {
 			diagnostics
 		};
 	};
-	const computeState = () => {
-		const documentMode = readDocumentMode();
-		const selection = computeSelection();
+	const computeState = (reason = "direct") => {
+		const { sink } = readUiBenchRuntime();
+		const startedAtMs = sink ? uiBenchNowMs() : 0;
+		const phaseMs = {};
+		const measure = (phase, run) => {
+			if (!sink) return run();
+			const phaseStartedAtMs = uiBenchNowMs();
+			try {
+				return run();
+			} finally {
+				phaseMs[phase] = uiBenchNowMs() - phaseStartedAtMs;
+			}
+		};
+		const documentMode = measure("documentMode", readDocumentMode);
+		const selection = measure("selection", computeSelection);
 		if (selection.status === "ready") pruneSelectionScopedAsyncReads(selection);
 		reconcilePendingInlineFormat(selection);
 		const selectionSignature = selectionInlineValueSignature(selection);
 		for (const [commandId, optimistic] of optimisticInlineToggles) if (!selectionSignature || optimistic.selectionSignature !== selectionSignature) optimisticInlineToggles.delete(commandId);
 		else if (optimistic.settled && selection.status === "ready") optimisticInlineToggles.delete(commandId);
-		return {
+		const nextState = {
 			ready: getEditor() != null,
 			documentMode,
-			document: computeDocument(),
+			document: measure("document", computeDocument),
 			selection,
 			toolbar: {
 				context: documentMode,
-				commands: computeCommandStates(selection),
+				commands: measure("toolbarCommands", () => computeCommandStates(selection)),
 				copyFormatActive: painter.mode !== "idle"
 			},
-			comments: computeComments(selection),
-			trackChanges: computeTrackChanges(selection),
-			contentControls: computeContentControls(selection),
-			zoom: computeZoom(),
-			fonts: computeFonts(),
-			styles: computeStyles(selection)
-		};
+			comments: measure("comments", () => computeComments(selection)),
+			trackChanges: measure("trackChanges", () => computeTrackChanges(selection)),
+			contentControls: measure("contentControls", () => computeContentControls(selection)),
+			zoom: measure("zoom", computeZoom),
+			fonts: measure("fonts", computeFonts),
+			styles: measure("styles", () => computeStyles(selection))
+		};
+		if (sink) {
+			const completedAtMs = uiBenchNowMs();
+			emitUiBenchTiming({
+				stage: "superdoc-ui-compute-state",
+				atMs: completedAtMs,
+				reason,
+				startedAtMs,
+				completedAtMs,
+				durationMs: completedAtMs - startedAtMs,
+				phaseMs,
+				asyncReadSettlements: pendingAsyncReadSettlements.splice(0)
+			});
+		}
+		return nextState;
 	};
 	const syncOptimisticInlineSelection = (selection) => {
 		const nextSignature = selectionInlineValueSignature(selection);
@@ -6644,7 +6706,7 @@ function createSuperDocUI(options) {
 			const unsubscribe = next.subscribe((snapshot) => {
 				selectionEpoch += 1;
 				seedCaretSelectionFromHost(snapshot);
-				recompute();
+				recompute("host-selection");
 			});
 			if (typeof unsubscribe === "function") detachHostSelection = unsubscribe;
 		} catch {
@@ -6752,7 +6814,7 @@ function createSuperDocUI(options) {
 	};
 	syncCoordinatorEditor();
 	syncTrackedChangeFocusFromHostReviewTarget(readHostActiveReviewTarget(readHostReviewSource()));
-	state = computeState();
+	state = computeState("initial");
 	lastOptimisticInlineSelectionSignature = selectionInlineValueSignature(state.selection);
 	const syncHostEventsSubscription = () => {
 		const events = (getEditor()?.host)?.events;
@@ -6820,8 +6882,10 @@ function createSuperDocUI(options) {
 			currentHostEventsSource = null;
 		}
 	};
-	const recompute = () => {
+	const recompute = (reason = "unspecified") => {
 		if (disposed) return;
+		const { sink } = readUiBenchRuntime();
+		const startedAtMs = sink ? uiBenchNowMs() : 0;
 		editCommandsRecomputeQueued = false;
 		syncCoordinatorEditor();
 		syncHostSelectionSubscription();
@@ -6830,10 +6894,36 @@ function createSuperDocUI(options) {
 		syncHostReviewSubscription();
 		syncDocumentSelectionFallbackSubscription();
 		syncHostEventsSubscription();
-		const nextState = computeState();
+		const nextState = computeState(reason);
 		syncOptimisticInlineSelection(nextState.selection);
 		state = nextState;
-		for (const listener of [...listeners]) listener(state);
+		let listenerTotalMs = 0;
+		let listenerMaxMs = 0;
+		for (const listener of [...listeners]) {
+			if (!sink) {
+				listener(state);
+				continue;
+			}
+			const listenerStartedAtMs = uiBenchNowMs();
+			listener(state);
+			const listenerMs = uiBenchNowMs() - listenerStartedAtMs;
+			listenerTotalMs += listenerMs;
+			listenerMaxMs = Math.max(listenerMaxMs, listenerMs);
+		}
+		if (sink) {
+			const completedAtMs = uiBenchNowMs();
+			emitUiBenchTiming({
+				stage: "superdoc-ui-recompute",
+				atMs: completedAtMs,
+				reason,
+				startedAtMs,
+				completedAtMs,
+				durationMs: completedAtMs - startedAtMs,
+				listenerCount: listeners.size,
+				listenerTotalMs,
+				listenerMaxMs
+			});
+		}
 	};
 	/**
 	* Work that is bound to one specific active editor and cannot survive a swap.
@@ -7423,7 +7513,7 @@ function createSuperDocUI(options) {
 		if (options && options.success === false) return options;
 		if (!selection.selectionTarget) return options ? op(input, options) : op(input);
 		return op(input, {
-			...options ?? {},
+			...options,
 			offsetSpace: "selection"
 		});
 	};

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.4.0-next.61",
+	superdocVersion: "2.4.0-next.63",
 	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.4.0-next.61",
+	superdocVersion: "2.4.0-next.63",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/public/ui-react.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-DNtHxzz_.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-Bom7oDPv.cjs");
 let react = require("react");
 //#region src/public/ui/react.ts
 /**

package/dist/public/ui-react.es.js

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-B_1l545i.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-DbzVC0rr.es.js";
 import { createContext, createElement, useCallback, useContext, useEffect, useRef, useState } from "react";
 //#region src/public/ui/react.ts
 /**

package/dist/public/ui.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-DNtHxzz_.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-Bom7oDPv.cjs");
 exports.BUILT_IN_COMMAND_IDS = require_create_super_doc_ui.BUILT_IN_COMMAND_IDS;
 exports.createSuperDocUI = require_create_super_doc_ui.createSuperDocUI;
 exports.shallowEqual = require_create_super_doc_ui.shallowEqual;

package/dist/public/ui.es.js

@@ -1,2 +1,2 @@
-import { n as shallowEqual, r as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-B_1l545i.es.js";
+import { n as shallowEqual, r as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-DbzVC0rr.es.js";
 export { BUILT_IN_COMMAND_IDS, createSuperDocUI, shallowEqual };

package/dist/superdoc.cjs

@@ -4,7 +4,7 @@ const require_blank_docx = require("./chunks/blank-docx-BuFAbRjs.cjs");
 const require_eventemitter3 = require("./chunks/eventemitter3-D38u8ta_.cjs");
 const require_uuid = require("./chunks/uuid-BhG0ngwk.cjs");
 const require_jszip = require("./chunks/jszip-RC64TPzL.cjs");
-const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-DNtHxzz_.cjs");
+const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-Bom7oDPv.cjs");
 const require__plugin_vue_export_helper = require("./chunks/_plugin-vue_export-helper-SDR04tiH.cjs");
 const require_constants = require("./chunks/constants-DpXuDx_g.cjs");
 let vue = require("vue");
@@ -43261,7 +43261,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 		this.config.colors = shuffleArray(this.config.colors);
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.4.0-next.61";
+		this.version = "2.4.0-next.63";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4();
 		this.colors = this.config.colors ?? [];

package/dist/superdoc.es.js

@@ -3,7 +3,7 @@ import { t as blank_default } from "./chunks/blank-docx-DzQccOlW.es.js";
 import { t as import_eventemitter3 } from "./chunks/eventemitter3-CMOjDs74.es.js";
 import { t as v4 } from "./chunks/uuid-H0Xcmmhy.es.js";
 import { a as init_dist$1, i as global, n as init_dist$2, o as Buffer, r as process$1, s as init_dist, t as require_jszip_min } from "./chunks/jszip-VxCFV9YS.es.js";
-import { a as DOM_CLASS_NAMES, i as getV2TrackedChangeMutationImpact, t as createSuperDocUI } from "./chunks/create-super-doc-ui-B_1l545i.es.js";
+import { a as DOM_CLASS_NAMES, i as getV2TrackedChangeMutationImpact, t as createSuperDocUI } from "./chunks/create-super-doc-ui-DbzVC0rr.es.js";
 import { t as _plugin_vue_export_helper_default } from "./chunks/_plugin-vue_export-helper-BOaGB7Aw.es.js";
 import { t as PDF_TO_CSS_UNITS } from "./chunks/constants-B6VBlmKp.es.js";
 import * as Vue from "vue";
@@ -43194,7 +43194,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 		this.config.colors = shuffleArray(this.config.colors);
 		this.userColorMap = /* @__PURE__ */ new Map();
 		this.colorIndex = 0;
-		this.version = "2.4.0-next.61";
+		this.version = "2.4.0-next.63";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4();
 		this.colors = this.config.colors ?? [];