docx-diff-editor 1.0.33 → 1.0.37

package/README.md

@@ -132,6 +132,12 @@ interface DocxDiffEditorRef {
 
   // Check if ready
   isReady(): boolean;
+
+  // Get current page count
+  getPages(): number;
+
+  // Get document metadata and statistics
+  getDocumentInfo(): DocumentInfo | null;
 }
 ```
 
@@ -148,6 +154,22 @@ interface ComparisonResult {
 }
 ```
 
+### DocumentInfo
+
+```tsx
+interface DocumentInfo {
+  // Metadata
+  documentGuid: string | null;
+  isModified: boolean;
+  version: number | null;
+  // Statistics
+  words: number;
+  characters: number;
+  paragraphs: number;
+  pages: number;
+}
+```
+
 ## Getting LLM Context
 
 Extract enriched changes with semantic context for AI/LLM processing:

package/dist/index.d.mts

@@ -109,6 +109,25 @@ interface TrackChangeAuthor {
     name: string;
     email: string;
 }
+/**
+ * Combined document metadata and statistics
+ */
+interface DocumentInfo {
+    /** Document unique identifier */
+    documentGuid: string | null;
+    /** Whether the document has unsaved changes */
+    isModified: boolean;
+    /** Document version number */
+    version: number | null;
+    /** Word count */
+    words: number;
+    /** Character count */
+    characters: number;
+    /** Paragraph count */
+    paragraphs: number;
+    /** Page count */
+    pages: number;
+}
 /**
  * Props for DocxDiffEditor component
  */
