superdoc 2.18.0-next.10 → 2.18.0-next.11

package/dist/chunks/{create-super-doc-ui-D9JWPXRh.cjs → create-super-doc-ui-BwM3I7-G.cjs}

@@ -8625,6 +8625,8 @@ function createSuperDocUI(options) {
 		const doc = getDoc();
 		const linksApi = doc?.hyperlinks;
 		if (!linksApi) return false;
+		const hyperlinkHost = getHost();
+		const trustedLinksApi = ((typeof hyperlinkHost?.getHandles === "function" ? hyperlinkHost.getHandles() : null)?.editing)?.hyperlinks;
 		const record = readLinkPayloadRecord(payload);
 		const href = readLinkPayloadHref(payload);
 		const payloadTarget = readLinkPayloadTarget(payload);
@@ -8648,7 +8650,7 @@ function createSuperDocUI(options) {
 			}
 		}
 		if (existing && href === null) {
-			const remove = linksApi.remove;
+			const remove = trustedLinksApi?.remove;
 			if (typeof remove !== "function") return false;
 			try {
 				return callEditorMutation("hyperlinks.remove", remove, {
@@ -8660,7 +8662,7 @@ function createSuperDocUI(options) {
 			}
 		}
 		if ((existing || requestedHyperlinkTarget) && typeof href === "string" && href.trim() !== "") {
-			const patch = linksApi.patch;
+			const patch = trustedLinksApi?.patch;
 			const updateTarget = linksApi.updateTarget;
 			if (!(!hasRequestedHyperlinkTarget && existing && typeof patch === "function") && !(hasRequestedHyperlinkTarget && typeof updateTarget === "function")) return false;
 			const shouldReplaceText = typeof text === "string" && text !== (hasRequestedHyperlinkTarget ? currentText : existing?.text ?? currentText);
@@ -8750,7 +8752,7 @@ function createSuperDocUI(options) {
 		}
 		if (typeof href === "string" && href.trim() !== "") {
 			const normalizedHref = href.trim();
-			const wrap = linksApi.wrap;
+			const wrap = trustedLinksApi?.wrap;
 			const textTargets = textAddressesFromTarget(payloadTarget);
 			const wrapTargets = textTargets.length > 0 ? textTargets : selectionTextAddresses(state.selection);
 			if (wrapTargets.length > 0) {
@@ -8764,7 +8766,7 @@ function createSuperDocUI(options) {
 					return false;
 				}
 			}
-			const insert = linksApi.insert;
+			const insert = trustedLinksApi?.insert;
 			const text = readLinkPayloadText(payload, normalizedHref);
 			if (typeof insert !== "function" || text.trim() === "") return false;
 			const target = collapsedTextAddressFromTarget(payloadTarget) ?? collapsedTextAddressFromSelection(state.selection);
@@ -8835,8 +8837,11 @@ function createSuperDocUI(options) {
 			if (typeof record.alt === "string") input.alt = record.alt;
 			if (typeof record.title === "string") input.title = record.title;
 			if (record.size && typeof record.size === "object") input.size = record.size;
+			const imageHost = getHost();
+			const trustedImageCommands = ((typeof imageHost?.getHandles === "function" ? imageHost.getHandles() : null)?.editing)?.images;
+			if (typeof trustedImageCommands?.create !== "function") return false;
 			try {
-				return callEditorMutation(descriptor.docRoute, op, input);
+				return callEditorMutation(descriptor.docRoute, trustedImageCommands.create, input);
 			} catch {
 				return false;
 			}

package/dist/chunks/{create-super-doc-ui-qTSa0PbD.es.js → create-super-doc-ui-Ci7OxbXV.es.js}

@@ -8625,6 +8625,8 @@ function createSuperDocUI(options) {
 		const doc = getDoc();
 		const linksApi = doc?.hyperlinks;
 		if (!linksApi) return false;
+		const hyperlinkHost = getHost();
+		const trustedLinksApi = ((typeof hyperlinkHost?.getHandles === "function" ? hyperlinkHost.getHandles() : null)?.editing)?.hyperlinks;
 		const record = readLinkPayloadRecord(payload);
 		const href = readLinkPayloadHref(payload);
 		const payloadTarget = readLinkPayloadTarget(payload);
@@ -8648,7 +8650,7 @@ function createSuperDocUI(options) {
 			}
 		}
 		if (existing && href === null) {
-			const remove = linksApi.remove;
+			const remove = trustedLinksApi?.remove;
 			if (typeof remove !== "function") return false;
 			try {
 				return callEditorMutation("hyperlinks.remove", remove, {
@@ -8660,7 +8662,7 @@ function createSuperDocUI(options) {
 			}
 		}
 		if ((existing || requestedHyperlinkTarget) && typeof href === "string" && href.trim() !== "") {
-			const patch = linksApi.patch;
+			const patch = trustedLinksApi?.patch;
 			const updateTarget = linksApi.updateTarget;
 			if (!(!hasRequestedHyperlinkTarget && existing && typeof patch === "function") && !(hasRequestedHyperlinkTarget && typeof updateTarget === "function")) return false;
 			const shouldReplaceText = typeof text === "string" && text !== (hasRequestedHyperlinkTarget ? currentText : existing?.text ?? currentText);
@@ -8750,7 +8752,7 @@ function createSuperDocUI(options) {
 		}
 		if (typeof href === "string" && href.trim() !== "") {
 			const normalizedHref = href.trim();
-			const wrap = linksApi.wrap;
+			const wrap = trustedLinksApi?.wrap;
 			const textTargets = textAddressesFromTarget(payloadTarget);
 			const wrapTargets = textTargets.length > 0 ? textTargets : selectionTextAddresses(state.selection);
 			if (wrapTargets.length > 0) {
@@ -8764,7 +8766,7 @@ function createSuperDocUI(options) {
 					return false;
 				}
 			}
-			const insert = linksApi.insert;
+			const insert = trustedLinksApi?.insert;
 			const text = readLinkPayloadText(payload, normalizedHref);
 			if (typeof insert !== "function" || text.trim() === "") return false;
 			const target = collapsedTextAddressFromTarget(payloadTarget) ?? collapsedTextAddressFromSelection(state.selection);
@@ -8835,8 +8837,11 @@ function createSuperDocUI(options) {
 			if (typeof record.alt === "string") input.alt = record.alt;
 			if (typeof record.title === "string") input.title = record.title;
 			if (record.size && typeof record.size === "object") input.size = record.size;
+			const imageHost = getHost();
+			const trustedImageCommands = ((typeof imageHost?.getHandles === "function" ? imageHost.getHandles() : null)?.editing)?.images;
+			if (typeof trustedImageCommands?.create !== "function") return false;
 			try {
-				return callEditorMutation(descriptor.docRoute, op, input);
+				return callEditorMutation(descriptor.docRoute, trustedImageCommands.create, input);
 			} catch {
 				return false;
 			}

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.18.0-next.10",
+	superdocVersion: "2.18.0-next.11",
 	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.18.0-next.10",
+	superdocVersion: "2.18.0-next.11",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/document-api/src/diff/diff.types.d.ts

@@ -44,7 +44,7 @@ export interface DiffSummary {
     };
 }
 /** Stable reason code for a compare-time apply blocker. */
-export type DiffApplyEligibilityBlockerCode = 'family-apply-lane-unavailable' | 'header-footer-physical-lifecycle-unsafe' | 'header-footer-tracked-lifecycle-unsupported' | 'comment-replay-unsafe' | 'comment-anchor-marker-semantics-unsafe' | 'styles-replay-unsafe' | 'numbering-replay-unsafe' | 'section-reference-replay-unsafe' | 'structural-paragraph-unsupported';
+export type DiffApplyEligibilityBlockerCode = 'family-apply-lane-unavailable' | 'header-footer-physical-lifecycle-unsafe' | 'header-footer-tracked-lifecycle-unsupported' | 'comment-replay-unsafe' | 'comment-anchor-marker-semantics-unsafe' | 'styles-replay-unsafe' | 'numbering-replay-unsafe' | 'definition-replay-tracked-unsupported' | 'section-reference-replay-unsafe' | 'structural-paragraph-unsupported';
 /** A known reason that the complete diff cannot be applied in one change mode. */
 export interface DiffApplyEligibilityBlocker {
     code: DiffApplyEligibilityBlockerCode;

package/dist/layout-engine/contracts/src/index.d.ts

@@ -427,6 +427,10 @@ export type TextRun = RunMarks & {
 export type TabRun = RunMarks & {
     kind: 'tab';
     text: '\t';
+    positionedTab?: {
+        relativeTo: 'margin' | 'indent';
+        alignment: 'start' | 'center' | 'end';
+    };
     /**
      * Font of the tab, inherited from the paragraph's resolved run properties. A tab has
      * no glyphs, but its font drives the line height (so a tab-only line matches a text

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-D9JWPXRh.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-BwM3I7-G.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-qTSa0PbD.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-Ci7OxbXV.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-D9JWPXRh.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-BwM3I7-G.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-qTSa0PbD.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-Ci7OxbXV.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-D9JWPXRh.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-BwM3I7-G.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-qTSa0PbD.es.js";
+import { n as shallowEqual, r as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-Ci7OxbXV.es.js";
 export { BUILT_IN_COMMAND_IDS, createSuperDocUI, shallowEqual };

package/dist/style.css

@@ -1823,34 +1823,34 @@ img[data-v-c95b2073] {
   pointer-events: auto;
 }
 
-.superdoc[data-v-4efb0cab] {
+.superdoc[data-v-9da02d58] {
   display: flex;
   position: relative;
 }
-.right-sidebar[data-v-4efb0cab] {
+.right-sidebar[data-v-9da02d58] {
   min-width: 320px;
   height: 100%;
 }
-.floating-comments[data-v-4efb0cab] {
+.floating-comments[data-v-9da02d58] {
   min-width: 300px;
   width: 300px;
   height: 100%;
   overflow: visible;
 }
-.superdoc__layers[data-v-4efb0cab] {
+.superdoc__layers[data-v-9da02d58] {
   height: 100%;
   position: relative;
   box-sizing: border-box;
 }
-.superdoc__document[data-v-4efb0cab] {
+.superdoc__document[data-v-9da02d58] {
   width: 100%;
   position: relative;
 }
-.superdoc__sub-document[data-v-4efb0cab] {
+.superdoc__sub-document[data-v-9da02d58] {
   width: 100%;
   position: relative;
 }
-.superdoc__selection-layer[data-v-4efb0cab] {
+.superdoc__selection-layer[data-v-9da02d58] {
   position: absolute;
   min-width: 100%;
   min-height: 100%;
@@ -1861,13 +1861,13 @@ img[data-v-c95b2073] {
 /* SD-3497: PDF whiteboard overlay sits above the rendered PDF canvas but below
    the PDF comment anchors (z-index 6 in PdfCommentsLayer) so anchors stay
    clickable, and below the selection layer (z-index 10). */
-.superdoc__whiteboard-layer[data-v-4efb0cab] {
+.superdoc__whiteboard-layer[data-v-9da02d58] {
   z-index: 4;
 }
-.superdoc__temp-selection[data-v-4efb0cab] {
+.superdoc__temp-selection[data-v-9da02d58] {
   position: absolute;
 }
-.superdoc__right-sidebar[data-v-4efb0cab] {
+.superdoc__right-sidebar[data-v-9da02d58] {
   width: 320px;
   min-width: 320px;
   padding: 0 10px;
@@ -1875,7 +1875,7 @@ img[data-v-c95b2073] {
   position: relative;
   z-index: 2;
 }
-.superdoc__compact-comment-popover[data-v-4efb0cab] {
+.superdoc__compact-comment-popover[data-v-9da02d58] {
   position: absolute;
   top: 12px;
   right: 12px;
@@ -1884,14 +1884,14 @@ img[data-v-c95b2073] {
 }
 
 /* Tools styles */
-.tools[data-v-4efb0cab] {
+.tools[data-v-9da02d58] {
   position: absolute;
   z-index: 3;
   display: flex;
   flex-direction: column;
   gap: var(--sd-ui-tools-gap, 6px);
 }
-.tools-item[data-v-4efb0cab] {
+.tools-item[data-v-9da02d58] {
   display: flex;
   align-items: center;
   justify-content: center;
@@ -1902,10 +1902,10 @@ img[data-v-c95b2073] {
   cursor: pointer;
   position: relative;
 }
-.tools-item i[data-v-4efb0cab] {
+.tools-item i[data-v-9da02d58] {
   cursor: pointer;
 }
-.superdoc__tools-icon[data-v-4efb0cab] {
+.superdoc__tools-icon[data-v-9da02d58] {
   width: var(--sd-ui-tools-icon-size, 20px);
   height: var(--sd-ui-tools-icon-size, 20px);
   flex-shrink: 0;
@@ -1920,22 +1920,22 @@ img[data-v-c95b2073] {
 
 /* 834px is iPad screen size in portrait orientation */
 @media (max-width: 834px) {
-.superdoc .superdoc__layers[data-v-4efb0cab] {
+.superdoc .superdoc__layers[data-v-9da02d58] {
     margin: 0;
     border: 0 !important;
     box-shadow: none;
 }
-.superdoc__sub-document[data-v-4efb0cab] {
+.superdoc__sub-document[data-v-9da02d58] {
     max-width: 100%;
 }
-.superdoc__right-sidebar[data-v-4efb0cab] {
+.superdoc__right-sidebar[data-v-9da02d58] {
     padding: 10px;
     position: relative;
 }
 }
 
 /* AI Writer styles */
-.ai-writer-container[data-v-4efb0cab] {
+.ai-writer-container[data-v-9da02d58] {
   position: fixed;
   z-index: 1000;
   background: white;
@@ -1951,10 +1951,10 @@ img[data-v-c95b2073] {
   transform: translateY(-50%);
   z-index: 50;
 } */
-.ai-tool > svg[data-v-4efb0cab] {
+.ai-tool > svg[data-v-9da02d58] {
   fill: transparent;
 }
-.ai-tool[data-v-4efb0cab]::before {
+.ai-tool[data-v-9da02d58]::before {
   content: '';
   position: absolute;
   width: 20px;
@@ -1975,7 +1975,7 @@ img[data-v-c95b2073] {
   filter: brightness(1.2);
   transition: filter 0.2s ease;
 }
-.ai-tool[data-v-4efb0cab]:hover::before {
+.ai-tool[data-v-9da02d58]:hover::before {
   filter: brightness(1.3);
 }
 

package/dist/style.layered.css

@@ -1823,34 +1823,34 @@ img[data-v-c95b2073] {
   pointer-events: auto;
 }
 
-.superdoc[data-v-4efb0cab] {
+.superdoc[data-v-9da02d58] {
   display: flex;
   position: relative;
 }
-.right-sidebar[data-v-4efb0cab] {
+.right-sidebar[data-v-9da02d58] {
   min-width: 320px;
   height: 100%;
 }
-.floating-comments[data-v-4efb0cab] {
+.floating-comments[data-v-9da02d58] {
   min-width: 300px;
   width: 300px;
   height: 100%;
   overflow: visible;
 }
-.superdoc__layers[data-v-4efb0cab] {
+.superdoc__layers[data-v-9da02d58] {
   height: 100%;
   position: relative;
   box-sizing: border-box;
 }
-.superdoc__document[data-v-4efb0cab] {
+.superdoc__document[data-v-9da02d58] {
   width: 100%;
   position: relative;
 }
-.superdoc__sub-document[data-v-4efb0cab] {
+.superdoc__sub-document[data-v-9da02d58] {
   width: 100%;
   position: relative;
 }
-.superdoc__selection-layer[data-v-4efb0cab] {
+.superdoc__selection-layer[data-v-9da02d58] {
   position: absolute;
   min-width: 100%;
   min-height: 100%;
@@ -1861,13 +1861,13 @@ img[data-v-c95b2073] {
 /* SD-3497: PDF whiteboard overlay sits above the rendered PDF canvas but below
    the PDF comment anchors (z-index 6 in PdfCommentsLayer) so anchors stay
    clickable, and below the selection layer (z-index 10). */
-.superdoc__whiteboard-layer[data-v-4efb0cab] {
+.superdoc__whiteboard-layer[data-v-9da02d58] {
   z-index: 4;
 }
-.superdoc__temp-selection[data-v-4efb0cab] {
+.superdoc__temp-selection[data-v-9da02d58] {
   position: absolute;
 }
-.superdoc__right-sidebar[data-v-4efb0cab] {
+.superdoc__right-sidebar[data-v-9da02d58] {
   width: 320px;
   min-width: 320px;
   padding: 0 10px;
@@ -1875,7 +1875,7 @@ img[data-v-c95b2073] {
   position: relative;
   z-index: 2;
 }
-.superdoc__compact-comment-popover[data-v-4efb0cab] {
+.superdoc__compact-comment-popover[data-v-9da02d58] {
   position: absolute;
   top: 12px;
   right: 12px;
@@ -1884,14 +1884,14 @@ img[data-v-c95b2073] {
 }
 
 /* Tools styles */
-.tools[data-v-4efb0cab] {
+.tools[data-v-9da02d58] {
   position: absolute;
   z-index: 3;
   display: flex;
   flex-direction: column;
   gap: var(--sd-ui-tools-gap, 6px);
 }
-.tools-item[data-v-4efb0cab] {
+.tools-item[data-v-9da02d58] {
   display: flex;
   align-items: center;
   justify-content: center;
@@ -1902,10 +1902,10 @@ img[data-v-c95b2073] {
   cursor: pointer;
   position: relative;
 }
-.tools-item i[data-v-4efb0cab] {
+.tools-item i[data-v-9da02d58] {
   cursor: pointer;
 }
-.superdoc__tools-icon[data-v-4efb0cab] {
+.superdoc__tools-icon[data-v-9da02d58] {
   width: var(--sd-ui-tools-icon-size, 20px);
   height: var(--sd-ui-tools-icon-size, 20px);
   flex-shrink: 0;
@@ -1920,22 +1920,22 @@ img[data-v-c95b2073] {
 
 /* 834px is iPad screen size in portrait orientation */
 @media (max-width: 834px) {
-.superdoc .superdoc__layers[data-v-4efb0cab] {
+.superdoc .superdoc__layers[data-v-9da02d58] {
     margin: 0;
     border: 0 !important;
     box-shadow: none;
 }
-.superdoc__sub-document[data-v-4efb0cab] {
+.superdoc__sub-document[data-v-9da02d58] {
     max-width: 100%;
 }
-.superdoc__right-sidebar[data-v-4efb0cab] {
+.superdoc__right-sidebar[data-v-9da02d58] {
     padding: 10px;
     position: relative;
 }
 }
 
 /* AI Writer styles */
-.ai-writer-container[data-v-4efb0cab] {
+.ai-writer-container[data-v-9da02d58] {
   position: fixed;
   z-index: 1000;
   background: white;
@@ -1951,10 +1951,10 @@ img[data-v-c95b2073] {
   transform: translateY(-50%);
   z-index: 50;
 } */
-.ai-tool > svg[data-v-4efb0cab] {
+.ai-tool > svg[data-v-9da02d58] {
   fill: transparent;
 }
-.ai-tool[data-v-4efb0cab]::before {
+.ai-tool[data-v-9da02d58]::before {
   content: '';
   position: absolute;
   width: 20px;
@@ -1975,7 +1975,7 @@ img[data-v-c95b2073] {
   filter: brightness(1.2);
   transition: filter 0.2s ease;
 }
-.ai-tool[data-v-4efb0cab]:hover::before {
+.ai-tool[data-v-9da02d58]:hover::before {
   filter: brightness(1.3);
 }
 

package/dist/superdoc/src/core/SuperDoc.d.ts

@@ -9,7 +9,7 @@ import { normalizeInteractionConfig } from './config/normalize-interaction-confi
 import { normalizeSurfacesConfig } from './config/normalize-surfaces-config.js';
 import { EditorRuntimeFocusOptions } from './editor-runtime/types.js';
 import { BorrowedSuperDocUI } from '../public/ui/types.js';
-import { AwarenessUser, CanPerformPermissionParams, CollaborationProvider, Config, ContentControlActiveChangePayload, ContentControlClickPayload, DocumentMode, Editor, EditorUpdateEvent, ExportParams, FontsChangedPayload, FontsResolvedPayload, InternalConfig, ListDefinitionsPayload, NavigableAddress, DocumentRendererRuntime, SearchMatch, SuperDocAwarenessUpdatePayload, SuperDocCommentsUpdatePayload, SuperDocCommentsListChangePayload, SuperDocDocumentModeChangePayload, SuperDocDocumentReplacedPayload, SuperDocEditorPayload, SuperDocExceptionPayload, SuperDocFontsApi, SuperDocFormattingMarksChangePayload, SuperDocLockedPayload, SuperDocMeasurementUnit, SuperDocMeasurementUnitChangePayload, SuperDocPageMarginsChangePayload, SuperDocPaginationUpdatePayload, SuperDocReadyPayload, SuperDocState, SuperDocTrackedChangesBulkDecisionPayload, SuperDocViewportChangePayload, SuperDocViewportMetrics, SuperDocZoomMode, SuperDocZoomPayload, SuperDocZoomState, SurfaceHandle, SurfaceRequest, UpgradeToCollaborationOptions, User, ViewingOptions } from './types/index.js';
+import { AwarenessUser, CanPerformPermissionParams, CollaborationProvider, Config, ContentControlActiveChangePayload, ContentControlClickPayload, DocumentMode, Editor, EditorUpdateEvent, ExportParams, FontsChangedPayload, FontsResolvedPayload, InternalConfig, ListDefinitionsPayload, NavigableAddress, DocumentRendererRuntime, SearchMatch, SuperDocAwarenessUpdatePayload, SuperDocCommentsUpdatePayload, SuperDocCommentsListChangePayload, SuperDocDocumentModeChangePayload, SuperDocDocumentReplacedPayload, SuperDocEditorPayload, SuperDocExceptionPayload, SuperDocFontsApi, SuperDocFormattingMarksChangePayload, SuperDocLockedPayload, SuperDocCollaborationConnectionChangePayload, SuperDocMeasurementUnit, SuperDocMeasurementUnitChangePayload, SuperDocPageMarginsChangePayload, SuperDocPaginationUpdatePayload, SuperDocReadyPayload, SuperDocState, SuperDocTrackedChangesBulkDecisionPayload, SuperDocViewportChangePayload, SuperDocViewportMetrics, SuperDocZoomMode, SuperDocZoomPayload, SuperDocZoomState, SurfaceHandle, SurfaceRequest, UpgradeToCollaborationOptions, User, ViewingOptions } from './types/index.js';
 import { WhiteboardData } from './whiteboard/Whiteboard.js';
 type ToolbarLike = {
     activeEditor?: unknown;
@@ -86,6 +86,7 @@ interface SuperDocEventMap {
     'collaboration-ready': [SuperDocEditorPayload];
     'awareness-update': [SuperDocAwarenessUpdatePayload];
     locked: [SuperDocLockedPayload];
+    'collaboration-connection-change': [SuperDocCollaborationConnectionChangePayload];
     'whiteboard:init': [SuperDocWhiteboardPayload];
     'whiteboard:ready': [SuperDocWhiteboardPayload];
     'whiteboard:change': [WhiteboardData];
@@ -347,6 +348,12 @@ export declare class SuperDoc extends EventEmitter<SuperDocEventMap> {
      * Get the SuperDoc container element
      */
     get element(): Element | null;
+    /**
+     * Latest v2 collaboration connection change, or `null` when no v2
+     * collaboration session has reported one. Same payload as the
+     * `collaboration-connection-change` event.
+     */
+    getCollaborationConnectionState(): SuperDocCollaborationConnectionChangePayload | null;
     /**
      * Upgrade a local SuperDoc instance into collaboration by creating the
      * supplied room from the current local document and comment state, then

package/dist/superdoc/src/core/types/index.d.ts

@@ -3013,6 +3013,32 @@ export interface SuperDocLockedPayload {
     isLocked: boolean;
     lockedBy: User | null;
 }
+/** Collaboration transport state reported by `collaboration-connection-change`. */
+export type SuperDocCollaborationConnectionState = 'connecting' | 'synced' | 'degraded' | 'failed';
+/**
+ * What a `collaboration-connection-change` means for the session:
+ * - `initial`: opening, before the first sync completes (or the first sync itself)
+ * - `lost`: the transport dropped after the room had synced
+ * - `reconnecting`: the provider is retrying while the connection is degraded
+ * - `recovered`: the connection re-synced after an outage
+ * - `failed`: terminal transport or auth failure
+ */
+export type SuperDocCollaborationConnectionKind = 'initial' | 'lost' | 'reconnecting' | 'recovered' | 'failed';
+/**
+ * Payload emitted with the `collaboration-connection-change` event and passed to
+ * `Config.onCollaborationConnectionChange`. Emitted for v2 collaboration sessions
+ * when the real provider transport changes state.
+ */
+export interface SuperDocCollaborationConnectionChangePayload {
+    /** Collaboration document id (`v2Collaboration.documentId`) for the affected room. */
+    documentId: string;
+    state: SuperDocCollaborationConnectionState;
+    previousState: SuperDocCollaborationConnectionState | null;
+    kind: SuperDocCollaborationConnectionKind;
+    /** Extra transport detail, e.g. `reconnecting` or `transport-disconnected`. */
+    detail: string | null;
+    superdoc: SuperDoc;
+}
 /**
  * Payload emitted with the `awareness-update` event and passed to
  * `Config.onAwarenessUpdate`. Field set differs from older inline
@@ -4108,6 +4134,8 @@ export interface Config {
     onSidebarToggle?: (isOpened: boolean) => void;
     /** Callback when collaboration is ready. Receives a wrapper carrying the editor. */
     onCollaborationReady?: (params: SuperDocEditorPayload) => void;
+    /** Callback when the v2 collaboration connection is lost, retries, recovers, or fails. */
+    onCollaborationConnectionChange?: (params: SuperDocCollaborationConnectionChangePayload) => void;
     /** Callback when document is updated. */
     onEditorUpdate?: (params: EditorUpdateEvent) => void;
     /** Callback after an Accept All or Reject All tracked-change decision. */

package/dist/superdoc/src/public/index.d.cts

@@ -127,6 +127,9 @@ import type { SuperDocAnchorStatus as __Cjs_SuperDocAnchorStatus } from './index
 import type { SuperDocAnchorTarget as __Cjs_SuperDocAnchorTarget } from './index.js' with { "resolution-mode": "import" };
 import type { SuperDocAwarenessUpdatePayload as __Cjs_SuperDocAwarenessUpdatePayload } from './index.js' with { "resolution-mode": "import" };
 import type { SuperDocCharRange as __Cjs_SuperDocCharRange } from './index.js' with { "resolution-mode": "import" };
+import type { SuperDocCollaborationConnectionChangePayload as __Cjs_SuperDocCollaborationConnectionChangePayload } from './index.js' with { "resolution-mode": "import" };
+import type { SuperDocCollaborationConnectionKind as __Cjs_SuperDocCollaborationConnectionKind } from './index.js' with { "resolution-mode": "import" };
+import type { SuperDocCollaborationConnectionState as __Cjs_SuperDocCollaborationConnectionState } from './index.js' with { "resolution-mode": "import" };
 import type { SuperDocCommandApi as __Cjs_SuperDocCommandApi } from './index.js' with { "resolution-mode": "import" };
 import type { SuperDocCommandExecuteContext as __Cjs_SuperDocCommandExecuteContext } from './index.js' with { "resolution-mode": "import" };
 import type { SuperDocCommandState as __Cjs_SuperDocCommandState } from './index.js' with { "resolution-mode": "import" };
@@ -414,6 +417,9 @@ export type { __Cjs_SuperDocAnchorStatus as SuperDocAnchorStatus };
 export type { __Cjs_SuperDocAnchorTarget as SuperDocAnchorTarget };
 export type { __Cjs_SuperDocAwarenessUpdatePayload as SuperDocAwarenessUpdatePayload };
 export type { __Cjs_SuperDocCharRange as SuperDocCharRange };
+export type { __Cjs_SuperDocCollaborationConnectionChangePayload as SuperDocCollaborationConnectionChangePayload };
+export type { __Cjs_SuperDocCollaborationConnectionKind as SuperDocCollaborationConnectionKind };
+export type { __Cjs_SuperDocCollaborationConnectionState as SuperDocCollaborationConnectionState };
 export type { __Cjs_SuperDocCommandApi as SuperDocCommandApi };
 export type { __Cjs_SuperDocCommandExecuteContext as SuperDocCommandExecuteContext };
 export type { __Cjs_SuperDocCommandState as SuperDocCommandState };

package/dist/superdoc/src/public/index.d.ts

@@ -135,6 +135,9 @@ export type { LinkPopoverContext } from '../core/types/index.js';
 export type { LinkPopoverResolution } from '../core/types/index.js';
 export type { LinkPopoverResolver } from '../core/types/index.js';
 export type { SuperDocLockedPayload } from '../core/types/index.js';
+export type { SuperDocCollaborationConnectionChangePayload } from '../core/types/index.js';
+export type { SuperDocCollaborationConnectionKind } from '../core/types/index.js';
+export type { SuperDocCollaborationConnectionState } from '../core/types/index.js';
 export type { SuperDocMeasurementUnit } from '../core/types/index.js';
 export type { SuperDocMeasurementUnitChangePayload } from '../core/types/index.js';
 export type { SuperDocPageCountKnownPayload } from '../core/types/index.js';