@superdoc-dev/react 1.0.0-next.6 → 1.0.0-next.8

package/README.md

@@ -10,6 +10,34 @@ npm install @superdoc-dev/react
 
 > `superdoc` is included as a dependency - no need to install it separately.
 
+## 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.
+
 ## Quick Start
 
 ```tsx

package/dist/index.cjs

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

package/dist/index.d.ts

@@ -107,9 +107,7 @@ export declare interface SuperDocEditorProps extends Omit<SuperDocConfig, Intern
 }
 
 /** Event passed to onEditorUpdate callback */
-export declare interface SuperDocEditorUpdateEvent {
-    editor: Editor;
-}
+export declare type SuperDocEditorUpdateEvent = Parameters<NonNullable<SuperDocConstructorConfig['onEditorUpdate']>>[0];
 
 /** Event passed to onException callback */
 export declare interface SuperDocExceptionEvent {
@@ -135,6 +133,9 @@ export declare interface SuperDocRef {
     getInstance(): SuperDocInstance | null;
 }
 
+/** Event passed to onTransaction callback */
+export declare type SuperDocTransactionEvent = Parameters<NonNullable<SuperDocConstructorConfig['onTransaction']>>[0];
+
 /** User object - extracted from Config.user */
 export declare type SuperDocUser = NonNullable<SuperDocConstructorConfig['user']>;
 

package/dist/index.js

@@ -1,117 +1,120 @@
-import { jsxs as O, jsx as a } from "react/jsx-runtime";
-import * as v from "react";
-import { forwardRef as Q, useState as F, useRef as s, useEffect as N, useImperativeHandle as V } from "react";
-function X() {
-  const n = v.useRef(null);
-  return n.current === null && (n.current = `-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`), n.current;
+import * as React from "react";
+import { forwardRef, useEffect, useImperativeHandle, useRef, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+function useIdPolyfill() {
+	let s = React.useRef(null);
+	return s.current === null && (s.current = `-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`), s.current;
 }
-const Y = typeof v.useId == "function" ? v.useId : X;
-function Z(n, H) {
-  const [x, w] = F(!1), {
-    // React-specific
-    id: B,
-    renderLoading: $,
-    hideToolbar: l = !1,
-    className: T,
-    style: W,
-    // Callbacks (stored in ref to avoid triggering rebuilds)
-    onReady: f,
-    onEditorCreate: p,
-    onEditorDestroy: m,
-    onEditorUpdate: E,
-    onContentError: y,
-    onException: D,
-    // Key props that trigger rebuild when changed
-    document: S,
-    user: I,
-    users: R,
-    modules: g,
-    // All other props passed through
-    ...q
-  } = n, o = n.documentMode ?? "editing", P = n.role ?? "editor", i = s(null), L = s(null), A = Y(), j = B ?? `superdoc${A}`, h = j, C = `${j}-toolbar`, [U, b] = F(!0), t = s({
-    onReady: f,
-    onEditorCreate: p,
-    onEditorDestroy: m,
-    onEditorUpdate: E,
-    onContentError: y,
-    onException: D
-  });
-  N(() => {
-    t.current = {
-      onReady: f,
-      onEditorCreate: p,
-      onEditorDestroy: m,
-      onEditorUpdate: E,
-      onContentError: y,
-      onException: D
-    };
-  }, [f, p, m, E, y, D]);
-  const c = s(null), u = s(!1), k = s(o);
-  N(() => {
-    k.current !== o && (i.current ? i.current.setDocumentMode(o) : u.current && (c.current = o)), k.current = o;
-  }, [o]), V(
-    H,
-    () => ({
-      getInstance: () => i.current
-    }),
-    []
-  ), N(() => {
-    b(!0), w(!1), u.current = !0;
-    let r = !1, d = null;
-    return (async () => {
-      try {
-        const J = (await import("superdoc")).SuperDoc;
-        if (r) return;
-        const K = {
-          ...q,
-          selector: `#${CSS.escape(h)}`,
-          // Use internal toolbar container unless hideToolbar is true
-          ...!l && L.current ? { toolbar: `#${CSS.escape(C)}` } : {},
-          documentMode: o,
-          role: P,
-          ...S != null ? { document: S } : {},
-          ...I ? { user: I } : {},
-          ...R ? { users: R } : {},
-          ...g ? { modules: g } : {},
-          // Wire up callbacks with lifecycle guards
-          onReady: (e) => {
-            r || (b(!1), u.current = !1, c.current && c.current !== o && (e.superdoc.setDocumentMode(c.current), c.current = null), t.current.onReady?.(e));
-          },
-          onEditorCreate: (e) => {
-            r || t.current.onEditorCreate?.(e);
-          },
-          onEditorDestroy: () => {
-            r || t.current.onEditorDestroy?.();
-          },
-          onEditorUpdate: (e) => {
-            r || t.current.onEditorUpdate?.(e);
-          },
-          onContentError: (e) => {
-            r || t.current.onContentError?.(e);
-          },
-          onException: (e) => {
-            r || t.current.onException?.(e);
-          }
-        };
-        d = new J(K), i.current = d;
-      } catch (M) {
-        r || (u.current = !1, b(!1), w(!0), console.error("[SuperDocEditor] Failed to initialize SuperDoc:", M), t.current.onException?.({ error: M }));
-      }
-    })(), () => {
-      u.current = !1, c.current = null, d && (d.destroy(), i.current = null), r = !0;
-    };
-  }, [S, I, R, g, P, l, h, C]);
-  const G = ["superdoc-wrapper", T].filter(Boolean).join(" "), z = U ? { display: "none" } : void 0;
-  return /* @__PURE__ */ O("div", { className: G, style: W, children: [
-    !l && /* @__PURE__ */ a("div", { ref: L, id: C, className: "superdoc-toolbar-container", style: z }),
-    /* @__PURE__ */ a("div", { id: h, className: "superdoc-editor-container", style: z }),
-    U && !x && $ && /* @__PURE__ */ a("div", { className: "superdoc-loading-container", children: $() }),
-    x && /* @__PURE__ */ a("div", { className: "superdoc-error-container", children: "Failed to load editor. Check console for details." })
-  ] });
+const useStableId = typeof React.useId == "function" ? React.useId : useIdPolyfill;
+function SuperDocEditorInner(e, s) {
+	let [l, u] = useState(!1), { id: d, renderLoading: f, hideToolbar: p = !1, className: m, style: h, onReady: g, onEditorCreate: _, onEditorDestroy: v, onEditorUpdate: y, onContentError: b, onException: x, document: S, user: C, users: w, modules: T, ...E } = e, D = e.documentMode ?? "editing", O = e.role ?? "editor", k = useRef(null), A = useRef(null), j = useStableId(), M = d ?? `superdoc${j}`, N = M, P = `${M}-toolbar`, [F, I] = useState(!0), L = useRef({
+		onReady: g,
+		onEditorCreate: _,
+		onEditorDestroy: v,
+		onEditorUpdate: y,
+		onContentError: b,
+		onException: x
+	});
+	useEffect(() => {
+		L.current = {
+			onReady: g,
+			onEditorCreate: _,
+			onEditorDestroy: v,
+			onEditorUpdate: y,
+			onContentError: b,
+			onException: x
+		};
+	}, [
+		g,
+		_,
+		v,
+		y,
+		b,
+		x
+	]);
+	let R = useRef(null), z = useRef(!1), B = useRef(D);
+	useEffect(() => {
+		B.current !== D && (k.current ? k.current.setDocumentMode(D) : z.current && (R.current = D)), B.current = D;
+	}, [D]), useImperativeHandle(s, () => ({ getInstance: () => k.current }), []), useEffect(() => {
+		I(!0), u(!1), z.current = !0;
+		let e = !1, s = null;
+		return (async () => {
+			try {
+				let c = (await import("superdoc")).SuperDoc;
+				if (e) return;
+				s = new c({
+					...E,
+					selector: `#${CSS.escape(N)}`,
+					...!p && A.current ? { toolbar: `#${CSS.escape(P)}` } : {},
+					documentMode: D,
+					role: O,
+					...S == null ? {} : { document: S },
+					...C ? { user: C } : {},
+					...w ? { users: w } : {},
+					...T ? { modules: T } : {},
+					onReady: (s) => {
+						e || (I(!1), z.current = !1, R.current && R.current !== D && (s.superdoc.setDocumentMode(R.current), R.current = null), L.current.onReady?.(s));
+					},
+					onEditorCreate: (s) => {
+						e || L.current.onEditorCreate?.(s);
+					},
+					onEditorDestroy: () => {
+						e || L.current.onEditorDestroy?.();
+					},
+					onEditorUpdate: (s) => {
+						e || L.current.onEditorUpdate?.(s);
+					},
+					onContentError: (s) => {
+						e || L.current.onContentError?.(s);
+					},
+					onException: (s) => {
+						e || L.current.onException?.(s);
+					}
+				}), k.current = s;
+			} catch (s) {
+				e || (z.current = !1, I(!1), u(!0), console.error("[SuperDocEditor] Failed to initialize SuperDoc:", s), L.current.onException?.({ error: s }));
+			}
+		})(), () => {
+			z.current = !1, R.current = null, s && (s.destroy(), k.current = null), e = !0;
+		};
+	}, [
+		S,
+		C,
+		w,
+		T,
+		O,
+		p,
+		N,
+		P
+	]);
+	let V = ["superdoc-wrapper", m].filter(Boolean).join(" "), H = F ? { display: "none" } : void 0;
+	return /* @__PURE__ */ jsxs("div", {
+		className: V,
+		style: h,
+		children: [
+			!p && /* @__PURE__ */ jsx("div", {
+				ref: A,
+				id: P,
+				className: "superdoc-toolbar-container",
+				style: H
+			}),
+			/* @__PURE__ */ jsx("div", {
+				id: N,
+				className: "superdoc-editor-container",
+				style: H
+			}),
+			F && !l && f && /* @__PURE__ */ jsx("div", {
+				className: "superdoc-loading-container",
+				children: f()
+			}),
+			l && /* @__PURE__ */ jsx("div", {
+				className: "superdoc-error-container",
+				children: "Failed to load editor. Check console for details."
+			})
+		]
+	});
 }
-const _ = Q(Z);
-_.displayName = "SuperDocEditor";
-export {
-  _ as SuperDocEditor,
-  _ as default
-};
+const SuperDocEditor = forwardRef(SuperDocEditorInner);
+SuperDocEditor.displayName = "SuperDocEditor";
+var SuperDocEditor_default = SuperDocEditor;
+export { SuperDocEditor, SuperDocEditor_default as default };

package/package.json

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