docx-diff-editor 1.0.41 → 1.0.42

package/README.md

@@ -149,6 +149,9 @@ interface DocxDiffEditorRef {
 
   // Set document core properties (partial update)
   setProperties(properties: Partial<DocumentProperties>): Promise<boolean>;
+
+  // Parse HTML to ProseMirror JSON
+  parseHtml(html: string): Promise<ProseMirrorJSON>;
 }
 ```
 
@@ -251,6 +254,23 @@ await editorRef.current?.setProperties({
 });
 ```
 
+## Parsing HTML to JSON
+
+Convert HTML strings to ProseMirror JSON without visible rendering:
+
+```tsx
+// Using the ref method (requires editor to be initialized)
+const json = await editorRef.current?.parseHtml('<h1>Title</h1><p>Content here</p>');
+console.log(json); // { type: 'doc', content: [...] }
+
+// Use with other methods
+await editorRef.current?.updateContent(json);
+
+// Or use the standalone function (requires SuperDoc class)
+import { parseHtmlToJson } from 'docx-diff-editor';
+const json = await parseHtmlToJson(htmlString, SuperDocClass);
+```
+
 ## Customization
 
 ### CSS Variables

package/dist/index.d.mts

@@ -362,6 +362,8 @@ interface DocxDiffEditorRef {
     getProperties(): Promise<DocumentProperties | null>;
     /** Set document core properties (partial update) */
     setProperties(properties: Partial<DocumentProperties>): Promise<boolean>;
+    /** Parse HTML string to ProseMirror JSON (uses hidden SuperDoc instance) */
+    parseHtml(html: string): Promise<ProseMirrorJSON>;
 }
 
 /**
@@ -420,6 +422,10 @@ declare function detectContentType(content: DocxContent): 'file' | 'html' | 'jso
  * Validate that content looks like ProseMirror JSON
  */
 declare function isProseMirrorJSON(content: unknown): boolean;
+/**
+ * Parse an HTML string into ProseMirror JSON using a hidden SuperDoc instance.
+ */
+declare function parseHtmlToJson(html: string, SuperDoc: SuperDocConstructor): Promise<ProseMirrorJSON>;
 /**
  * Parse a DOCX File into ProseMirror JSON using a hidden SuperDoc instance.
  */
@@ -710,4 +716,4 @@ declare function getBlankTemplateBlob(): Blob;
  */
 declare function isValidDocxFile(file: File): boolean;
 
-export { type AttrDiff, type AttributeChange, CSS_PREFIX, type ChangeLocation, type ComparisonResult, DEFAULT_AUTHOR, DEFAULT_SUPERDOC_USER, type DiffResult, type DiffSegment, type DocumentInfo, type DocumentProperties, type DocxContent, DocxDiffEditor, type DocxDiffEditorProps, type DocxDiffEditorRef, type EnrichedChange, type FingerprintedNode, type FormatChange, type FormatDetails, type HybridDiffResult, type NodeMatch, type ProseMirrorJSON, type ProseMirrorMark, type ProseMirrorNode, type StructuralChange, type StructuralChangeInfo, type StructuralChangeType, StructuralChangesPane, type StructuralPanePosition, type TrackChangeAuthor, alignDocuments, createTrackDeleteMark, createTrackFormatMark, createTrackInsertMark, DocxDiffEditor as default, detectContentType, diffDocuments, diffImages, diffLists, diffTables, extractEnrichedChanges, extractEnrichedChangesWithStructural, generateFingerprint, generateStructuralChangeSummary, getBlankTemplateBlob, getBlankTemplateFile, isAtomicNode, isImage, isList, isProseMirrorJSON, isTable, isValidDocxFile, mergeDocuments, parseDocxFile, processStructuralChanges };
+export { type AttrDiff, type AttributeChange, CSS_PREFIX, type ChangeLocation, type ComparisonResult, DEFAULT_AUTHOR, DEFAULT_SUPERDOC_USER, type DiffResult, type DiffSegment, type DocumentInfo, type DocumentProperties, type DocxContent, DocxDiffEditor, type DocxDiffEditorProps, type DocxDiffEditorRef, type EnrichedChange, type FingerprintedNode, type FormatChange, type FormatDetails, type HybridDiffResult, type NodeMatch, type ProseMirrorJSON, type ProseMirrorMark, type ProseMirrorNode, type StructuralChange, type StructuralChangeInfo, type StructuralChangeType, StructuralChangesPane, type StructuralPanePosition, type TrackChangeAuthor, alignDocuments, createTrackDeleteMark, createTrackFormatMark, createTrackInsertMark, DocxDiffEditor as default, detectContentType, diffDocuments, diffImages, diffLists, diffTables, extractEnrichedChanges, extractEnrichedChangesWithStructural, generateFingerprint, generateStructuralChangeSummary, getBlankTemplateBlob, getBlankTemplateFile, isAtomicNode, isImage, isList, isProseMirrorJSON, isTable, isValidDocxFile, mergeDocuments, parseDocxFile, parseHtmlToJson, processStructuralChanges };

