@superdoc-dev/react 1.11.1 → 1.13.0

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}var d=c.useId;const f=typeof d==`function`?d:u;function p(e){let t=c.useRef(e),n=c.useRef(e);return t.current!==e&&(m(n.current,e)||(n.current=e),t.current=e),n.current}function m(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 h(e,t){let[n,r]=(0,c.useState)(!1),{id:i,renderLoading:a,hideToolbar:o=!1,contained:s=!1,className:u,style:d,onReady:m,onEditorCreate:h,onEditorDestroy:g,onEditorUpdate:_,onTransaction:v,onContentError:y,onException:b,onZoomChange:x,onViewportChange:S,document:C,user:w,users:T,modules:E,...D}=e,O=e.documentMode??`editing`,k=e.role??`editor`,A=p(w),j=p(T),M=(0,c.useRef)(null),N=(0,c.useRef)(null),P=f(),F=i??`superdoc${P}`,I=F,L=`${F}-toolbar`,[R,z]=(0,c.useState)(!0),B=(0,c.useRef)({onReady:m,onEditorCreate:h,onEditorDestroy:g,onEditorUpdate:_,onTransaction:v,onContentError:y,onException:b,onZoomChange:x,onViewportChange:S});(0,c.useEffect)(()=>{B.current={onReady:m,onEditorCreate:h,onEditorDestroy:g,onEditorUpdate:_,onTransaction:v,onContentError:y,onException:b,onZoomChange:x,onViewportChange:S}},[m,h,g,_,v,y,b,x,S]);let V=(0,c.useRef)(null),H=(0,c.useRef)(!1),U=(0,c.useRef)(O);(0,c.useEffect)(()=>{U.current!==O&&(M.current?M.current.setDocumentMode(O):H.current&&(V.current=O)),U.current=O},[O]),(0,c.useImperativeHandle)(t,()=>({getInstance:()=>M.current}),[]),(0,c.useEffect)(()=>{z(!0),r(!1),H.current=!0;let e=!1,t=null;return(async()=>{try{let n=(await import(`superdoc`)).SuperDoc;if(e)return;t=new n({...D,selector:`#${CSS.escape(I)}`,...!o&&N.current?{toolbar:`#${CSS.escape(L)}`}:{},documentMode:O,role:k,contained:s,...C==null?{}:{document:C},...A?{user:A}:{},...j?{users:j}:{},...E?{modules:E}:{},onReady:t=>{e||(z(!1),H.current=!1,V.current&&V.current!==O&&(t.superdoc.setDocumentMode(V.current),V.current=null),B.current.onReady?.(t))},onEditorCreate:t=>{e||B.current.onEditorCreate?.(t)},onEditorDestroy:()=>{e||B.current.onEditorDestroy?.()},onEditorUpdate:t=>{e||B.current.onEditorUpdate?.(t)},onTransaction:t=>{e||B.current.onTransaction?.(t)},onContentError:t=>{e||B.current.onContentError?.(t)},onException:t=>{e||B.current.onException?.(t)},onZoomChange:t=>{e||B.current.onZoomChange?.(t)},onViewportChange:t=>{e||B.current.onViewportChange?.(t)}}),M.current=t}catch(t){e||(H.current=!1,z(!1),r(!0),console.error(`[SuperDocEditor] Failed to initialize SuperDoc:`,t),B.current.onException?.({error:t}))}})(),()=>{H.current=!1,V.current=null,t&&(t.destroy(),M.current=null),e=!0}},[C,A,j,E,k,o,s,I,L]);let W=[`superdoc-wrapper`,u].filter(Boolean).join(` `),G=R?{display:`none`}:void 0;return(0,l.jsxs)(`div`,{className:W,style:{...d,...s&&{display:`flex`,flexDirection:`column`}},children:[!o&&(0,l.jsx)(`div`,{ref:N,id:L,className:`superdoc-toolbar-container`,style:G}),(0,l.jsx)(`div`,{id:I,className:`superdoc-editor-container`,style:{...G,...s&&{flex:1,minHeight:0}}}),R&&!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 g=(0,c.forwardRef)(h);g.displayName=`SuperDocEditor`;var _=g;exports.SuperDocEditor=g,exports.default=_;
+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}var d=c.useId;const f=typeof d==`function`?d:u;function p(e){let t=c.useRef(e),n=c.useRef(e);return t.current!==e&&(m(n.current,e)||(n.current=e),t.current=e),n.current}function m(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 h(e,t){let[n,r]=(0,c.useState)(!1),{id:i,renderLoading:a,hideToolbar:o=!1,contained:s=!1,className:u,style:d,onReady:m,onEditorCreate:h,onEditorDestroy:g,onEditorUpdate:_,onTransaction:v,onContentError:y,onException:b,onZoomChange:x,onViewportChange:S,document:C,user:w,users:T,modules:E,editorVersion:D,editorIntegration:O,...k}=e,A=e.documentMode??`editing`,j=e.role??`editor`,M=p(w),N=p(T),P=(0,c.useRef)(null),F=(0,c.useRef)(null),I=f(),L=i??`superdoc${I}`,R=L,z=`${L}-toolbar`,[B,V]=(0,c.useState)(!0),H=(0,c.useRef)({onReady:m,onEditorCreate:h,onEditorDestroy:g,onEditorUpdate:_,onTransaction:v,onContentError:y,onException:b,onZoomChange:x,onViewportChange:S});(0,c.useEffect)(()=>{H.current={onReady:m,onEditorCreate:h,onEditorDestroy:g,onEditorUpdate:_,onTransaction:v,onContentError:y,onException:b,onZoomChange:x,onViewportChange:S}},[m,h,g,_,v,y,b,x,S]);let U=(0,c.useRef)(null),W=(0,c.useRef)(!1),G=(0,c.useRef)(A);(0,c.useEffect)(()=>{G.current!==A&&(P.current?P.current.setDocumentMode(A):W.current&&(U.current=A)),G.current=A},[A]),(0,c.useImperativeHandle)(t,()=>({getInstance:()=>P.current}),[]),(0,c.useEffect)(()=>{V(!0),r(!1),W.current=!0;let e=!1,t=null;return(async()=>{try{let n=(await import(`superdoc`)).SuperDoc;if(e)return;t=new n({...k,selector:`#${CSS.escape(R)}`,...!o&&F.current?{toolbar:`#${CSS.escape(z)}`}:{},documentMode:A,role:j,contained:s,...C==null?{}:{document:C},...M?{user:M}:{},...N?{users:N}:{},...E?{modules:E}:{},...D==null?{}:{editorVersion:D},...O==null?{}:{editorIntegration:O},onReady:t=>{e||(V(!1),W.current=!1,U.current&&U.current!==A&&(t.superdoc.setDocumentMode(U.current),U.current=null),H.current.onReady?.(t))},onEditorCreate:t=>{e||H.current.onEditorCreate?.(t)},onEditorDestroy:()=>{e||H.current.onEditorDestroy?.()},onEditorUpdate:t=>{e||H.current.onEditorUpdate?.(t)},onTransaction:t=>{e||H.current.onTransaction?.(t)},onContentError:t=>{e||H.current.onContentError?.(t)},onException:t=>{e||H.current.onException?.(t)},onZoomChange:t=>{e||H.current.onZoomChange?.(t)},onViewportChange:t=>{e||H.current.onViewportChange?.(t)}}),P.current=t}catch(t){e||(W.current=!1,V(!1),r(!0),console.error(`[SuperDocEditor] Failed to initialize SuperDoc:`,t),H.current.onException?.({error:t}))}})(),()=>{W.current=!1,U.current=null,t&&(t.destroy(),P.current=null),e=!0}},[C,M,N,E,j,o,s,D,O,R,z]);let K=[`superdoc-wrapper`,u].filter(Boolean).join(` `),q=B?{display:`none`}:void 0;return(0,l.jsxs)(`div`,{className:K,style:{...d,...s&&{display:`flex`,flexDirection:`column`}},children:[!o&&(0,l.jsx)(`div`,{ref:F,id:z,className:`superdoc-toolbar-container`,style:q}),(0,l.jsx)(`div`,{id:R,className:`superdoc-editor-container`,style:{...q,...s&&{flex:1,minHeight:0}}}),B&&!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 g=(0,c.forwardRef)(h);g.displayName=`SuperDocEditor`;var _=g;exports.SuperDocEditor=g,exports.default=_;

package/dist/index.d.ts

@@ -37,6 +37,16 @@ export declare type DocumentMode = NonNullable<SuperDocConstructorConfig['docume
 
 export { Editor }
 
+/**
+ * Explicitly typed editor implementation props.
+ */
+declare interface EditorImplementationProps {
+    /** Select the DOCX editor implementation. @default 1 */
+    editorVersion?: 1 | 2;
+    /** Private editor integration object or factory. Required when editorVersion is 2. */
+    editorIntegration?: unknown;
+}
+
 /** Surface where an editor event originated. */
 export declare type EditorSurface = 'body' | 'header' | 'footer';
 
@@ -119,7 +129,7 @@ export declare interface SuperDocEditorCreateEvent {
  *
  * Callback props are explicitly typed to ensure proper TypeScript inference.
  */
-export declare interface SuperDocEditorProps extends Omit<SuperDocConfig, InternalProps | OptionalInReact | ExplicitCallbackProps>, Partial<Pick<SuperDocConfig, OptionalInReact>>, CallbackProps, ReactProps {
+export declare interface SuperDocEditorProps extends Omit<SuperDocConfig, InternalProps | OptionalInReact | ExplicitCallbackProps | keyof EditorImplementationProps>, Partial<Pick<SuperDocConfig, OptionalInReact>>, EditorImplementationProps, CallbackProps, ReactProps {
 }
 
 /** Event passed to onEditorUpdate callback. Mirrors superdoc's EditorUpdateEvent. */

package/dist/index.js

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

package/package.json

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