@@ -142,8 +161,10 @@ interface DocxDiffEditorProps {
  * Ref methods exposed by DocxDiffEditor
  */
 interface DocxDiffEditorRef {
-    /** Set the source/base document */
+    /** Set the source/base document (destroys and recreates SuperDoc instance) */
     setSource(content: DocxContent): Promise<void>;
+    /** Update content in the existing editor without recreating SuperDoc instance */
+    updateContent(json: ProseMirrorJSON): void;
     /** Compare source with new content, show track changes */
     compareWith(content: DocxContent): Promise<ComparisonResult>;
     /** Get raw diff segments */
@@ -162,6 +183,10 @@ interface DocxDiffEditorRef {
     acceptAllChanges(): Promise<ProseMirrorJSON>;
     /** Check if editor is ready */
     isReady(): boolean;
+    /** Get the current page count from the presentation editor */
+    getPages(): number;
+    /** Get combined document metadata and statistics */
+    getDocumentInfo(): DocumentInfo | null;
 }
 
 /**
@@ -309,4 +334,4 @@ declare function getBlankTemplateBlob(): Blob;
  */
 declare function isValidDocxFile(file: File): boolean;
 
-export { CSS_PREFIX, type ChangeLocation, type ComparisonResult, DEFAULT_AUTHOR, DEFAULT_SUPERDOC_USER, type DiffResult, type DiffSegment, type DocxContent, DocxDiffEditor, type DocxDiffEditorProps, type DocxDiffEditorRef, type EnrichedChange, type FormatChange, type FormatDetails, type ProseMirrorJSON, type ProseMirrorMark, type ProseMirrorNode, type TrackChangeAuthor, createTrackDeleteMark, createTrackFormatMark, createTrackInsertMark, DocxDiffEditor as default, detectContentType, diffDocuments, extractEnrichedChanges, getBlankTemplateBlob, getBlankTemplateFile, isProseMirrorJSON, isValidDocxFile, mergeDocuments, parseDocxFile };
+export { CSS_PREFIX, type ChangeLocation, type ComparisonResult, DEFAULT_AUTHOR, DEFAULT_SUPERDOC_USER, type DiffResult, type DiffSegment, type DocumentInfo, type DocxContent, DocxDiffEditor, type DocxDiffEditorProps, type DocxDiffEditorRef, type EnrichedChange, type FormatChange, type FormatDetails, type ProseMirrorJSON, type ProseMirrorMark, type ProseMirrorNode, type TrackChangeAuthor, createTrackDeleteMark, createTrackFormatMark, createTrackInsertMark, DocxDiffEditor as default, detectContentType, diffDocuments, extractEnrichedChanges, getBlankTemplateBlob, getBlankTemplateFile, isProseMirrorJSON, isValidDocxFile, mergeDocuments, parseDocxFile };

package/dist/index.d.ts

@@ -109,6 +109,25 @@ interface TrackChangeAuthor {
     name: string;
     email: string;
 }
+/**
+ * Combined document metadata and statistics
+ */
+interface DocumentInfo {
+    /** Document unique identifier */
+    documentGuid: string | null;
+    /** Whether the document has unsaved changes */
+    isModified: boolean;
+    /** Document version number */
+    version: number | null;
+    /** Word count */
+    words: number;
+    /** Character count */
+    characters: number;
+    /** Paragraph count */
+    paragraphs: number;
+    /** Page count */
+    pages: number;
+}
 /**
  * Props for DocxDiffEditor component
  */
@@ -142,8 +161,10 @@ interface DocxDiffEditorProps {
  * Ref methods exposed by DocxDiffEditor
  */
 interface DocxDiffEditorRef {
-    /** Set the source/base document */
+    /** Set the source/base document (destroys and recreates SuperDoc instance) */
     setSource(content: DocxContent): Promise<void>;
+    /** Update content in the existing editor without recreating SuperDoc instance */
+    updateContent(json: ProseMirrorJSON): void;
     /** Compare source with new content, show track changes */
     compareWith(content: DocxContent): Promise<ComparisonResult>;
     /** Get raw diff segments */
@@ -162,6 +183,10 @@ interface DocxDiffEditorRef {
     acceptAllChanges(): Promise<ProseMirrorJSON>;
     /** Check if editor is ready */
     isReady(): boolean;
+    /** Get the current page count from the presentation editor */
+    getPages(): number;
+    /** Get combined document metadata and statistics */
+    getDocumentInfo(): DocumentInfo | null;
 }
 
 /**
@@ -309,4 +334,4 @@ declare function getBlankTemplateBlob(): Blob;
  */
 declare function isValidDocxFile(file: File): boolean;
 
-export { CSS_PREFIX, type ChangeLocation, type ComparisonResult, DEFAULT_AUTHOR, DEFAULT_SUPERDOC_USER, type DiffResult, type DiffSegment, type DocxContent, DocxDiffEditor, type DocxDiffEditorProps, type DocxDiffEditorRef, type EnrichedChange, type FormatChange, type FormatDetails, type ProseMirrorJSON, type ProseMirrorMark, type ProseMirrorNode, type TrackChangeAuthor, createTrackDeleteMark, createTrackFormatMark, createTrackInsertMark, DocxDiffEditor as default, detectContentType, diffDocuments, extractEnrichedChanges, getBlankTemplateBlob, getBlankTemplateFile, isProseMirrorJSON, isValidDocxFile, mergeDocuments, parseDocxFile };
+export { CSS_PREFIX, type ChangeLocation, type ComparisonResult, DEFAULT_AUTHOR, DEFAULT_SUPERDOC_USER, type DiffResult, type DiffSegment, type DocumentInfo, type DocxContent, DocxDiffEditor, type DocxDiffEditorProps, type DocxDiffEditorRef, type EnrichedChange, type FormatChange, type FormatDetails, type ProseMirrorJSON, type ProseMirrorMark, type ProseMirrorNode, type TrackChangeAuthor, createTrackDeleteMark, createTrackFormatMark, createTrackInsertMark, DocxDiffEditor as default, detectContentType, diffDocuments, extractEnrichedChanges, getBlankTemplateBlob, getBlankTemplateFile, isProseMirrorJSON, isValidDocxFile, mergeDocuments, parseDocxFile };

package/dist/index.js

@@ -733,17 +733,11 @@ var DocxDiffEditor = react.forwardRef(
     const editorId = `dde-editor-${instanceId.current}`;
     const toolbarId = `dde-toolbar-${instanceId.current}`;
     const setEditorContent = react.useCallback((editor, json) => {
-      if (editor.commands?.setContent) {
-        editor.commands.setContent(json);
-      } else if (editor.setContent) {
-        editor.setContent(json);
-      } else {
-        const { state, view } = editor;
-        if (state?.doc && view && json.content) {
-          const newDoc = state.schema.nodeFromJSON(json);
-          const tr = state.tr.replaceWith(0, state.doc.content.size, newDoc.content);
-          view.dispatch(tr);
-        }
+      const { state, view } = editor;
+      if (state?.doc && view && json.content) {
+        const newDoc = state.schema.nodeFromJSON(json);
+        const tr = state.tr.replaceWith(0, state.doc.content.size, newDoc.content);
+        view.dispatch(tr);
       }
     }, []);
     const enableReviewMode = react.useCallback((sd) => {
@@ -925,9 +919,26 @@ var DocxDiffEditor = react.forwardRef(
     react.useImperativeHandle(
       ref,
       () => ({
+        /**
+         * Update content in the existing editor without recreating SuperDoc instance.
+         * Preserves the DOCX template/styling. Ideal for replacing content with translated JSON.
+         */
+        updateContent(json) {
+          const editor = superdocRef.current?.activeEditor;
+          if (!editor) {
+            throw new Error("Editor not ready");
+          }
+          setEditorContent(editor, json);
+          setSourceJson(json);
+          setMergedJson(null);
+          setDiffResult(null);
+          onSourceLoaded?.(json);
+        },
         /**
          * Set the source/base document.
          * Accepts File (DOCX), HTML string, or ProseMirror JSON.
+         * Note: This destroys and recreates the SuperDoc instance.
+         * For JSON content updates, prefer updateContent() to preserve the existing template.
          */
         async setSource(content) {
           if (!SuperDocRef.current) {
@@ -1166,6 +1177,65 @@ var DocxDiffEditor = react.forwardRef(
          */
         isReady() {
           return readyRef.current;
+        },
+        /**
+         * Get the current page count from the presentation editor.
+         * Returns 0 if editor is not ready or pages are unavailable.
+         */
+        getPages() {
+          if (!readyRef.current || !superdocRef.current) {
+            return 0;
+          }
+          try {
+            const sd = superdocRef.current;
+            const doc = sd.superdocStore?.documents?.[0];
+            if (!doc) {
+              return 0;
+            }
+            const presentationEditor = doc.getPresentationEditor?.();
+            const pages = presentationEditor?.getPages?.();
+            return pages?.length ?? 0;
+          } catch (err) {
+            console.warn("[DocxDiffEditor] Failed to get page count:", err);
+            return 0;
+          }
+        },
+        /**
+         * Get combined document metadata and statistics.
+         * Returns null if editor is not ready.
+         */
+        getDocumentInfo() {
+          if (!readyRef.current || !superdocRef.current) {
+            return null;
+          }
+          try {
+            const sd = superdocRef.current;
+            const doc = sd.superdocStore?.documents?.[0];
+            if (!doc) {
+              return null;
+            }
+            const editor = doc.getEditor?.();
+            const metadata = editor?.getMetadata?.() ?? {};
+            const stats = editor?.commands?.getDocumentStats?.() ?? {};
+            const presentationEditor = doc.getPresentationEditor?.();
+            const pages = presentationEditor?.getPages?.();
+            const pageCount = pages?.length ?? 0;
+            return {
+              // Metadata
+              documentGuid: metadata.documentGuid ?? null,
+              isModified: metadata.isModified ?? false,
+              version: metadata.version ?? null,
+              // Stats
+              words: stats.words ?? 0,
+              characters: stats.characters ?? 0,
+              paragraphs: stats.paragraphs ?? 0,
+              // Pages
+              pages: pageCount
+            };
+          } catch (err) {
+            console.warn("[DocxDiffEditor] Failed to get document info:", err);
+            return null;
+          }
         }
       }),
       [