superdoc 2.12.0-next.14 → 2.12.0-next.15

package/dist/chunks/{create-super-doc-ui-D3_JSfLV.es.js → create-super-doc-ui-Biwv0tas.es.js}

@@ -4071,8 +4071,11 @@ function createSuperDocUI(options) {
 	const incompleteTrackChangesDirectoryReadTokens = /* @__PURE__ */ new Map();
 	const postSourceCompletionRefreshTokens = /* @__PURE__ */ new Map();
 	let sourceCompletionObservedToken = null;
-	let commentsDirectoryLeaseCount = 0;
-	let trackChangesDirectoryLeaseCount = 0;
+	const directoryLeaseCounts = {
+		comments: 0,
+		trackChanges: 0,
+		contentControls: 0
+	};
 	const demandHeavyDocRead = (key) => {
 		const token = contentToken();
 		if (demandedHeavyReads.get(key) === token) return;
@@ -4107,16 +4110,14 @@ function createSuperDocUI(options) {
 		if (invalidated) scheduleAsyncRefresh();
 	};
 	const acquireDirectoryLease = (family) => {
-		if (family === "comments") commentsDirectoryLeaseCount += 1;
-		else trackChangesDirectoryLeaseCount += 1;
+		directoryLeaseCounts[family] += 1;
 		demandHeavyDocRead(family);
 		let released = false;
 		return () => {
 			if (released) return;
 			released = true;
-			if (family === "comments") commentsDirectoryLeaseCount = Math.max(0, commentsDirectoryLeaseCount - 1);
-			else trackChangesDirectoryLeaseCount = Math.max(0, trackChangesDirectoryLeaseCount - 1);
-			if ((family === "comments" ? commentsDirectoryLeaseCount : trackChangesDirectoryLeaseCount) === 0 && demandedHeavyReads.get(family) === contentToken()) demandedHeavyReads.delete(family);
+			directoryLeaseCounts[family] = Math.max(0, directoryLeaseCounts[family] - 1);
+			if (directoryLeaseCounts[family] === 0 && demandedHeavyReads.get(family) === contentToken()) demandedHeavyReads.delete(family);
 			scheduleAsyncRefresh();
 		};
 	};
@@ -4887,7 +4888,7 @@ function createSuperDocUI(options) {
 		const activeIds = selection.activeCommentIds;
 		const directory = asyncReads.get("comments");
 		const directoryItems = directory?.token === contentToken() && directory.hasSettled && Array.isArray(directory.value) ? directory.value : null;
-		const activeValidationItems = commentsDirectoryLeaseCount > 0 ? directoryItems : items;
+		const activeValidationItems = directoryLeaseCounts.comments > 0 ? directoryItems : items;
 		if (explicitActiveCommentId && activeValidationItems && !activeValidationItems.some((item) => readEntityId(item) === explicitActiveCommentId)) explicitActiveCommentId = null;
 		const activeId = explicitActiveCommentId ?? activeIds[0] ?? null;
 		return {
@@ -4962,7 +4963,7 @@ function createSuperDocUI(options) {
 		if (active && !pendingTrackChangeRevealFocuses.has(active)) {
 			const directory = asyncReads.get("trackChanges");
 			const directoryItems = directory?.token === token && directory.hasSettled && Array.isArray(directory.value) ? filterPostDecisionTrackChanges(projectTrackChangesItems(directory.value), postDecisionIds) : null;
-			const activeValidationItems = trackChangesDirectoryLeaseCount > 0 ? directoryItems : active.story ? allStoryItems : items;
+			const activeValidationItems = directoryLeaseCounts.trackChanges > 0 ? directoryItems : active.story ? allStoryItems : items;
 			if (activeValidationItems && !activeValidationItems.some((row) => entityRowMatchesRequest(row, active.id, active.story))) setExplicitActiveChange(null);
 		}
 		const publicIdItems = allStoryItems ?? items;
@@ -9742,12 +9743,16 @@ function createSuperDocUI(options) {
 	const findContentControl = (id) => {
 		return contentControlsSub.get().items.find((item) => item?.id === id) ?? null;
 	};
-	const contentControlsSnap = snapshotHandle(contentControlsSub);
+	const contentControlsSnap = directorySnapshotHandle(contentControlsSub, select((s) => {
+		if (directoryLeaseCounts.contentControls > 0) demandHeavyDocRead("contentControls");
+		return s.contentControls;
+	}), "contentControls");
 	const contentControlsGet = ((input) => {
 		if (input === void 0) return contentControlsSnap.get();
 		const id = readContentControlRequestId(input);
 		return id ? findContentControl(id) : null;
 	});
+	const contentControlsPassiveSnap = snapshotHandle(contentControlsSub);
 	const contentControls = {
 		get: ((input) => {
 			if (input !== void 0) ensureContentControlsCatalog("api");
@@ -9756,6 +9761,7 @@ function createSuperDocUI(options) {
 		getSnapshot: contentControlsSnap.getSnapshot,
 		subscribe: contentControlsSnap.subscribe,
 		observe: contentControlsSnap.observe,
+		observeActivePath: contentControlsPassiveSnap.observe,
 		list: () => {
 			ensureContentControlsCatalog("api");
 			return contentControlsSub.get().items;
@@ -10859,8 +10865,7 @@ function createSuperDocUI(options) {
 		if (detachSourceLoading) detachSourceLoading();
 		detachSourceLoading = null;
 		sourceLoadingSubscriptionHost = null;
-		commentsDirectoryLeaseCount = 0;
-		trackChangesDirectoryLeaseCount = 0;
+		for (const family of Object.keys(directoryLeaseCounts)) directoryLeaseCounts[family] = 0;
 		demandedHeavyReads.clear();
 		incompleteTrackChangesDirectoryReadTokens.clear();
 		postSourceCompletionRefreshTokens.clear();

package/dist/chunks/{create-super-doc-ui-D8QSZN4i.cjs → create-super-doc-ui-BkDVQgqj.cjs}

@@ -4071,8 +4071,11 @@ function createSuperDocUI(options) {
 	const incompleteTrackChangesDirectoryReadTokens = /* @__PURE__ */ new Map();
 	const postSourceCompletionRefreshTokens = /* @__PURE__ */ new Map();
 	let sourceCompletionObservedToken = null;
-	let commentsDirectoryLeaseCount = 0;
-	let trackChangesDirectoryLeaseCount = 0;
+	const directoryLeaseCounts = {
+		comments: 0,
+		trackChanges: 0,
+		contentControls: 0
+	};
 	const demandHeavyDocRead = (key) => {
 		const token = contentToken();
 		if (demandedHeavyReads.get(key) === token) return;
@@ -4107,16 +4110,14 @@ function createSuperDocUI(options) {
 		if (invalidated) scheduleAsyncRefresh();
 	};
 	const acquireDirectoryLease = (family) => {
-		if (family === "comments") commentsDirectoryLeaseCount += 1;
-		else trackChangesDirectoryLeaseCount += 1;
+		directoryLeaseCounts[family] += 1;
 		demandHeavyDocRead(family);
 		let released = false;
 		return () => {
 			if (released) return;
 			released = true;
-			if (family === "comments") commentsDirectoryLeaseCount = Math.max(0, commentsDirectoryLeaseCount - 1);
-			else trackChangesDirectoryLeaseCount = Math.max(0, trackChangesDirectoryLeaseCount - 1);
-			if ((family === "comments" ? commentsDirectoryLeaseCount : trackChangesDirectoryLeaseCount) === 0 && demandedHeavyReads.get(family) === contentToken()) demandedHeavyReads.delete(family);
+			directoryLeaseCounts[family] = Math.max(0, directoryLeaseCounts[family] - 1);
+			if (directoryLeaseCounts[family] === 0 && demandedHeavyReads.get(family) === contentToken()) demandedHeavyReads.delete(family);
 			scheduleAsyncRefresh();
 		};
 	};
@@ -4887,7 +4888,7 @@ function createSuperDocUI(options) {
 		const activeIds = selection.activeCommentIds;
 		const directory = asyncReads.get("comments");
 		const directoryItems = directory?.token === contentToken() && directory.hasSettled && Array.isArray(directory.value) ? directory.value : null;
-		const activeValidationItems = commentsDirectoryLeaseCount > 0 ? directoryItems : items;
+		const activeValidationItems = directoryLeaseCounts.comments > 0 ? directoryItems : items;
 		if (explicitActiveCommentId && activeValidationItems && !activeValidationItems.some((item) => readEntityId(item) === explicitActiveCommentId)) explicitActiveCommentId = null;
 		const activeId = explicitActiveCommentId ?? activeIds[0] ?? null;
 		return {
@@ -4962,7 +4963,7 @@ function createSuperDocUI(options) {
 		if (active && !pendingTrackChangeRevealFocuses.has(active)) {
 			const directory = asyncReads.get("trackChanges");
 			const directoryItems = directory?.token === token && directory.hasSettled && Array.isArray(directory.value) ? filterPostDecisionTrackChanges(projectTrackChangesItems(directory.value), postDecisionIds) : null;
-			const activeValidationItems = trackChangesDirectoryLeaseCount > 0 ? directoryItems : active.story ? allStoryItems : items;
+			const activeValidationItems = directoryLeaseCounts.trackChanges > 0 ? directoryItems : active.story ? allStoryItems : items;
 			if (activeValidationItems && !activeValidationItems.some((row) => entityRowMatchesRequest(row, active.id, active.story))) setExplicitActiveChange(null);
 		}
 		const publicIdItems = allStoryItems ?? items;
@@ -9742,12 +9743,16 @@ function createSuperDocUI(options) {
 	const findContentControl = (id) => {
 		return contentControlsSub.get().items.find((item) => item?.id === id) ?? null;
 	};
-	const contentControlsSnap = snapshotHandle(contentControlsSub);
+	const contentControlsSnap = directorySnapshotHandle(contentControlsSub, select((s) => {
+		if (directoryLeaseCounts.contentControls > 0) demandHeavyDocRead("contentControls");
+		return s.contentControls;
+	}), "contentControls");
 	const contentControlsGet = ((input) => {
 		if (input === void 0) return contentControlsSnap.get();
 		const id = readContentControlRequestId(input);
 		return id ? findContentControl(id) : null;
 	});
+	const contentControlsPassiveSnap = snapshotHandle(contentControlsSub);
 	const contentControls = {
 		get: ((input) => {
 			if (input !== void 0) ensureContentControlsCatalog("api");
@@ -9756,6 +9761,7 @@ function createSuperDocUI(options) {
 		getSnapshot: contentControlsSnap.getSnapshot,
 		subscribe: contentControlsSnap.subscribe,
 		observe: contentControlsSnap.observe,
+		observeActivePath: contentControlsPassiveSnap.observe,
 		list: () => {
 			ensureContentControlsCatalog("api");
 			return contentControlsSub.get().items;
@@ -10859,8 +10865,7 @@ function createSuperDocUI(options) {
 		if (detachSourceLoading) detachSourceLoading();
 		detachSourceLoading = null;
 		sourceLoadingSubscriptionHost = null;
-		commentsDirectoryLeaseCount = 0;
-		trackChangesDirectoryLeaseCount = 0;
+		for (const family of Object.keys(directoryLeaseCounts)) directoryLeaseCounts[family] = 0;
 		demandedHeavyReads.clear();
 		incompleteTrackChangesDirectoryReadTokens.clear();
 		postSourceCompletionRefreshTokens.clear();

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.12.0-next.14",
+	superdocVersion: "2.12.0-next.15",
 	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.12.0-next.14",
+	superdocVersion: "2.12.0-next.15",
 	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-D8QSZN4i.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-BkDVQgqj.cjs");
 const require_slice_source = require("../chunks/slice-source-CFaqq0Vo.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-D3_JSfLV.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-Biwv0tas.es.js";
 import { t as toSliceSource } from "../chunks/slice-source-gfOhG2MW.es.js";
 import { createContext, createElement, useCallback, useContext, useEffect, useRef, useState } from "react";
 //#region src/public/ui/react.ts

package/dist/public/ui-vue.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-D8QSZN4i.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-BkDVQgqj.cjs");
 const require_slice_source = require("../chunks/slice-source-CFaqq0Vo.cjs");
 let vue = require("vue");
 //#region src/public/ui/vue.ts

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

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-D3_JSfLV.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-Biwv0tas.es.js";
 import { t as toSliceSource } from "../chunks/slice-source-gfOhG2MW.es.js";
 import { computed, inject, onScopeDispose, provide, shallowRef, toRaw, toValue, watch } from "vue";
 //#region src/public/ui/vue.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-D8QSZN4i.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-BkDVQgqj.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-D3_JSfLV.es.js";
+import { n as shallowEqual, r as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-Biwv0tas.es.js";
 export { BUILT_IN_COMMAND_IDS, createSuperDocUI, shallowEqual };

package/dist/superdoc/src/public/ui/types.d.ts

@@ -1032,6 +1032,22 @@ export interface TrackChangesHandle extends SnapshotSubscribable<TrackChangesSli
 }
 /** Content-controls handle. */
 export interface ContentControlsHandle extends SnapshotSubscribable<ContentControlsSlice> {
+    /**
+     * Observe the document-wide content-control catalog and active field IDs.
+     * The catalog remains requested until the returned disposer runs.
+     */
+    observe(listener: (snapshot: ContentControlsSlice) => void): () => void;
+    /**
+     * Observe the passive content-controls slice without requesting the
+     * document-wide catalog. Meant for consumers that only need the active
+     * field path, such as the core active-change event bridge; a field panel
+     * should use {@link observe}.
+     */
+    observeActivePath(listener: (snapshot: ContentControlsSlice) => void): () => void;
+    /** Event-shaped alias of {@link observe}. */
+    subscribe(listener: (event: {
+        snapshot: ContentControlsSlice;
+    }) => void): () => void;
     /** Read the current content-controls snapshot. */
     getSnapshot(): ContentControlsSlice;
     /** Read the current content-controls snapshot. */

package/dist/superdoc.cjs

@@ -4,7 +4,7 @@ const require_blank_docx = require("./chunks/blank-docx-BuFAbRjs.cjs");
 const require_eventemitter3 = require("./chunks/eventemitter3-C_TAnXOl.cjs");
 const require_uuid = require("./chunks/uuid-BhG0ngwk.cjs");
 const require_jszip = require("./chunks/jszip-D8mAFF-r.cjs");
-const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-D8QSZN4i.cjs");
+const require_create_super_doc_ui = require("./chunks/create-super-doc-ui-BkDVQgqj.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");
@@ -316,7 +316,7 @@ var shuffleArray = (array) => {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.12.0-next.14";
+		return "2.12.0-next.15";
 	} catch {
 		return "unknown";
 	}
@@ -45328,7 +45328,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.12.0-next.14";
+		this.version = "2.12.0-next.15";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4();
 		this.colors = this.config.colors ?? [];
@@ -45497,7 +45497,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 				this.#pendingContentControlInputSource = null;
 				this.#pendingContentControlInputExpiresAt = null;
 			});
-			contentControlsUnsub = this.#ui.contentControls.observe((snapshot) => {
+			contentControlsUnsub = this.#ui.contentControls.observeActivePath((snapshot) => {
 				const editor = this.activeEditor;
 				const activePath = snapshot.activeIds.map((id) => toContentControlRef(snapshot.items.find((item) => item.id === id)));
 				if (activePath.some((item) => item === null)) return;

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-DEIiXiH2.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-BzJ3CyxR.es.js";
-import { a as DOM_CLASS_NAMES, i as getV2TrackedChangeMutationImpact, t as createSuperDocUI } from "./chunks/create-super-doc-ui-D3_JSfLV.es.js";
+import { a as DOM_CLASS_NAMES, i as getV2TrackedChangeMutationImpact, t as createSuperDocUI } from "./chunks/create-super-doc-ui-Biwv0tas.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";
@@ -315,7 +315,7 @@ var shuffleArray = (array) => {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.12.0-next.14";
+		return "2.12.0-next.15";
 	} catch {
 		return "unknown";
 	}
@@ -45259,7 +45259,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.12.0-next.14";
+		this.version = "2.12.0-next.15";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4();
 		this.colors = this.config.colors ?? [];
@@ -45428,7 +45428,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 				this.#pendingContentControlInputSource = null;
 				this.#pendingContentControlInputExpiresAt = null;
 			});
-			contentControlsUnsub = this.#ui.contentControls.observe((snapshot) => {
+			contentControlsUnsub = this.#ui.contentControls.observeActivePath((snapshot) => {
 				const editor = this.activeEditor;
 				const activePath = snapshot.activeIds.map((id) => toContentControlRef(snapshot.items.find((item) => item.id === id)));
 				if (activePath.some((item) => item === null)) return;