@superdoc/react 2.5.0-next.9 → 2.5.1-next.1

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

package/dist/index.d.ts

@@ -22,12 +22,14 @@ import { HyperlinksConfig } from 'superdoc';
 import { HyperlinkTarget } from 'superdoc';
 import { ReactNode } from 'react';
 import { RefAttributes } from 'react';
+import { RulerConfig } from 'superdoc';
 import { SearchConfig } from 'superdoc';
 import { SearchFloatingConfig } from 'superdoc';
 import { SearchStrings } from 'superdoc';
 import { SuperDoc } from 'superdoc';
 import { SuperDocExceptionHyperlinkPayload } from 'superdoc';
 import { SuperDocExceptionPayload } from 'superdoc';
+import { SuperDocPageMarginsChangePayload } from 'superdoc';
 import { ToolbarConfig } from 'superdoc';
 
 /**
@@ -53,6 +55,8 @@ export declare interface CallbackProps {
     onZoomChange?: (event: SuperDocZoomChangeEvent) => void;
     /** Callback when the implied fit changes (rounded fit zoom or base page width); see the core viewport-change event */
     onViewportChange?: (event: SuperDocViewportChangeEvent) => void;
+    /** Callback after a ruler drag changes the active section's left or right page margin. */
+    onPageMarginsChange?: (event: SuperDocPageMarginsChangeEvent) => void;
 }
 
 export { CommentInteractionConfig }
@@ -93,7 +97,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' | 'onTransaction' | 'onContentError' | 'onException' | 'onZoomChange' | 'onViewportChange';
+declare type ExplicitCallbackProps = 'onReady' | 'onEditorCreate' | 'onEditorDestroy' | 'onEditorUpdate' | 'onTransaction' | 'onContentError' | 'onException' | 'onZoomChange' | 'onViewportChange' | 'onPageMarginsChange';
 
 export { HyperlinkActivationContext }
 