package/dist/index.d.ts

@@ -362,6 +362,8 @@ interface DocxDiffEditorRef {
     getProperties(): Promise<DocumentProperties | null>;
     /** Set document core properties (partial update) */
     setProperties(properties: Partial<DocumentProperties>): Promise<boolean>;
+    /** Parse HTML string to ProseMirror JSON (uses hidden SuperDoc instance) */
+    parseHtml(html: string): Promise<ProseMirrorJSON>;
 }
 
 /**
@@ -420,6 +422,10 @@ declare function detectContentType(content: DocxContent): 'file' | 'html' | 'jso
  * Validate that content looks like ProseMirror JSON
  */
 declare function isProseMirrorJSON(content: unknown): boolean;
+/**
+ * Parse an HTML string into ProseMirror JSON using a hidden SuperDoc instance.
+ */
+declare function parseHtmlToJson(html: string, SuperDoc: SuperDocConstructor): Promise<ProseMirrorJSON>;
 /**
  * Parse a DOCX File into ProseMirror JSON using a hidden SuperDoc instance.
  */
@@ -710,4 +716,4 @@ declare function getBlankTemplateBlob(): Blob;
  */
 declare function isValidDocxFile(file: File): boolean;
 
-export { type AttrDiff, type AttributeChange, CSS_PREFIX, type ChangeLocation, type ComparisonResult, DEFAULT_AUTHOR, DEFAULT_SUPERDOC_USER, type DiffResult, type DiffSegment, type DocumentInfo, type DocumentProperties, type DocxContent, DocxDiffEditor, type DocxDiffEditorProps, type DocxDiffEditorRef, type EnrichedChange, type FingerprintedNode, type FormatChange, type FormatDetails, type HybridDiffResult, type NodeMatch, type ProseMirrorJSON, type ProseMirrorMark, type ProseMirrorNode, type StructuralChange, type StructuralChangeInfo, type StructuralChangeType, StructuralChangesPane, type StructuralPanePosition, type TrackChangeAuthor, alignDocuments, createTrackDeleteMark, createTrackFormatMark, createTrackInsertMark, DocxDiffEditor as default, detectContentType, diffDocuments, diffImages, diffLists, diffTables, extractEnrichedChanges, extractEnrichedChangesWithStructural, generateFingerprint, generateStructuralChangeSummary, getBlankTemplateBlob, getBlankTemplateFile, isAtomicNode, isImage, isList, isProseMirrorJSON, isTable, isValidDocxFile, mergeDocuments, parseDocxFile, processStructuralChanges };
+export { type AttrDiff, type AttributeChange, CSS_PREFIX, type ChangeLocation, type ComparisonResult, DEFAULT_AUTHOR, DEFAULT_SUPERDOC_USER, type DiffResult, type DiffSegment, type DocumentInfo, type DocumentProperties, type DocxContent, DocxDiffEditor, type DocxDiffEditorProps, type DocxDiffEditorRef, type EnrichedChange, type FingerprintedNode, type FormatChange, type FormatDetails, type HybridDiffResult, type NodeMatch, type ProseMirrorJSON, type ProseMirrorMark, type ProseMirrorNode, type StructuralChange, type StructuralChangeInfo, type StructuralChangeType, StructuralChangesPane, type StructuralPanePosition, type TrackChangeAuthor, alignDocuments, createTrackDeleteMark, createTrackFormatMark, createTrackInsertMark, DocxDiffEditor as default, detectContentType, diffDocuments, diffImages, diffLists, diffTables, extractEnrichedChanges, extractEnrichedChangesWithStructural, generateFingerprint, generateStructuralChangeSummary, getBlankTemplateBlob, getBlankTemplateFile, isAtomicNode, isImage, isList, isProseMirrorJSON, isTable, isValidDocxFile, mergeDocuments, parseDocxFile, parseHtmlToJson, processStructuralChanges };

