@superdoc-dev/react 1.2.0-next.34 → 1.2.0-next.36

package/dist/index.cjs

@@ -1 +1 @@
-Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));let c=require(`react`);c=s(c);let l=require(`react/jsx-runtime`);function u(){let e=c.useRef(null);return e.current===null&&(e.current=`-${Date.now()}-${Math.random().toString(36).slice(2,9)}`),e.current}const d=typeof c.useId==`function`?c.useId:u;function f(e){let t=c.useRef(e),n=c.useRef(e);return t.current!==e&&(p(n.current,e)||(n.current=e),t.current=e),n.current}function p(e,t){if(e===t)return!0;if(e==null||t==null)return e===t;try{return JSON.stringify(e)===JSON.stringify(t)}catch{return!1}}function m(e,t){let[n,r]=(0,c.useState)(!1),{id:i,renderLoading:a,hideToolbar:o=!1,contained:s=!1,className:u,style:p,onReady:m,onEditorCreate:h,onEditorDestroy:g,onEditorUpdate:_,onContentError:v,onException:y,document:b,user:x,users:S,modules:C,...w}=e,T=e.documentMode??`editing`,E=e.role??`editor`,D=f(x),O=f(S),k=(0,c.useRef)(null),A=(0,c.useRef)(null),j=d(),M=i??`superdoc${j}`,N=M,P=`${M}-toolbar`,[F,I]=(0,c.useState)(!0),L=(0,c.useRef)({onReady:m,onEditorCreate:h,onEditorDestroy:g,onEditorUpdate:_,onContentError:v,onException:y});(0,c.useEffect)(()=>{L.current={onReady:m,onEditorCreate:h,onEditorDestroy:g,onEditorUpdate:_,onContentError:v,onException:y}},[m,h,g,_,v,y]);let R=(0,c.useRef)(null),z=(0,c.useRef)(!1),B=(0,c.useRef)(T);(0,c.useEffect)(()=>{B.current!==T&&(k.current?k.current.setDocumentMode(T):z.current&&(R.current=T)),B.current=T},[T]),(0,c.useImperativeHandle)(t,()=>({getInstance:()=>k.current}),[]),(0,c.useEffect)(()=>{I(!0),r(!1),z.current=!0;let e=!1,t=null;return(async()=>{try{let n=(await import(`superdoc`)).SuperDoc;if(e)return;t=new n({...w,selector:`#${CSS.escape(N)}`,...!o&&A.current?{toolbar:`#${CSS.escape(P)}`}:{},documentMode:T,role:E,contained:s,...b==null?{}:{document:b},...D?{user:D}:{},...O?{users:O}:{},...C?{modules:C}:{},onReady:t=>{e||(I(!1),z.current=!1,R.current&&R.current!==T&&(t.superdoc.setDocumentMode(R.current),R.current=null),L.current.onReady?.(t))},onEditorCreate:t=>{e||L.current.onEditorCreate?.(t)},onEditorDestroy:()=>{e||L.current.onEditorDestroy?.()},onEditorUpdate:t=>{e||L.current.onEditorUpdate?.(t)},onContentError:t=>{e||L.current.onContentError?.(t)},onException:t=>{e||L.current.onException?.(t)}}),k.current=t}catch(t){e||(z.current=!1,I(!1),r(!0),console.error(`[SuperDocEditor] Failed to initialize SuperDoc:`,t),L.current.onException?.({error:t}))}})(),()=>{z.current=!1,R.current=null,t&&(t.destroy(),k.current=null),e=!0}},[b,D,O,C,E,o,s,N,P]);let V=[`superdoc-wrapper`,u].filter(Boolean).join(` `),H=F?{display:`none`}:void 0;return(0,l.jsxs)(`div`,{className:V,style:{...p,...s&&{display:`flex`,flexDirection:`column`}},children:[!o&&(0,l.jsx)(`div`,{ref:A,id:P,className:`superdoc-toolbar-container`,style:H}),(0,l.jsx)(`div`,{id:N,className:`superdoc-editor-container`,style:{...H,...s&&{flex:1,minHeight:0}}}),F&&!n&&a&&(0,l.jsx)(`div`,{className:`superdoc-loading-container`,children:a()}),n&&(0,l.jsx)(`div`,{className:`superdoc-error-container`,children:`Failed to load editor. Check console for details.`})]})}const h=(0,c.forwardRef)(m);h.displayName=`SuperDocEditor`;var g=h;exports.SuperDocEditor=h,exports.default=g;
+Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));let c=require(`react`);c=s(c);let l=require(`react/jsx-runtime`);function u(){let e=c.useRef(null);return e.current===null&&(e.current=`-${Date.now()}-${Math.random().toString(36).slice(2,9)}`),e.current}const d=typeof c.useId==`function`?c.useId:u;function f(e){let t=c.useRef(e),n=c.useRef(e);return t.current!==e&&(p(n.current,e)||(n.current=e),t.current=e),n.current}function p(e,t){if(e===t)return!0;if(e==null||t==null)return e===t;try{return JSON.stringify(e)===JSON.stringify(t)}catch{return!1}}function m(e,t){let[n,r]=(0,c.useState)(!1),{id:i,renderLoading:a,hideToolbar:o=!1,contained:s=!1,className:u,style:p,onReady:m,onEditorCreate:h,onEditorDestroy:g,onEditorUpdate:_,onTransaction:v,onContentError:y,onException:b,document:x,user:S,users:C,modules:w,...T}=e,E=e.documentMode??`editing`,D=e.role??`editor`,O=f(S),k=f(C),A=(0,c.useRef)(null),j=(0,c.useRef)(null),M=d(),N=i??`superdoc${M}`,P=N,F=`${N}-toolbar`,[I,L]=(0,c.useState)(!0),R=(0,c.useRef)({onReady:m,onEditorCreate:h,onEditorDestroy:g,onEditorUpdate:_,onTransaction:v,onContentError:y,onException:b});(0,c.useEffect)(()=>{R.current={onReady:m,onEditorCreate:h,onEditorDestroy:g,onEditorUpdate:_,onTransaction:v,onContentError:y,onException:b}},[m,h,g,_,v,y,b]);let z=(0,c.useRef)(null),B=(0,c.useRef)(!1),V=(0,c.useRef)(E);(0,c.useEffect)(()=>{V.current!==E&&(A.current?A.current.setDocumentMode(E):B.current&&(z.current=E)),V.current=E},[E]),(0,c.useImperativeHandle)(t,()=>({getInstance:()=>A.current}),[]),(0,c.useEffect)(()=>{L(!0),r(!1),B.current=!0;let e=!1,t=null;return(async()=>{try{let n=(await import(`superdoc`)).SuperDoc;if(e)return;t=new n({...T,selector:`#${CSS.escape(P)}`,...!o&&j.current?{toolbar:`#${CSS.escape(F)}`}:{},documentMode:E,role:D,contained:s,...x==null?{}:{document:x},...O?{user:O}:{},...k?{users:k}:{},...w?{modules:w}:{},onReady:t=>{e||(L(!1),B.current=!1,z.current&&z.current!==E&&(t.superdoc.setDocumentMode(z.current),z.current=null),R.current.onReady?.(t))},onEditorCreate:t=>{e||R.current.onEditorCreate?.(t)},onEditorDestroy:()=>{e||R.current.onEditorDestroy?.()},onEditorUpdate:t=>{e||R.current.onEditorUpdate?.(t)},onTransaction:t=>{e||R.current.onTransaction?.(t)},onContentError:t=>{e||R.current.onContentError?.(t)},onException:t=>{e||R.current.onException?.(t)}}),A.current=t}catch(t){e||(B.current=!1,L(!1),r(!0),console.error(`[SuperDocEditor] Failed to initialize SuperDoc:`,t),R.current.onException?.({error:t}))}})(),()=>{B.current=!1,z.current=null,t&&(t.destroy(),A.current=null),e=!0}},[x,O,k,w,D,o,s,P,F]);let H=[`superdoc-wrapper`,u].filter(Boolean).join(` `),U=I?{display:`none`}:void 0;return(0,l.jsxs)(`div`,{className:H,style:{...p,...s&&{display:`flex`,flexDirection:`column`}},children:[!o&&(0,l.jsx)(`div`,{ref:j,id:F,className:`superdoc-toolbar-container`,style:U}),(0,l.jsx)(`div`,{id:P,className:`superdoc-editor-container`,style:{...U,...s&&{flex:1,minHeight:0}}}),I&&!n&&a&&(0,l.jsx)(`div`,{className:`superdoc-loading-container`,children:a()}),n&&(0,l.jsx)(`div`,{className:`superdoc-error-container`,children:`Failed to load editor. Check console for details.`})]})}const h=(0,c.forwardRef)(m);h.displayName=`SuperDocEditor`;var g=h;exports.SuperDocEditor=h,exports.default=g;

