superdoc 2.18.0-next.9 → 2.18.0

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.9",
+	superdocVersion: "2.18.0",
 	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.9",
+	superdocVersion: "2.18.0",
 	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/document-api/src/images/images.types.d.ts

@@ -181,6 +181,8 @@ export interface CreateImageSuccessResult {
     success: true;
     image: ImageAddress;
     trackedChangeRefs?: ReceiptInsert[];
+    /** Commit id for the insertion, including its alt text when that was set in the same call. */
+    txId?: string;
 }
 export interface CreateImageFailureResult {
     success: false;

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

@@ -110,7 +110,26 @@ export type SDPasteLeafInline = {
     title?: string;
     sourcePath?: readonly (string | number)[];
 };
-export type SDPasteInline = SDPasteLeafInline | {
+export interface SDPasteSdtInline {
+    kind: 'sdt';
+    controlType: 'text' | 'richText';
+    tag?: string;
+    alias?: string;
+    lockMode?: 'unlocked' | 'sdtLocked' | 'contentLocked' | 'sdtContentLocked';
+    multiline?: boolean;
+    sourcePath?: readonly (string | number)[];
+    inlines: readonly (SDPasteLeafInline | SDPasteSdtInline)[];
+}
+export interface SDPasteBlockSdt {
+    /** Clipboard-local wrapper identity shared by adjacent paragraphs. */
+    sourceId: string;
+    controlType: 'text' | 'richText';
+    tag?: string;
+    alias?: string;
+    lockMode?: 'unlocked' | 'sdtLocked' | 'contentLocked' | 'sdtContentLocked';
+    multiline?: boolean;
+}
+export type SDPasteInline = SDPasteLeafInline | SDPasteSdtInline | {
     kind: 'hyperlink';
     target: {
         kind: 'external';
@@ -176,6 +195,8 @@ export interface SDPasteParagraphBlock {
      * paste anchor's paragraph, independent of whether they carry formatting.
      */
     complete?: boolean;
+    /** Outermost-first complete block content-control ancestry. */
+    blockSdts?: readonly SDPasteBlockSdt[];
     /** Transient conversion identity used to map mutation effects back to source nodes. */
     sourcePath?: readonly (string | number)[];
 }
@@ -215,6 +236,8 @@ export interface SDPasteTableRow {
  */
 export interface SDPasteTableBlock {
     kind: 'table';
+    /** Direct between-cell spacing in points (not cell padding). */
+    cellSpacingPt?: number;
     rows: readonly SDPasteTableRow[];
     sourcePath?: readonly (string | number)[];
 }

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-wDvhW9Tz.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-wKzxrztu.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-wDvhW9Tz.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-wKzxrztu.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-wDvhW9Tz.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 { i as BUILT_IN_COMMAND_IDS, s as shallowEqual, t as createSuperDocUI } from "../chunks/create-super-doc-ui-wKzxrztu.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-77e0209a] {
   display: flex;
   position: relative;
 }
-.right-sidebar[data-v-4efb0cab] {
+.right-sidebar[data-v-77e0209a] {
   min-width: 320px;
   height: 100%;
 }
-.floating-comments[data-v-4efb0cab] {
+.floating-comments[data-v-77e0209a] {
   min-width: 300px;
   width: 300px;
   height: 100%;
   overflow: visible;
 }
-.superdoc__layers[data-v-4efb0cab] {
+.superdoc__layers[data-v-77e0209a] {
   height: 100%;
   position: relative;
   box-sizing: border-box;
 }
-.superdoc__document[data-v-4efb0cab] {
+.superdoc__document[data-v-77e0209a] {
   width: 100%;
   position: relative;
 }
-.superdoc__sub-document[data-v-4efb0cab] {
+.superdoc__sub-document[data-v-77e0209a] {
   width: 100%;
   position: relative;
 }
-.superdoc__selection-layer[data-v-4efb0cab] {
+.superdoc__selection-layer[data-v-77e0209a] {
   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-77e0209a] {
   z-index: 4;
 }
-.superdoc__temp-selection[data-v-4efb0cab] {
+.superdoc__temp-selection[data-v-77e0209a] {
   position: absolute;
 }
-.superdoc__right-sidebar[data-v-4efb0cab] {
+.superdoc__right-sidebar[data-v-77e0209a] {
   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-77e0209a] {
   position: absolute;
   top: 12px;
   right: 12px;
@@ -1884,14 +1884,14 @@ img[data-v-c95b2073] {
 }
 
 /* Tools styles */
-.tools[data-v-4efb0cab] {
+.tools[data-v-77e0209a] {
   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-77e0209a] {
   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-77e0209a] {
   cursor: pointer;
 }
-.superdoc__tools-icon[data-v-4efb0cab] {
+.superdoc__tools-icon[data-v-77e0209a] {
   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-77e0209a] {
     margin: 0;
     border: 0 !important;
     box-shadow: none;
 }
-.superdoc__sub-document[data-v-4efb0cab] {
+.superdoc__sub-document[data-v-77e0209a] {
     max-width: 100%;
 }
-.superdoc__right-sidebar[data-v-4efb0cab] {
+.superdoc__right-sidebar[data-v-77e0209a] {
     padding: 10px;
     position: relative;
 }
 }
 
 /* AI Writer styles */
-.ai-writer-container[data-v-4efb0cab] {
+.ai-writer-container[data-v-77e0209a] {
   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-77e0209a] {
   fill: transparent;
 }
-.ai-tool[data-v-4efb0cab]::before {
+.ai-tool[data-v-77e0209a]::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-77e0209a]: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-77e0209a] {
   display: flex;
   position: relative;
 }
-.right-sidebar[data-v-4efb0cab] {
+.right-sidebar[data-v-77e0209a] {
   min-width: 320px;
   height: 100%;
 }
-.floating-comments[data-v-4efb0cab] {
+.floating-comments[data-v-77e0209a] {
   min-width: 300px;
   width: 300px;
   height: 100%;
   overflow: visible;
 }
-.superdoc__layers[data-v-4efb0cab] {
+.superdoc__layers[data-v-77e0209a] {
   height: 100%;
   position: relative;
   box-sizing: border-box;
 }
-.superdoc__document[data-v-4efb0cab] {
+.superdoc__document[data-v-77e0209a] {
   width: 100%;
   position: relative;
 }
-.superdoc__sub-document[data-v-4efb0cab] {
+.superdoc__sub-document[data-v-77e0209a] {
   width: 100%;
   position: relative;
 }
-.superdoc__selection-layer[data-v-4efb0cab] {
+.superdoc__selection-layer[data-v-77e0209a] {
   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-77e0209a] {
   z-index: 4;
 }
-.superdoc__temp-selection[data-v-4efb0cab] {
+.superdoc__temp-selection[data-v-77e0209a] {
   position: absolute;
 }
-.superdoc__right-sidebar[data-v-4efb0cab] {
+.superdoc__right-sidebar[data-v-77e0209a] {
   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-77e0209a] {
   position: absolute;
   top: 12px;
   right: 12px;
@@ -1884,14 +1884,14 @@ img[data-v-c95b2073] {
 }
 
 /* Tools styles */
-.tools[data-v-4efb0cab] {
+.tools[data-v-77e0209a] {
   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-77e0209a] {
   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-77e0209a] {
   cursor: pointer;
 }
-.superdoc__tools-icon[data-v-4efb0cab] {
+.superdoc__tools-icon[data-v-77e0209a] {
   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-77e0209a] {
     margin: 0;
     border: 0 !important;
     box-shadow: none;
 }
-.superdoc__sub-document[data-v-4efb0cab] {
+.superdoc__sub-document[data-v-77e0209a] {
     max-width: 100%;
 }
-.superdoc__right-sidebar[data-v-4efb0cab] {
+.superdoc__right-sidebar[data-v-77e0209a] {
     padding: 10px;
     position: relative;
 }
 }
 
 /* AI Writer styles */
-.ai-writer-container[data-v-4efb0cab] {
+.ai-writer-container[data-v-77e0209a] {
   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-77e0209a] {
   fill: transparent;
 }
-.ai-tool[data-v-4efb0cab]::before {
+.ai-tool[data-v-77e0209a]::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-77e0209a]: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, UpgradeToCollaborationResult, 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
@@ -360,9 +367,9 @@ export declare class SuperDoc extends EventEmitter<SuperDocEventMap> {
      * - A supported v2 single-doc `v2Collaboration` target
      * - Create-and-upgrade only (no merge semantics)
      *
-     * @returns Resolves once the collaborative runtime is ready
+     * @returns The attached room and document once the collaborative runtime is ready
      */
-    upgradeToCollaboration(options: UpgradeToCollaborationOptions): Promise<void>;
+    upgradeToCollaboration(options: UpgradeToCollaborationOptions): Promise<UpgradeToCollaborationResult>;
     /**
      * Add a user to the shared users list. Requires the instance to be
      * ready; pre-ready mutations would be silently overwritten by the

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

@@ -1193,6 +1193,15 @@ export interface UpgradeToCollaborationOptions {
      */
     provider?: CollaborationProvider;
 }
+/** Confirmed identities of the room and local document attached by a successful upgrade. */
+export interface UpgradeToCollaborationResult {
+    roomId: string;
+    documentId: string;
+}
+/** Machine-readable failures returned by a create-and-upgrade attempt. */
+export interface SuperDocCollaborationUpgradeError extends Error {
+    code: 'collaboration-v2-room-already-exists' | 'collaboration-upgrade-target-conflict';
+}
 /** Context passed to a hyperlink activation handler. */
 export interface HyperlinkActivationContext {
     /** The editor instance. */
@@ -3013,6 +3022,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 +4143,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/internal/toolbar/built-in/LinkInput.vue.d.ts

@@ -5,15 +5,15 @@ declare const _default: import('vue').DefineComponent<{}, {
     rel: string;
     documentMode: string;
     ui: Record<string, any>;
+    textTarget: Record<string, any>;
+    hyperlinkTarget: Record<string, any>;
     showInput: boolean;
     showLink: boolean;
     goToAnchor: Function;
     linkItem: Record<string, any>;
     closePopover: Function;
     clickedElement: Record<string, any>;
-    hyperlinkTarget: Record<string, any>;
     hyperlinkText: string;
-    textTarget: Record<string, any>;
     restoreSelection: Function;
     $props: {
         readonly target?: string | undefined;
@@ -22,15 +22,15 @@ declare const _default: import('vue').DefineComponent<{}, {
         readonly rel?: string | undefined;
         readonly documentMode?: string | undefined;
         readonly ui?: Record<string, any> | undefined;
+        readonly textTarget?: Record<string, any> | undefined;
+        readonly hyperlinkTarget?: Record<string, any> | undefined;
         readonly showInput?: boolean | undefined;
         readonly showLink?: boolean | undefined;
         readonly goToAnchor?: Function | undefined;
         readonly linkItem?: Record<string, any> | undefined;
         readonly closePopover?: Function | undefined;
         readonly clickedElement?: Record<string, any> | undefined;
-        readonly hyperlinkTarget?: Record<string, any> | undefined;
         readonly hyperlinkText?: string | undefined;
-        readonly textTarget?: Record<string, any> | undefined;
         readonly restoreSelection?: Function | undefined;
     };
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, HTMLDivElement>;

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

@@ -127,6 +127,10 @@ 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 { SuperDocCollaborationUpgradeError as __Cjs_SuperDocCollaborationUpgradeError } 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" };
@@ -270,6 +274,7 @@ import type { TrackedChangeSemanticColorKey as __Cjs_TrackedChangeSemanticColorK
 import type { TrackedChangeSemanticColorResolverInput as __Cjs_TrackedChangeSemanticColorResolverInput } from './index.js' with { "resolution-mode": "import" };
 import type { UIConfig as __Cjs_UIConfig } from './index.js' with { "resolution-mode": "import" };
 import type { UpgradeToCollaborationOptions as __Cjs_UpgradeToCollaborationOptions } from './index.js' with { "resolution-mode": "import" };
+import type { UpgradeToCollaborationResult as __Cjs_UpgradeToCollaborationResult } from './index.js' with { "resolution-mode": "import" };
 import type { User as __Cjs_User } from './index.js' with { "resolution-mode": "import" };
 import type { V2CollaborationConfig as __Cjs_V2CollaborationConfig } from './index.js' with { "resolution-mode": "import" };
 import type { ViewingOptions as __Cjs_ViewingOptions } from './index.js' with { "resolution-mode": "import" };
@@ -414,6 +419,10 @@ 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_SuperDocCollaborationUpgradeError as SuperDocCollaborationUpgradeError };
 export type { __Cjs_SuperDocCommandApi as SuperDocCommandApi };
 export type { __Cjs_SuperDocCommandExecuteContext as SuperDocCommandExecuteContext };
 export type { __Cjs_SuperDocCommandState as SuperDocCommandState };
@@ -557,6 +566,7 @@ export type { __Cjs_TrackedChangeSemanticColorKey as TrackedChangeSemanticColorK
 export type { __Cjs_TrackedChangeSemanticColorResolverInput as TrackedChangeSemanticColorResolverInput };
 export type { __Cjs_UIConfig as UIConfig };
 export type { __Cjs_UpgradeToCollaborationOptions as UpgradeToCollaborationOptions };
+export type { __Cjs_UpgradeToCollaborationResult as UpgradeToCollaborationResult };
 export type { __Cjs_User as User };
 export type { __Cjs_V2CollaborationConfig as V2CollaborationConfig };
 export type { __Cjs_ViewingOptions as ViewingOptions };

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';
@@ -178,6 +181,8 @@ export type { InteractionConfig } from '../core/types/index.js';
 export type { SurfacesConfig } from '../core/types/index.js';
 export type { UIConfig } from '../core/types/index.js';
 export type { UpgradeToCollaborationOptions } from '../core/types/index.js';
+export type { UpgradeToCollaborationResult } from '../core/types/index.js';
+export type { SuperDocCollaborationUpgradeError } from '../core/types/index.js';
 export type { V2CollaborationConfig } from '../core/types/index.js';
 export type { User } from '../core/types/index.js';
 export type { ViewOptions } from '../core/types/index.js';

package/dist/superdoc/src/public/ui/create-super-doc-ui.d.ts

@@ -1,4 +1,11 @@
-import { SuperDocUI, SuperDocUIOptions } from './types.js';
+import { CommandExecutionResult, SuperDocUI, SuperDocUIOptions } from './types.js';
+type FirstPartyCommandMutation = {
+    supports: (memberPath: string) => boolean;
+    run: (memberPath: string, args: readonly unknown[]) => unknown;
+    runListApply: (input: unknown) => Promise<boolean>;
+};
+export declare function registerFirstPartyCommandMutation(superdoc: object, host: object, mutation: FirstPartyCommandMutation): void;
+export declare function executeFirstPartyCommandAsync(ui: Pick<SuperDocUI, 'commands'>, id: string, payload?: unknown): Promise<CommandExecutionResult>;
 /**
  * Heavy-read policy for the async read coordinator (source-loading deferral).
  * One shared table: the coordinator's gate and the table-driven policy tests
@@ -16,3 +23,4 @@ export declare const HEAVY_DOC_READ_POLICY: readonly HeavyDocReadPolicyEntry[];
 /** Whether a coordinator cache key falls under the heavy-read policy. */
 export declare function isHeavyDocReadKey(key: string): boolean;
 export declare function createSuperDocUI(options: SuperDocUIOptions): SuperDocUI;
+export {};