superdoc 2.19.0-next.1 → 2.19.0-next.3

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.19.0-next.1",
+	superdocVersion: "2.19.0-next.3",
 	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.19.0-next.1",
+	superdocVersion: "2.19.0-next.3",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/document-api/src/types/track-changes.types.d.ts

@@ -57,6 +57,32 @@ export interface TrackChangeWordRevisionIds {
 /** Durable membership of one authored text rewrite; children can be decided individually. */
 export interface TrackChangeRewriteReviewGroup {
     kind: 'text-rewrite';
+    /**
+     * Provenance basis for this review group, distinct from the unrelated flat
+     * {@link TrackChangeInfo.origin} (importing platform, e.g. Word/Google
+     * Docs). `'authored-operation'` here reflects an authored `text.rewrite`
+     * transaction (spec SD-5189 CASE-3).
+     */
+    groupOrigin: 'authored-operation';
+    role: 'parent' | 'child';
+    parentId?: string;
+    childChangeIds: readonly string[];
+    members: readonly {
+        id: string;
+        type: TrackChangeBroadType;
+        subtype: string;
+        sourceIds: TrackChangeSourceIds;
+    }[];
+}
+/**
+ * Durable membership of one document-comparison hunk; children can be
+ * decided individually. Distinct from {@link TrackChangeRewriteReviewGroup}:
+ * a comparison hunk originates from `diff.apply({changeMode:'tracked'})`,
+ * not an authored rewrite transaction (spec SD-4953, SD-5189 CASE-2/CASE-3).
+ */
+export interface TrackChangeComparisonHunkReviewGroup {
+    kind: 'comparison-hunk';
+    groupOrigin: 'comparison-hunk';
     role: 'parent' | 'child';
     parentId?: string;
     childChangeIds: readonly string[];
@@ -67,6 +93,13 @@ export interface TrackChangeRewriteReviewGroup {
         sourceIds: TrackChangeSourceIds;
     }[];
 }
+/**
+ * Public review-group union (spec SD-5189 CASE-3). Only the two producer
+ * kinds this contract covers today; whether the kernel's other internal
+ * review-group kinds (formatting/structural/list-delta variants) also need
+ * public projection is an open question left to whoever owns those surfaces.
+ */
+export type TrackChangeReviewGroup = TrackChangeRewriteReviewGroup | TrackChangeComparisonHunkReviewGroup;
 /**
  * Canonical multi-side source provenance per spec §3 / §4. Each value is
  * raw, source-format identity (Word `w:id`, `w:rsidR` / `w:rsidDel`, future
@@ -519,7 +552,7 @@ export interface TrackChangeInfo {
     wordRevisionIds?: TrackChangeWordRevisionIds;
     /** Stable revision-group id (spec §3, fragment lineage). */
     revisionGroupId?: string;
-    reviewGroup?: TrackChangeRewriteReviewGroup;
+    reviewGroup?: TrackChangeReviewGroup;
     /** Set to the retired source id when this change is a partial-split fragment; otherwise `null`. */
     splitFromId?: string | null;
     /** Replacement side metadata (`grouped` mode replacements only). */
@@ -651,7 +684,7 @@ export interface TrackChangeDomain {
     structuralDescriptor?: TrackChangeStructuralDescriptor;
     /** Stable revision-group id. */
     revisionGroupId?: string;
-    reviewGroup?: TrackChangeRewriteReviewGroup;
+    reviewGroup?: TrackChangeReviewGroup;
     /** Set to the retired source id when this list item is a partial-split fragment; otherwise `null`. */
     splitFromId?: string | null;
     /**

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

@@ -149,15 +149,16 @@ export declare class SuperDoc extends EventEmitter<SuperDocEventMap> {
      * and throw a clear lifecycle error instead.
      */
     users: User[];
-    /** Yjs document for collaboration; set in `#init` when collaboration is enabled, otherwise undefined. */
+    /**
+     * Not set in v2. SuperDoc owns the collaboration `Y.Doc` inside its
+     * collaboration worker and does not expose it on the main thread.
+     */
     ydoc: Y.Doc | undefined;
     /**
-     * Provider for the SuperDoc-level collaboration room (separate from
-     * per-document providers). Widened to `CollaborationProvider` to match
-     * the runtime, which stores whatever provider the consumer passed via
-     * `Config.modules.collaboration.provider`. Consumers needing Hocuspocus-
-     * specific members must narrow before use.
-     *
+     * Collaboration provider facade for the active v2 room. It is not a
+     * provider instance: SuperDoc owns the provider inside its collaboration
+     * worker, and this object only offers `sendStateless(message)`. It is
+     * `undefined` or `null` when no room is open.
      */
     provider: CollaborationProvider | undefined;
     /**

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

@@ -1023,14 +1023,16 @@ export interface Document {
     isNewFile?: boolean;
     /** Password for this encrypted DOCX. Overrides top-level `Config.password`. */
     password?: string;
-    /** The Yjs document for collaboration. */
+    /**
+     * Not set in v2 and cannot be supplied. SuperDoc owns the collaboration
+     * `Y.Doc` inside its worker; configure the room with `collaboration`.
+     */
     ydoc?: YDoc;
     /**
-     * The provider for collaboration. Widened from `HocuspocusProvider` to
-     * `CollaborationProvider` to match the runtime, which stores whatever
-     * provider the consumer passed via `Config.modules.collaboration.provider`
-     * (HocuspocusProvider, LiveblocksYjsProvider, TiptapCollabProvider, etc.).
-     * Consumers needing Hocuspocus-specific members must narrow before use.
+     * Collaboration provider facade for this document's v2 room. It is not a
+     * provider instance and cannot be supplied: SuperDoc owns the provider
+     * inside its collaboration worker, and this object only offers
+     * `sendStateless(message)`. Configure the room with `collaboration`.
      */
     provider?: CollaborationProvider;
     /**
@@ -1143,19 +1145,30 @@ export interface RuntimeDocument extends Document {
      */
     removeComments?: () => void;
 }
-/** Collaboration module configuration. */
+/**
+ * SuperDoc v1 collaboration module configuration.
+ *
+ * SuperDoc v2 rejects this configuration at runtime: it owns the `Y.Doc` and
+ * provider inside its collaboration worker, so it neither attaches an external
+ * `{ ydoc, provider }` pair nor opens the internal provider these fields
+ * describe. Configure a room with `document.collaboration`
+ * (`DocumentCollaborationConfig`) instead. To keep an existing provider setup,
+ * see https://docs.superdoc.dev/editor/collaboration/use-your-own-provider
+ *
+ * @deprecated replaceWith=`DocumentCollaborationConfig` removeIn=v3.0
+ */
 export interface CollaborationConfig {
-    /** External Yjs document (provider-agnostic mode). */
+    /** SuperDoc v1 external Yjs document. Rejected by v2, which owns its `Y.Doc`. */
     ydoc?: YDoc;
-    /** External collaboration provider (provider-agnostic mode). */
+    /** SuperDoc v1 external provider. Rejected by v2, which owns its provider. */
     provider?: CollaborationProvider;
-    /** Internal provider type (deprecated). */
+    /** SuperDoc v1 internal provider type. Use `DocumentCollaborationConfig.providerType`. */
     providerType?: 'hocuspocus' | 'superdoc';
-    /** WebSocket URL for internal provider (deprecated). */
+    /** SuperDoc v1 internal provider URL. Use `DocumentCollaborationConfig` `serverUrl`. */
     url?: string;
-    /** Authentication token for internal provider (deprecated). */
+    /** SuperDoc v1 internal provider token. Use `DocumentCollaborationConfig` `token`. */
     token?: string;
-    /** Additional params for internal provider (deprecated). */
+    /** SuperDoc v1 internal provider params. Use `DocumentCollaborationConfig` `params`. */
     params?: object;
 }
 /**
@@ -2548,7 +2561,12 @@ export interface Modules {
         /** Canvas render scale (quality). */
         outputScale?: number;
     } & Record<string, unknown>;