@@ -125,7 +129,10 @@ declare type OptionalInReact = 'documentMode';
 declare interface ReactProps {
     /** Optional ID for the editor container. Auto-generated if not provided. */
     id?: string;
-    /** Render function for loading state */
+    /**
+     * Render application-owned content while the Editor opens. When omitted,
+     * SuperDoc shows its built-in loading overlay unless `ui.loading` is false.
+     */
     renderLoading?: () => ReactNode;
     /**
      * Hide the toolbar container. When true, no toolbar is rendered.
@@ -147,6 +154,8 @@ declare interface ReactProps {
     style?: CSSProperties;
 }
 
+export { RulerConfig }
+
 export { SearchConfig }
 
 export { SearchFloatingConfig }
@@ -222,6 +231,11 @@ export declare type SuperDocInstance = InstanceType<typeof SuperDoc>;
 /** Modules configuration - extracted from Config.modules */
 export declare type SuperDocModules = NonNullable<SuperDocConstructorConfig['modules']>;
 
+/** Event passed to onPageMarginsChange callback. */
+export declare type SuperDocPageMarginsChangeEvent = Parameters<NonNullable<SuperDocConfig['onPageMarginsChange']>>[0];
+
+export { SuperDocPageMarginsChangePayload }
+
 /** Event passed to onReady callback */
 export declare type SuperDocReadyEvent = Parameters<NonNullable<SuperDocConfig['onReady']>>[0];
 

package/dist/index.js

@@ -23,14 +23,14 @@ function f(e, t) {
 //#endregion
 //#region src/SuperDocEditor.tsx
 function p(e, t) {
-	let [c, l] = a(!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, ui: j, ...M } = e, N = e.documentMode ?? "editing", P = e.role ?? "editor", F = j !== !1 && j?.toolbar, I = typeof F == "object" && !!F && F.container !== void 0, L = !m && F !== !1 && !I, R = (() => {
-		if (j === !1 || j === void 0 || !m) return j;
-		let { toolbar: e, ...t } = j;
+	let [c, l] = a(!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, onPageMarginsChange: D, document: O, user: k, users: A, modules: j, ui: M, ...N } = e, P = e.documentMode ?? "editing", F = e.role ?? "editor", I = M !== !1 && M?.toolbar, L = typeof I == "object" && !!I && I.container !== void 0, R = !m && I !== !1 && !L, z = (() => {
+		if (M === !1 || M === void 0 || !m) return M;
+		let { toolbar: e, ...t } = M;
 		return {
 			...t,
 			toolbar: !1
 		};
-	})(), z = d(O), B = d(k), V = i(null), H = i(null), U = u(), W = f ?? `superdoc${U}`, G = W, K = `${W}-toolbar`, [q, J] = a(!0), Y = i({
+	})(), B = d(k), V = d(A), H = i(null), U = i(null), W = u(), G = f ?? `superdoc${W}`, K = G, q = `${G}-toolbar`, [J, Y] = a(!0), X = i({
 		onReady: v,
 		onEditorCreate: y,
 		onEditorDestroy: b,
@@ -39,10 +39,11 @@ function p(e, t) {
 		onContentError: C,
 		onException: w,
 		onZoomChange: T,
-		onViewportChange: E
+		onViewportChange: E,
+		onPageMarginsChange: D
 	});
 	n(() => {
-		Y.current = {
+		X.current = {
 			onReady: v,
 			onEditorCreate: y,
 			onEditorDestroy: b,
@@ -51,7 +52,8 @@ function p(e, t) {
 			onContentError: C,
 			onException: w,
 			onZoomChange: T,
-			onViewportChange: E
+			onViewportChange: E,
+			onPageMarginsChange: D
 		};
 	}, [
 		v,
@@ -62,77 +64,81 @@ function p(e, t) {
 		C,
 		w,
 		T,
-		E
+		E,
+		D
 	]);
-	let X = i(null), Z = i(!1), Q = i(N);
+	let Z = i(null), Q = i(!1), $ = i(P);
 	n(() => {
-		Q.current !== N && (V.current ? V.current.setDocumentMode(N) : Z.current && (X.current = N)), Q.current = N;
-	}, [N]), r(t, () => ({ getInstance: () => V.current }), []), n(() => {
-		J(!0), l(!1), Z.current = !0;
+		$.current !== P && (H.current ? H.current.setDocumentMode(P) : Q.current && (Z.current = P)), $.current = P;
+	}, [P]), r(t, () => ({ getInstance: () => H.current }), []), n(() => {
+		Y(!0), l(!1), Q.current = !0;
 		let e = !1, t = null;
 		return (async () => {
 			try {
 				let n = (await import("superdoc")).SuperDoc;
 				if (e) return;
 				t = new n({
-					...M,
-					selector: `#${CSS.escape(G)}`,
-					...L && H.current ? { toolbar: `#${CSS.escape(K)}` } : {},
-					documentMode: N,
-					role: P,
+					...N,
+					selector: `#${CSS.escape(K)}`,
+					...R && U.current ? { toolbar: `#${CSS.escape(q)}` } : {},
+					documentMode: P,
+					role: F,
 					contained: h,
-					...D == null ? {} : { document: D },
-					...z ? { user: z } : {},
-					...B ? { users: B } : {},
-					...A ? { modules: A } : {},
-					...R === void 0 ? {} : { ui: R },
+					...O == null ? {} : { document: O },
+					...B ? { user: B } : {},
+					...V ? { users: V } : {},
+					...j ? { modules: j } : {},
+					...z === void 0 ? {} : { ui: z },
 					onReady: (t) => {
-						e || (J(!1), Z.current = !1, X.current && X.current !== N && (t.superdoc.setDocumentMode(X.current), X.current = null), Y.current.onReady?.(t));
+						e || (Y(!1), Q.current = !1, Z.current && Z.current !== P && (t.superdoc.setDocumentMode(Z.current), Z.current = null), X.current.onReady?.(t));
 					},
 					onEditorCreate: (t) => {
-						e || Y.current.onEditorCreate?.(t);
+						e || X.current.onEditorCreate?.(t);
 					},
 					onEditorDestroy: () => {
-						e || Y.current.onEditorDestroy?.();
+						e || X.current.onEditorDestroy?.();
 					},
 					onEditorUpdate: (t) => {
-						e || Y.current.onEditorUpdate?.(t);
+						e || X.current.onEditorUpdate?.(t);
 					},
 					onTransaction: (t) => {
-						e || Y.current.onTransaction?.(t);
+						e || X.current.onTransaction?.(t);
 					},
 					onContentError: (t) => {
-						e || Y.current.onContentError?.(t);
+						e || X.current.onContentError?.(t);
 					},
 					onException: (t) => {
-						e || Y.current.onException?.(t);
+						e || X.current.onException?.(t);
 					},
 					onZoomChange: (t) => {
-						e || Y.current.onZoomChange?.(t);
+						e || X.current.onZoomChange?.(t);
 					},
 					onViewportChange: (t) => {
-						e || Y.current.onViewportChange?.(t);
+						e || X.current.onViewportChange?.(t);
+					},
+					onPageMarginsChange: (t) => {
+						e || X.current.onPageMarginsChange?.(t);
 					}
-				}), V.current = t;
+				}), H.current = t;
 			} catch (t) {
-				e || (Z.current = !1, J(!1), l(!0), console.error("[SuperDocEditor] Failed to initialize SuperDoc:", t), Y.current.onException?.({ error: t }));
+				e || (Q.current = !1, Y(!1), l(!0), console.error("[SuperDocEditor] Failed to initialize SuperDoc:", t), X.current.onException?.({ error: t }));
 			}
 		})(), () => {
-			Z.current = !1, X.current = null, t && (t.destroy(), V.current = null), e = !0;
+			Q.current = !1, Z.current = null, t && (t.destroy(), H.current = null), e = !0;
 		};
 	}, [
-		D,
-		z,
+		O,
 		B,
-		A,
+		V,
 		j,
-		P,
+		M,
+		F,
 		m,
 		h,
-		G,
-		K
+		K,
+		q
 	]);
-	let ee = ["superdoc-wrapper", g].filter(Boolean).join(" "), $ = q ? { display: "none" } : void 0;
+	let ee = ["superdoc-wrapper", g].filter(Boolean).join(" "), te = M !== !1 && M?.loading !== !1, ne = J ? { display: "none" } : void 0, re = J && (p || !te) ? { display: "none" } : void 0;
 	return /* @__PURE__ */ s("div", {
 		className: ee,
 		style: {
@@ -143,24 +149,24 @@ function p(e, t) {
 			}
 		},
 		children: [
-			L && /* @__PURE__ */ o("div", {
-				ref: H,
-				id: K,
+			R && /* @__PURE__ */ o("div", {
+				ref: U,
+				id: q,
 				className: "superdoc-toolbar-container",
-				style: $
+				style: ne
 			}),
 			/* @__PURE__ */ o("div", {
-				id: G,
+				id: K,
 				className: "superdoc-editor-container",
 				style: {
-					...$,
+					...re,
 					...h && {
 						flex: 1,
 						minHeight: 0
 					}
 				}
 			}),
-			q && !c && p && /* @__PURE__ */ o("div", {
+			J && !c && p && /* @__PURE__ */ o("div", {
 				className: "superdoc-loading-container",
 				children: p()
 			}),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc/react",
-  "version": "2.5.0-next.9",
+  "version": "2.5.1-next.1",
   "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": "2.10.0-next.9"
+    "superdoc": "2.10.1-next.1"
   },
   "peerDependencies": {
     "react": ">=16.8.0",
     "react-dom": ">=16.8.0",
-    "superdoc": "2.10.0-next.9"
+    "superdoc": "2.10.1-next.1"
   },
   "devDependencies": {
     "@testing-library/react": "^16.3.0",