package/dist/index.d.ts

@@ -18,6 +18,8 @@ export declare interface CallbackProps {
     onEditorDestroy?: () => void;
     /** Callback when document content is updated */
     onEditorUpdate?: (event: SuperDocEditorUpdateEvent) => void;
+    /** Callback when a transaction is emitted */
+    onTransaction?: (event: SuperDocTransactionEvent) => void;
     /** Callback when there is a content parsing error */
     onContentError?: (event: SuperDocContentErrorEvent) => void;
     /** Callback when an exception is thrown */
@@ -36,7 +38,7 @@ export declare type EditorSurface = 'body' | 'header' | 'footer';
  * 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';
+declare type ExplicitCallbackProps = 'onReady' | 'onEditorCreate' | 'onEditorDestroy' | 'onEditorUpdate' | 'onTransaction' | 'onContentError' | 'onException';
 
 /**
  * Props managed internally by the React component (not exposed to users).
@@ -152,6 +154,24 @@ 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 or transaction-like payload emitted by the source editor. */
+    transaction: any;
+    /** 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;
+}
+
 /** User object - extracted from Config.user */
 export declare type SuperDocUser = NonNullable<SuperDocConstructorConfig['user']>;
 

package/dist/index.js

@@ -20,22 +20,24 @@ function shallowJsonEqual(e, s) {
 	}
 }
 function SuperDocEditorInner(e, s) {
-	let [u, d] = useState(!1), { id: f, renderLoading: p, hideToolbar: m = !1, contained: h = !1, className: g, style: _, onReady: v, onEditorCreate: y, onEditorDestroy: b, onEditorUpdate: x, onContentError: S, onException: C, document: w, user: T, users: E, modules: D, ...O } = e, k = e.documentMode ?? "editing", A = e.role ?? "editor", j = useMemoByValue(T), M = useMemoByValue(E), N = useRef(null), P = useRef(null), F = useStableId(), I = f ?? `superdoc${F}`, L = I, R = `${I}-toolbar`, [z, B] = useState(!0), V = useRef({
+	let [u, d] = useState(!1), { id: f, renderLoading: p, hideToolbar: m = !1, contained: h = !1, className: g, style: _, onReady: v, onEditorCreate: y, onEditorDestroy: b, onEditorUpdate: x, onTransaction: S, onContentError: C, onException: w, document: T, user: E, users: D, modules: O, ...k } = e, A = e.documentMode ?? "editing", j = e.role ?? "editor", M = useMemoByValue(E), N = useMemoByValue(D), P = useRef(null), F = useRef(null), I = useStableId(), L = f ?? `superdoc${I}`, R = L, z = `${L}-toolbar`, [B, V] = useState(!0), H = useRef({
 		onReady: v,
 		onEditorCreate: y,
 		onEditorDestroy: b,
 		onEditorUpdate: x,
-		onContentError: S,
-		onException: C
+		onTransaction: S,
+		onContentError: C,
+		onException: w
 	});
 	useEffect(() => {
-		V.current = {
+		H.current = {
 			onReady: v,
 			onEditorCreate: y,
 			onEditorDestroy: b,
 			onEditorUpdate: x,
-			onContentError: S,
-			onException: C
+			onTransaction: S,
+			onContentError: C,
+			onException: w
 		};
 	}, [
 		v,
@@ -43,68 +45,72 @@ function SuperDocEditorInner(e, s) {
 		b,
 		x,
 		S,
-		C
+		C,
+		w
 	]);
-	let H = useRef(null), U = useRef(!1), W = useRef(k);
+	let U = useRef(null), W = useRef(!1), G = useRef(A);
 	useEffect(() => {
-		W.current !== k && (N.current ? N.current.setDocumentMode(k) : U.current && (H.current = k)), W.current = k;
-	}, [k]), useImperativeHandle(s, () => ({ getInstance: () => N.current }), []), useEffect(() => {
-		B(!0), d(!1), U.current = !0;
+		G.current !== A && (P.current ? P.current.setDocumentMode(A) : W.current && (U.current = A)), G.current = A;
+	}, [A]), useImperativeHandle(s, () => ({ getInstance: () => P.current }), []), useEffect(() => {
+		V(!0), d(!1), W.current = !0;
 		let e = !1, s = null;
 		return (async () => {
 			try {
 				let c = (await import("superdoc")).SuperDoc;
 				if (e) return;
 				s = new c({
-					...O,
-					selector: `#${CSS.escape(L)}`,
-					...!m && P.current ? { toolbar: `#${CSS.escape(R)}` } : {},
-					documentMode: k,
-					role: A,
+					...k,
+					selector: `#${CSS.escape(R)}`,
+					...!m && F.current ? { toolbar: `#${CSS.escape(z)}` } : {},
+					documentMode: A,
+					role: j,
 					contained: h,
-					...w == null ? {} : { document: w },
-					...j ? { user: j } : {},
-					...M ? { users: M } : {},
-					...D ? { modules: D } : {},
+					...T == null ? {} : { document: T },
+					...M ? { user: M } : {},
+					...N ? { users: N } : {},
+					...O ? { modules: O } : {},
 					onReady: (s) => {
-						e || (B(!1), U.current = !1, H.current && H.current !== k && (s.superdoc.setDocumentMode(H.current), H.current = null), V.current.onReady?.(s));
+						e || (V(!1), W.current = !1, U.current && U.current !== A && (s.superdoc.setDocumentMode(U.current), U.current = null), H.current.onReady?.(s));
 					},
 					onEditorCreate: (s) => {
-						e || V.current.onEditorCreate?.(s);
+						e || H.current.onEditorCreate?.(s);
 					},
 					onEditorDestroy: () => {
-						e || V.current.onEditorDestroy?.();
+						e || H.current.onEditorDestroy?.();
 					},
 					onEditorUpdate: (s) => {
-						e || V.current.onEditorUpdate?.(s);
+						e || H.current.onEditorUpdate?.(s);
+					},
+					onTransaction: (s) => {
+						e || H.current.onTransaction?.(s);
 					},
 					onContentError: (s) => {
-						e || V.current.onContentError?.(s);
+						e || H.current.onContentError?.(s);
 					},
 					onException: (s) => {
-						e || V.current.onException?.(s);
+						e || H.current.onException?.(s);
 					}
-				}), N.current = s;
+				}), P.current = s;
 			} catch (s) {
-				e || (U.current = !1, B(!1), d(!0), console.error("[SuperDocEditor] Failed to initialize SuperDoc:", s), V.current.onException?.({ error: s }));
+				e || (W.current = !1, V(!1), d(!0), console.error("[SuperDocEditor] Failed to initialize SuperDoc:", s), H.current.onException?.({ error: s }));
 			}
 		})(), () => {
-			U.current = !1, H.current = null, s && (s.destroy(), N.current = null), e = !0;
+			W.current = !1, U.current = null, s && (s.destroy(), P.current = null), e = !0;
 		};
 	}, [
-		w,
-		j,
+		T,
 		M,
-		D,
-		A,
+		N,
+		O,
+		j,
 		m,
 		h,
-		L,
-		R
+		R,
+		z
 	]);
-	let G = ["superdoc-wrapper", g].filter(Boolean).join(" "), K = z ? { display: "none" } : void 0;
+	let K = ["superdoc-wrapper", g].filter(Boolean).join(" "), q = B ? { display: "none" } : void 0;
 	return /* @__PURE__ */ jsxs("div", {
-		className: G,
+		className: K,
 		style: {
 			..._,
 			...h && {
@@ -114,23 +120,23 @@ function SuperDocEditorInner(e, s) {
 		},
 		children: [
 			!m && /* @__PURE__ */ jsx("div", {
-				ref: P,
-				id: R,
+				ref: F,
+				id: z,
 				className: "superdoc-toolbar-container",
-				style: K
+				style: q
 			}),
 			/* @__PURE__ */ jsx("div", {
-				id: L,
+				id: R,
 				className: "superdoc-editor-container",
 				style: {
-					...K,
+					...q,
 					...h && {
 						flex: 1,
 						minHeight: 0
 					}
 				}
 			}),
-			z && !u && p && /* @__PURE__ */ jsx("div", {
+			B && !u && p && /* @__PURE__ */ jsx("div", {
 				className: "superdoc-loading-container",
 				children: p()
 			}),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc-dev/react",
-  "version": "1.2.0-next.34",
+  "version": "1.2.0-next.36",
   "description": "Official React wrapper for the SuperDoc document editor",
   "type": "module",
   "main": "./dist/index.cjs",