docx-diff-editor 1.0.35 → 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
  */
@@ -164,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;
 }
 
 /**
@@ -311,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
  */
@@ -164,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;
 }
 
 /**
@@ -311,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

@@ -1177,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;
+          }
         }
       }),
       [