@superdoc-dev/react 1.16.0 → 2.0.0-next.2

package/README.md

@@ -5,38 +5,12 @@ Official React wrapper for [SuperDoc](https://www.superdoc.dev).
 ## Installation
 
 ```bash
-npm install @superdoc-dev/react
+pnpm add @superdoc-dev/react@next
 ```
 
-> `superdoc` is included as a dependency - no need to install it separately.
+The V2 prerelease installs its matching `superdoc@2` version automatically.
 
-## Pinning SuperDoc Version (Optional)
-
-If you need to force a specific `superdoc` version (for example, to align multiple apps or test a local build), pin it in your app's `package.json` using overrides.
-
-### npm
-
-```json
-{
-  "overrides": {
-    "superdoc": "1.14.1"
-  }
-}
-```
-
-### pnpm
-
-```json
-{
-  "pnpm": {
-    "overrides": {
-      "superdoc": "1.14.1"
-    }
-  }
-}
-```
-
-Then run your package manager install command again.
+The React and SuperDoc V2 prereleases are released together and use exact matching versions. Do not override `superdoc` independently.
 
 ## Quick Start
 
@@ -191,9 +165,13 @@ function Editor() {
 
 ```tsx
 <SuperDocEditor
-  document={file}
-  modules={{
-    collaboration: { ydoc, provider },
+  document={{
+    type: 'docx',
+    data: file,
+    v2Collaboration: {
+      documentId: 'contract-123',
+      serverUrl: 'wss://collab.example.com',
+    },
   }}
 />
 ```

package/dist/index.d.ts

@@ -1,11 +1,9 @@
 import { CSSProperties } from 'react';
-import { Editor } from 'superdoc';
 import { ForwardRefExoticComponent } from 'react';
 import { ReactNode } from 'react';
 import { RefAttributes } from 'react';
 import { SuperDoc } from 'superdoc';
 import { SuperDocExceptionPayload } from 'superdoc';
-import { Transaction } from 'superdoc';
 
 /**
  * Explicitly typed callback props to ensure proper TypeScript inference.
@@ -35,8 +33,6 @@ export declare interface CallbackProps {
 /** Document mode - extracted from Config.documentMode */
 export declare type DocumentMode = NonNullable<SuperDocConstructorConfig['documentMode']>;
 
-export { Editor }
-
 /** Surface where an editor event originated. */
 export declare type EditorSurface = 'body' | 'header' | 'footer';
 
@@ -77,6 +73,12 @@ declare interface ReactProps {
     style?: CSSProperties;
 }
 
+declare type SuperDocActiveEditor = NonNullable<SuperDocInstance['activeEditor']>;
+
+declare type SuperDocActiveEditorDoc = SuperDocActiveEditor extends {
+    doc?: infer T;
+} ? T : never;
+
 /** Full SuperDoc config - extracted from constructor */
 export declare type SuperDocConfig = SuperDocConstructorConfig;
 
@@ -107,9 +109,7 @@ export { SuperDocEditor }
 export default SuperDocEditor;
 
 /** Event passed to onEditorCreate callback */
-export declare interface SuperDocEditorCreateEvent {
-    editor: Editor;
-}
+export declare type SuperDocEditorCreateEvent = Parameters<NonNullable<SuperDocConfig['onEditorCreate']>>[0];
 
 /**
  * Props for SuperDocEditor component.
@@ -123,18 +123,7 @@ export declare interface SuperDocEditorProps extends Omit<SuperDocConfig, Intern
 }
 
 /** Event passed to onEditorUpdate callback. Mirrors superdoc's EditorUpdateEvent. */
-export declare interface SuperDocEditorUpdateEvent {
-    /** The primary editor associated with the update. For header/footer edits, this is the main body editor. */
-    editor: Editor;
-    /** The editor instance that emitted the update. For body edits, this matches `editor`. */
-    sourceEditor: Editor;
-    /** The surface where the edit originated. */
-    surface: EditorSurface;
-    /** Relationship ID for header/footer edits. */
-    headerId?: string | null;
-    /** Header/footer variant (`default`, `first`, `even`, `odd`) when available. */
-    sectionType?: string | null;
-}
+export declare type SuperDocEditorUpdateEvent = Parameters<NonNullable<SuperDocConfig['onEditorUpdate']>>[0];
 
 /**
  * Event passed to onException callback. Re-exports the core union so
@@ -152,9 +141,7 @@ export declare type SuperDocInstance = InstanceType<typeof SuperDoc>;
 export declare type SuperDocModules = NonNullable<SuperDocConstructorConfig['modules']>;
 
 /** Event passed to onReady callback */
-export declare interface SuperDocReadyEvent {
-    superdoc: SuperDocInstance;
-}
+export declare type SuperDocReadyEvent = Parameters<NonNullable<SuperDocConfig['onReady']>>[0];
 
 /**
  * Ref interface for SuperDocEditor component
@@ -164,24 +151,31 @@ export declare interface SuperDocRef {
     getInstance(): SuperDocInstance | null;
 }
 
-/** Event passed to onTransaction callback. Mirrors superdoc's EditorTransactionEvent. */
-export declare interface SuperDocTransactionEvent {
-    /** The primary editor associated with the transaction. For header/footer edits, this is the main body editor. */
-    editor: Editor;
-    /** The editor instance that emitted the transaction. For body edits, this matches `editor`. */
-    sourceEditor: Editor;
-    /** The ProseMirror transaction emitted by the source editor. */
-    transaction: Transaction;
-    /** Time spent applying the transaction, in milliseconds. */
-    duration?: number;
-    /** The surface where the transaction originated. */
-    surface: EditorSurface;
-    /** Relationship ID for header/footer edits. */
-    headerId?: string | null;
-    /** Header/footer variant (`default`, `first`, `even`, `odd`) when available. */
-    sectionType?: string | null;
+/**
+ * Runtime editor facade reported by `superdoc@2` callback events.
+ *
+ * v2 no longer exposes the v1 ProseMirror/Tiptap `Editor` type. Consumers that
+ * need document operations should use the SuperDoc instance and Document API;
+ * callback editor values are intentionally structural runtime evidence.
+ */
+export declare interface SuperDocRuntimeEditor {
+    editorVersion?: 2;
+    /**
+     * The public, read-only-guarded browser Document API facade for the active
+     * editor in inline v2 mode (`editor.doc`). Derived from the `superdoc`
+     * instance type so this wrapper does not need its own Document API package
+     * dependency.
+     */
+    doc?: SuperDocActiveEditorDoc;
+    [key: string]: unknown;
 }
 
+/** Transaction-like payload emitted by the runtime. v2 does not expose a ProseMirror transaction type. */
+export declare type SuperDocRuntimeTransaction = unknown;
+
+/** Event passed to onTransaction callback. Mirrors superdoc's EditorTransactionEvent. */
+export declare type SuperDocTransactionEvent = Parameters<NonNullable<SuperDocConfig['onTransaction']>>[0];
+
 /** User object - extracted from Config.user */
 export declare type SuperDocUser = NonNullable<SuperDocConstructorConfig['user']>;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/react",
-  "version": "1.16.0",
+  "version": "2.0.0-next.2",
   "description": "Official React wrapper for the SuperDoc document editor",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -27,12 +27,12 @@
   ],
   "license": "AGPL-3.0",
   "dependencies": {
-    "superdoc": ">=1.0.0"
+    "superdoc": "2.0.0-next.26"
   },
   "peerDependencies": {
     "react": ">=16.8.0",
     "react-dom": ">=16.8.0",
-    "superdoc": ">=1.0.0"
+    "superdoc": "2.0.0-next.26"
   },
   "devDependencies": {
     "@testing-library/react": "^16.3.0",