-    /** Collaboration module configuration. */
+    /**
+     * SuperDoc v1 collaboration module. SuperDoc v2 refuses it at runtime and
+     * attaches nothing; configure `document.collaboration` instead.
+     *
+     * @deprecated replaceWith=`Document.collaboration` removeIn=v3.0
+     */
     collaboration?: CollaborationConfig;
     /**
      * Toolbar module configuration. Pass `true` to configure the toolbar with

package/dist/superdoc.cjs

@@ -316,7 +316,7 @@ var shuffleArray = (array) => {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.19.0-next.1";
+		return "2.19.0-next.3";
 	} catch {
 		return "unknown";
 	}
@@ -5456,13 +5456,13 @@ function resolveProviderExtension(candidate) {
 	if (!adapterId) return {
 		ok: false,
 		reason: "invalid-adapter-id",
-		message: "SuperDoc v2 provider extensions require a non-empty v2Collaboration.adapterId."
+		message: "SuperDoc v2 provider extensions require a non-empty collaboration.adapterId."
 	};
 	const documentId = normalizeNonEmptyString(candidate.documentId);
 	if (!documentId) return {
 		ok: false,
 		reason: "invalid-document-id",
-		message: "SuperDoc v2 provider extensions require a non-empty v2Collaboration.documentId."
+		message: "SuperDoc v2 provider extensions require a non-empty collaboration.documentId."
 	};
 	const roomMode = normalizeRoomMode(candidate.roomMode);
 	if (!roomMode) return invalidRoomMode();
@@ -45686,7 +45686,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.19.0-next.1";
+		this.version = "2.19.0-next.3";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || require_uuid.v4();
 		this.colors = this.config.colors ?? [];
@@ -47078,7 +47078,7 @@ var SuperDoc = class extends require_eventemitter3.import_eventemitter3.default
 			{
 				feature: "shell.collaboration",
 				status: "supported",
-				reason: "v2 single-doc y-websocket collaboration is wired through document.v2Collaboration, including collaboration-ready, awareness-update, and locked event bridges; arbitrary external { ydoc, provider } adapters remain unsupported"
+				reason: "v2 single-doc collaboration (hocuspocus, y-websocket, liveblocks, and registered provider extensions) is wired through document.collaboration, including collaboration-ready, awareness-update, and locked event bridges; external { ydoc, provider } instances remain unsupported"
 			},
 			{
 				feature: "shell.context-menu",

package/dist/superdoc.es.js

@@ -315,7 +315,7 @@ var shuffleArray = (array) => {
 var DEFAULT_ENDPOINT = "https://ingest.superdoc.dev/v1/collect";
 function getSuperdocVersion() {
 	try {
-		return "2.19.0-next.1";
+		return "2.19.0-next.3";
 	} catch {
 		return "unknown";
 	}
@@ -5455,13 +5455,13 @@ function resolveProviderExtension(candidate) {
 	if (!adapterId) return {
 		ok: false,
 		reason: "invalid-adapter-id",
-		message: "SuperDoc v2 provider extensions require a non-empty v2Collaboration.adapterId."
+		message: "SuperDoc v2 provider extensions require a non-empty collaboration.adapterId."
 	};
 	const documentId = normalizeNonEmptyString(candidate.documentId);
 	if (!documentId) return {
 		ok: false,
 		reason: "invalid-document-id",
-		message: "SuperDoc v2 provider extensions require a non-empty v2Collaboration.documentId."
+		message: "SuperDoc v2 provider extensions require a non-empty collaboration.documentId."
 	};
 	const roomMode = normalizeRoomMode(candidate.roomMode);
 	if (!roomMode) return invalidRoomMode();
@@ -45617,7 +45617,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.19.0-next.1";
+		this.version = "2.19.0-next.3";
 		this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
 		this.superdocId = config.superdocId || v4();
 		this.colors = this.config.colors ?? [];
@@ -47009,7 +47009,7 @@ var SuperDoc = class extends import_eventemitter3.default {
 			{
 				feature: "shell.collaboration",
 				status: "supported",
-				reason: "v2 single-doc y-websocket collaboration is wired through document.v2Collaboration, including collaboration-ready, awareness-update, and locked event bridges; arbitrary external { ydoc, provider } adapters remain unsupported"
+				reason: "v2 single-doc collaboration (hocuspocus, y-websocket, liveblocks, and registered provider extensions) is wired through document.collaboration, including collaboration-ready, awareness-update, and locked event bridges; external { ydoc, provider } instances remain unsupported"
 			},
 			{
 				feature: "shell.context-menu",