erl-mathtextx-editor 0.1.8 → 0.1.10

package/dist/toolbar/MainToolbar.d.ts

@@ -9,6 +9,7 @@ interface MainToolbarProps {
     onEditImage?: () => void;
     onSetImageAlign?: (align: 'left' | 'center' | 'right' | 'full') => void;
     onResetImagePosition?: () => void;
+    onImportDocx?: () => void;
 }
 export declare const MainToolbar: React.NamedExoticComponent<MainToolbarProps>;
 export {};

package/dist/types/index.d.ts

@@ -41,6 +41,8 @@ export interface MathTextXEditorProps {
     autoFocus?: boolean;
     /** Image upload handler — return the URL of the uploaded image */
     onImageUpload?: (file: File) => Promise<string>;
+    /** Transform HTML before pasting — e.g. re-upload images in pasted content */
+    onBeforePasteHTML?: (html: string) => Promise<string>;
 }
 /** Toolbar button config */
 export interface ToolbarButtonConfig {

package/dist/utils/docxImporter.d.ts

@@ -0,0 +1,31 @@
+export interface DocxImportResult {
+    html: string;
+    warnings: string[];
+    images: Map<string, {
+        contentType: string;
+        arrayBuffer: ArrayBuffer;
+    }>;
+}
+/**
+ * Convert a .docx File to clean HTML via mammoth.js.
+ *
+ * Images embedded in the .docx are extracted and returned separately
+ * so they can be re-uploaded by the host application.
+ */
+export declare function convertDocxToHtml(file: File, onImage?: (imageKey: string, contentType: string, buffer: ArrayBuffer) => Promise<string>): Promise<DocxImportResult>;
+/**
+ * Import a .docx file and insert its content into the editor.
+ *
+ * @param file - The .docx file
+ * @param editor - TipTap editor instance
+ * @param uploadImage - Optional callback to upload extracted images
+ */
+export declare function importDocxFile(file: File, editor: {
+    chain: () => {
+        focus: () => {
+            insertContent: (html: string) => {
+                run: () => void;
+            };
+        };
+    };
+}, uploadImage?: (imageKey: string, contentType: string, buffer: ArrayBuffer) => Promise<string>): Promise<string[]>;

package/dist/utils/pasteHandler.d.ts

@@ -4,13 +4,24 @@ import { Editor } from '@tiptap/react';
  */
 export declare function cleanOfficeHTML(html: string): string;
 /**
- * Clean Google Docs specific HTML content
+ * Clean Google Docs specific HTML content.
+ *
+ * Handles:
+ * - Inline formatting span → strong/em/u conversion
+ * - Google Docs wrapper/metadata removal
+ * - Table normalization
+ * - List cleanup
+ * - Font-color preservation (background/text color)
  */
 export declare function cleanGoogleDocsHTML(html: string): string;
 /**
- * Handle paste event with smart detection
+ * Handle paste event with smart detection.
+ *
+ * When `transformHTML` is provided and the pasted HTML contains images,
+ * the callback is invoked asynchronously to transform the HTML (e.g. re-upload
+ * images) before inserting into the editor.
  */
-export declare function handlePaste(editor: Editor, event: ClipboardEvent): boolean;
+export declare function handlePaste(editor: Editor, event: ClipboardEvent, transformHTML?: (html: string) => Promise<string>): boolean;
 /**
  * Handle Shift+Ctrl+V (Paste as plain text)
  */