package/dist/index.js

@@ -468,6 +468,76 @@ function isProseMirrorJSON(content) {
   const obj = content;
   return typeof obj.type === "string" && (obj.type === "doc" || Array.isArray(obj.content));
 }
+async function parseHtmlToJson(html, SuperDoc) {
+  const container = document.createElement("div");
+  container.style.cssText = "position:absolute;top:-9999px;left:-9999px;width:800px;height:600px;visibility:hidden;";
+  document.body.appendChild(container);
+  return new Promise((resolve, reject) => {
+    let superdoc = null;
+    let resolved = false;
+    const cleanup = () => {
+      setTimeout(() => {
+        if (superdoc) {
+          try {
+            const sd = superdoc;
+            superdoc = null;
+            sd.destroy?.();
+          } catch {
+          }
+        }
+        if (container.parentNode) {
+          container.parentNode.removeChild(container);
+        }
+      }, TIMEOUTS.CLEANUP_DELAY);
+    };
+    setTimeout(async () => {
+      if (resolved) return;
+      try {
+        superdoc = new SuperDoc({
+          selector: container,
+          html,
+          documentMode: "viewing",
+          rulers: false,
+          user: { name: "Parser", email: "parser@local" },
+          // eslint-disable-next-line @typescript-eslint/no-explicit-any
+          onReady: ({ superdoc: sd }) => {
+            if (resolved) return;
+            try {
+              const editor = sd?.activeEditor;
+              if (!editor) {
+                throw new Error("No active editor found");
+              }
+              const json = editor.getJSON();
+              resolved = true;
+              cleanup();
+              resolve(json);
+            } catch (err) {
+              resolved = true;
+              cleanup();
+              reject(err);
+            }
+          },
+          onException: ({ error: err }) => {
+            if (resolved) return;
+            resolved = true;
+            cleanup();
+            reject(err);
+          }
+        });
+        setTimeout(() => {
+          if (!resolved) {
+            resolved = true;
+            cleanup();
+            reject(new Error("HTML parsing timed out"));
+          }
+        }, TIMEOUTS.PARSE_TIMEOUT);
+      } catch (err) {
+        cleanup();
+        reject(err);
+      }
+    }, 50);
+  });
+}
 async function parseDocxFile(file, SuperDoc) {
   const container = document.createElement("div");
   container.style.cssText = "position:absolute;top:-9999px;left:-9999px;width:800px;height:600px;visibility:hidden;";
@@ -2873,6 +2943,16 @@ var DocxDiffEditor = react.forwardRef(
             console.warn("[DocxDiffEditor] Failed to set properties:", err);
             return false;
           }
+        },
+        /**
+         * Parse HTML string to ProseMirror JSON using a hidden SuperDoc instance.
+         * Useful for converting HTML content before using with other methods.
+         */
+        async parseHtml(html) {
+          if (!SuperDocRef.current) {
+            throw new Error("Editor not initialized");
+          }
+          return parseHtmlToJson(html, SuperDocRef.current);
         }
       }),
       [
@@ -3019,6 +3099,7 @@ exports.isTable = isTable;
 exports.isValidDocxFile = isValidDocxFile;
 exports.mergeDocuments = mergeDocuments;
 exports.parseDocxFile = parseDocxFile;
+exports.parseHtmlToJson = parseHtmlToJson;
 exports.processStructuralChanges = processStructuralChanges;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map