@superdoc-dev/react 1.0.0-canary.3 → 1.0.0-canary.5

package/README.md

@@ -1,11 +1,11 @@
-# @superdoc/react
+# @superdoc-dev/react
 
 Official React wrapper for [SuperDoc](https://www.superdoc.dev).
 
 ## Installation
 
 ```bash
-npm install @superdoc/react
+npm install @superdoc-dev/react
 ```
 
 > `superdoc` is included as a dependency - no need to install it separately.
@@ -13,8 +13,8 @@ npm install @superdoc/react
 ## Quick Start
 
 ```tsx
-import { SuperDocEditor } from '@superdoc/react';
-import '@superdoc/react/style.css';
+import { SuperDocEditor } from '@superdoc-dev/react';
+import '@superdoc-dev/react/style.css';
 
 function App() {
   return <SuperDocEditor document={file} />;
@@ -45,7 +45,7 @@ Access SuperDoc methods via `getInstance()`:
 
 ```tsx
 import { useRef } from 'react';
-import { SuperDocEditor, SuperDocRef } from '@superdoc/react';
+import { SuperDocEditor, SuperDocRef } from '@superdoc-dev/react';
 
 function App() {
   const ref = useRef<SuperDocRef>(null);
@@ -134,7 +134,7 @@ function Editor() {
 import dynamic from 'next/dynamic';
 
 const SuperDocEditor = dynamic(
-  () => import('@superdoc/react').then((m) => m.SuperDocEditor),
+  () => import('@superdoc-dev/react').then((m) => m.SuperDocEditor),
   { ssr: false }
 );
 ```
@@ -148,7 +148,7 @@ import type {
   DocumentMode,
   UserRole,
   SuperDocUser,
-} from '@superdoc/react';
+} from '@superdoc-dev/react';
 ```
 
 Types are extracted from the `superdoc` package, ensuring they stay in sync.

package/dist/index.d.ts

@@ -5,14 +5,42 @@
  */
 
 import { CSSProperties } from 'react';
+import { Editor } from 'superdoc';
 import { ForwardRefExoticComponent } from 'react';
 import { ReactNode } from 'react';
 import { RefAttributes } from 'react';
 import { SuperDoc } from 'superdoc';
 
+/**
+ * Explicitly typed callback props to ensure proper TypeScript inference.
+ * These override any loosely-typed callbacks from SuperDocConfig.
+ */
+declare interface CallbackProps {
+    /** Callback when SuperDoc is ready */
+    onReady?: (event: SuperDocReadyEvent) => void;
+    /** Callback after an editor is created */
+    onEditorCreate?: (event: SuperDocEditorCreateEvent) => void;
+    /** Callback when editor is destroyed */
+    onEditorDestroy?: () => void;
+    /** Callback when document content is updated */
+    onEditorUpdate?: (event: SuperDocEditorUpdateEvent) => void;
+    /** Callback when there is a content parsing error */
+    onContentError?: (event: SuperDocContentErrorEvent) => void;
+    /** Callback when an exception is thrown */
+    onException?: (event: SuperDocExceptionEvent) => void;
+}
+
 /** Document mode - extracted from Config.documentMode */
 export declare type DocumentMode = NonNullable<SuperDocConstructorConfig['documentMode']>;
 
+export { Editor }
+
+/**
+ * Callback props that are explicitly typed in CallbackProps.
+ * These are excluded from SuperDocConfig to avoid type conflicts.
+ */
+declare type ExplicitCallbackProps = 'onReady' | 'onEditorCreate' | 'onEditorDestroy' | 'onEditorUpdate' | 'onContentError' | 'onException';
+
 /**
  * Props managed internally by the React component (not exposed to users).
  * - selector: managed by component (creates internal container)
@@ -45,7 +73,7 @@ declare interface ReactProps {
 export declare type SuperDocConfig = SuperDocConstructorConfig;
 
 /**
- * Types for @superdoc/react
+ * Types for @superdoc-dev/react
  *
  * Core types are extracted from the SuperDoc constructor parameter type,
  * ensuring they stay in sync with the superdoc package.
@@ -53,6 +81,14 @@ export declare type SuperDocConfig = SuperDocConstructorConfig;
 /** SuperDoc constructor config - extracted from superdoc package */
 declare type SuperDocConstructorConfig = ConstructorParameters<typeof SuperDoc>[0];
 
+/** Event passed to onContentError callback */
+export declare interface SuperDocContentErrorEvent {
+    error: Error;
+    editor: Editor;
+    documentId: string;
+    file: File;
+}
+
 /**
  * SuperDocEditor component with forwardRef - Initializes SuperDoc instance and handles cleanup.
  */
@@ -60,16 +96,30 @@ declare const SuperDocEditor: ForwardRefExoticComponent<SuperDocEditorProps & Re
 export { SuperDocEditor }
 export default SuperDocEditor;
 
+/** Event passed to onEditorCreate callback */
+export declare interface SuperDocEditorCreateEvent {
+    editor: Editor;
+}
+
 /**
  * Props for SuperDocEditor component.
  *
  * Extends SuperDocConfig (minus internal props) with React-specific additions.
  * When new props are added to SuperDoc core, they're automatically available here.
  *
- * Note: All callback types (onReady, onEditorCreate, etc.) come directly from
- * SuperDocConfig, ensuring type compatibility with the core package.
+ * Callback props are explicitly typed to ensure proper TypeScript inference.
  */
-export declare interface SuperDocEditorProps extends Omit<SuperDocConfig, InternalProps | OptionalInReact>, Partial<Pick<SuperDocConfig, OptionalInReact>>, ReactProps {
+export declare interface SuperDocEditorProps extends Omit<SuperDocConfig, InternalProps | OptionalInReact | ExplicitCallbackProps>, Partial<Pick<SuperDocConfig, OptionalInReact>>, CallbackProps, ReactProps {
+}
+
+/** Event passed to onEditorUpdate callback */
+export declare interface SuperDocEditorUpdateEvent {
+    editor: Editor;
+}
+
+/** Event passed to onException callback */
+export declare interface SuperDocExceptionEvent {
+    error: Error;
 }
 
 /** SuperDoc instance type - from superdoc package */
@@ -78,6 +128,11 @@ export declare type SuperDocInstance = InstanceType<typeof SuperDoc>;
 /** Modules configuration - extracted from Config.modules */
 export declare type SuperDocModules = NonNullable<SuperDocConstructorConfig['modules']>;
 
+/** Event passed to onReady callback */
+export declare interface SuperDocReadyEvent {
+    superdoc: SuperDocInstance;
+}
+
 /**
  * Ref interface for SuperDocEditor component
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/react",
-  "version": "1.0.0-canary.3",
+  "version": "1.0.0-canary.5",
   "description": "Official React wrapper for SuperDoc document editor",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -35,7 +35,7 @@
   ],
   "license": "AGPL-3.0",
   "dependencies": {
-    "superdoc": "workspace:^"
+    "superdoc": ">=1.0.0"
   },
   "peerDependencies": {
     "react": ">=16.8.0",