docxodus 0.1.0

package/README.md

@@ -0,0 +1,209 @@
+# Docxodus
+
+DOCX document comparison and HTML conversion in the browser using WebAssembly.
+
+Docxodus brings professional-grade document comparison (redlining) to JavaScript applications. Compare two Word documents and get tracked changes, or convert DOCX files to HTML - all running entirely in the browser with no server required.
+
+## Features
+
+- **Document Comparison**: Compare two DOCX files and generate a redlined document with tracked changes
+- **HTML Conversion**: Convert DOCX documents to HTML for display in the browser
+- **Revision Extraction**: Get structured data about all revisions in a compared document
+- **100% Client-Side**: All processing happens in the browser using WebAssembly
+- **React Hooks**: Ready-to-use hooks for React applications
+- **TypeScript Support**: Full type definitions included
+
+## Installation
+
+```bash
+npm install docxodus
+```
+
+## Quick Start
+
+### Basic Usage
+
+```javascript
+import { initialize, convertDocxToHtml, compareDocuments } from 'docxodus';
+
+// Initialize the WASM runtime (call once at app startup)
+await initialize('/path/to/wasm/');
+
+// Convert DOCX to HTML
+const html = await convertDocxToHtml(docxFile);
+
+// Compare two documents
+const redlinedDocx = await compareDocuments(originalFile, modifiedFile, {
+  authorName: 'Reviewer'
+});
+```
+
+### React Usage
+
+```tsx
+import { useDocxodus, useConversion, useComparison } from 'docxodus/react';
+
+function DocumentViewer() {
+  const { isReady, isLoading, error, convertToHtml } = useDocxodus('/wasm/');
+  const [html, setHtml] = useState('');
+
+  const handleFile = async (e: React.ChangeEvent<HTMLInputElement>) => {
+    const file = e.target.files?.[0];
+    if (file && isReady) {
+      const result = await convertToHtml(file);
+      setHtml(result);
+    }
+  };
+
+  if (isLoading) return <div>Loading...</div>;
+  if (error) return <div>Error: {error.message}</div>;
+
+  return (
+    <div>
+      <input type="file" accept=".docx" onChange={handleFile} />
+      <div dangerouslySetInnerHTML={{ __html: html }} />
+    </div>
+  );
+}
+```
+
+### Using the Comparison Hook
+
+```tsx
+import { useComparison } from 'docxodus/react';
+
+function DocumentComparer() {
+  const {
+    html,
+    isComparing,
+    error,
+    compareToHtml,
+    downloadResult
+  } = useComparison('/wasm/');
+
+  const handleCompare = async (original: File, modified: File) => {
+    await compareToHtml(original, modified, { authorName: 'Legal Team' });
+  };
+
+  return (
+    <div>
+      {isComparing && <p>Comparing...</p>}
+      {error && <p>Error: {error.message}</p>}
+      {html && <div dangerouslySetInnerHTML={{ __html: html }} />}
+      <button onClick={() => downloadResult('comparison.docx')}>
+        Download Redlined DOCX
+      </button>
+    </div>
+  );
+}
+```
+
+## API Reference
+
+### Core Functions
+
+#### `initialize(basePath?: string): Promise<void>`
+Initialize the WASM runtime. Must be called before using any other functions.
+
+#### `convertDocxToHtml(document: File | Uint8Array, options?: ConversionOptions): Promise<string>`
+Convert a DOCX document to HTML.
+
+```typescript
+interface ConversionOptions {
+  pageTitle?: string;      // HTML document title
+  cssPrefix?: string;      // CSS class prefix (default: "docx-")
+  fabricateClasses?: boolean; // Generate CSS classes (default: true)
+  additionalCss?: string;  // Extra CSS to include
+}
+```
+
+#### `compareDocuments(original, modified, options?): Promise<Uint8Array>`
+Compare two DOCX documents and return a redlined DOCX with tracked changes.
+
+```typescript
+interface CompareOptions {
+  authorName?: string;     // Author name for revisions (default: "Docxodus")
+  detailThreshold?: number; // 0.0-1.0, lower = more detailed (default: 0.15)
+  caseInsensitive?: boolean; // Case-insensitive comparison (default: false)
+}
+```
+
+#### `compareDocumentsToHtml(original, modified, options?): Promise<string>`
+Compare documents and return the result as HTML.
+
+#### `getRevisions(document: File | Uint8Array): Promise<Revision[]>`
+Extract revision information from a compared document.
+
+```typescript
+interface Revision {
+  author: string;
+  date: string;
+  revisionType: string; // "Insertion", "Deletion", etc.
+  text: string;
+}
+```
+
+### React Hooks
+
+#### `useDocxodus(wasmBasePath?: string)`
+Main hook providing all Docxodus functionality.
+
+Returns:
+- `isReady: boolean` - Whether WASM is loaded
+- `isLoading: boolean` - Whether WASM is loading
+- `error: Error | null` - Initialization error
+- `convertToHtml()` - Convert DOCX to HTML
+- `compare()` - Compare documents
+- `compareToHtml()` - Compare and get HTML
+- `getRevisions()` - Get revision list
+
+#### `useConversion(wasmBasePath?: string)`
+Simplified hook for DOCX to HTML conversion with state management.
+
+#### `useComparison(wasmBasePath?: string)`
+Simplified hook for document comparison with state management.
+
+## Hosting WASM Files
+
+The WASM files need to be served from your web server. After building:
+
+1. Copy the contents of `dist/wasm/` to your public directory
+2. Pass the path to `initialize()` or the React hooks
+
+Example directory structure:
+```
+public/
+  wasm/
+    _framework/
+      dotnet.js
+      dotnet.native.wasm
+      ... (other framework files)
+    main.js
+```
+
+## Bundle Size
+
+| Component | Size (uncompressed) | Size (Brotli) |
+|-----------|---------------------|---------------|
+| dotnet.native.wasm | ~8 MB | ~3 MB |
+| Managed assemblies | ~15 MB | ~5 MB |
+| Total | ~37 MB | ~10-12 MB |
+
+The WASM files are loaded on-demand and cached by the browser.
+
+## Browser Support
+
+- Chrome 89+
+- Firefox 89+
+- Safari 15+
+- Edge 89+
+
+Requires WebAssembly SIMD support.
+
+## License
+
+MIT
+
+## Credits
+
+Built on [Docxodus](https://github.com/JSv4/Redlines), a .NET library for document manipulation based on OpenXML-PowerTools.

package/dist/index.d.ts

@@ -0,0 +1,63 @@
+import type { ConversionOptions, CompareOptions, Revision, VersionInfo, ErrorResponse, CompareResult } from "./types.js";
+export type { ConversionOptions, CompareOptions, Revision, VersionInfo, ErrorResponse, CompareResult, };
+/**
+ * Get the path to the WASM files directory.
+ * Override this if you're hosting WASM files at a custom location.
+ */
+export declare let wasmBasePath: string;
+/**
+ * Set custom base path for WASM files
+ */
+export declare function setWasmBasePath(path: string): void;
+/**
+ * Initialize the Docxodus WASM runtime.
+ * Must be called before using any conversion/comparison functions.
+ * Safe to call multiple times - will only initialize once.
+ */
+export declare function initialize(basePath?: string): Promise<void>;
+/**
+ * Convert a DOCX document to HTML.
+ *
+ * @param document - DOCX file as File object or Uint8Array
+ * @param options - Conversion options
+ * @returns HTML string
+ * @throws Error if conversion fails
+ */
+export declare function convertDocxToHtml(document: File | Uint8Array, options?: ConversionOptions): Promise<string>;
+/**
+ * Compare two DOCX documents and return the redlined result as a DOCX.
+ *
+ * @param original - Original DOCX document
+ * @param modified - Modified DOCX document
+ * @param options - Comparison options
+ * @returns Redlined DOCX as Uint8Array
+ * @throws Error if comparison fails
+ */
+export declare function compareDocuments(original: File | Uint8Array, modified: File | Uint8Array, options?: CompareOptions): Promise<Uint8Array>;
+/**
+ * Compare two DOCX documents and return the result as HTML.
+ *
+ * @param original - Original DOCX document
+ * @param modified - Modified DOCX document
+ * @param options - Comparison options
+ * @returns HTML string with redlined content
+ * @throws Error if comparison fails
+ */
+export declare function compareDocumentsToHtml(original: File | Uint8Array, modified: File | Uint8Array, options?: CompareOptions): Promise<string>;
+/**
+ * Get revisions from a compared document.
+ *
+ * @param document - A document that has been through comparison (has tracked changes)
+ * @returns Array of revisions
+ * @throws Error if operation fails
+ */
+export declare function getRevisions(document: File | Uint8Array): Promise<Revision[]>;
+/**
+ * Get version information about the library.
+ */
+export declare function getVersion(): VersionInfo;
+/**
+ * Check if the WASM runtime is initialized.
+ */
+export declare function isInitialized(): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,QAAQ,EACR,WAAW,EACX,aAAa,EACb,aAAa,EAEd,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,QAAQ,EACR,WAAW,EACX,aAAa,EACb,aAAa,GACd,CAAC;AAKF;;;GAGG;AACH,eAAO,IAAI,YAAY,QAAK,CAAC;AAE7B;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAElD;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAajE;AA0DD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,IAAI,GAAG,UAAU,EAC3B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAwBjB;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,IAAI,GAAG,UAAU,EAC3B,QAAQ,EAAE,IAAI,GAAG,UAAU,EAC3B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,CA4BrB;AAED;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,IAAI,GAAG,UAAU,EAC3B,QAAQ,EAAE,IAAI,GAAG,UAAU,EAC3B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,CAiBjB;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,IAAI,GAAG,UAAU,GAC1B,OAAO,CAAC,QAAQ,EAAE,CAAC,CAkBrB;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,WAAW,CASxC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC"}

package/dist/index.js

@@ -0,0 +1,188 @@
+let wasmExports = null;
+let initPromise = null;
+/**
+ * Get the path to the WASM files directory.
+ * Override this if you're hosting WASM files at a custom location.
+ */
+export let wasmBasePath = "";
+/**
+ * Set custom base path for WASM files
+ */
+export function setWasmBasePath(path) {
+    wasmBasePath = path.endsWith("/") ? path : path + "/";
+}
+/**
+ * Initialize the Docxodus WASM runtime.
+ * Must be called before using any conversion/comparison functions.
+ * Safe to call multiple times - will only initialize once.
+ */
+export async function initialize(basePath) {
+    if (wasmExports)
+        return;
+    if (initPromise) {
+        return initPromise;
+    }
+    if (basePath) {
+        setWasmBasePath(basePath);
+    }
+    initPromise = loadWasm();
+    return initPromise;
+}
+async function loadWasm() {
+    const dotnetPath = wasmBasePath + "_framework/dotnet.js";
+    const { dotnet } = await import(/* webpackIgnore: true */ dotnetPath);
+    const { getAssemblyExports, getConfig } = await dotnet
+        .withDiagnosticTracing(false)
+        .create();
+    const config = getConfig();
+    const exports = await getAssemblyExports(config.mainAssemblyName);
+    wasmExports = {
+        DocumentConverter: exports.DocxodusWasm.DocumentConverter,
+        DocumentComparer: exports.DocxodusWasm.DocumentComparer,
+    };
+}
+function ensureInitialized() {
+    if (!wasmExports) {
+        throw new Error("Docxodus not initialized. Call initialize() first and await it.");
+    }
+    return wasmExports;
+}
+function isErrorResponse(result) {
+    try {
+        const parsed = JSON.parse(result);
+        return typeof parsed === "object" && "Error" in parsed;
+    }
+    catch {
+        return false;
+    }
+}
+function parseError(result) {
+    const parsed = JSON.parse(result);
+    return {
+        error: parsed.Error || parsed.error,
+        type: parsed.Type || parsed.type,
+        stackTrace: parsed.StackTrace || parsed.stackTrace,
+    };
+}
+/**
+ * Convert a File or Uint8Array to Uint8Array
+ */
+async function toBytes(input) {
+    if (input instanceof Uint8Array) {
+        return input;
+    }
+    const buffer = await input.arrayBuffer();
+    return new Uint8Array(buffer);
+}
+/**
+ * Convert a DOCX document to HTML.
+ *
+ * @param document - DOCX file as File object or Uint8Array
+ * @param options - Conversion options
+ * @returns HTML string
+ * @throws Error if conversion fails
+ */
+export async function convertDocxToHtml(document, options) {
+    const exports = ensureInitialized();
+    const bytes = await toBytes(document);
+    let result;
+    if (options) {
+        result = exports.DocumentConverter.ConvertDocxToHtmlWithOptions(bytes, options.pageTitle ?? "Document", options.cssPrefix ?? "docx-", options.fabricateClasses ?? true, options.additionalCss ?? "");
+    }
+    else {
+        result = exports.DocumentConverter.ConvertDocxToHtml(bytes);
+    }
+    if (isErrorResponse(result)) {
+        const error = parseError(result);
+        throw new Error(`Conversion failed: ${error.error}`);
+    }
+    return result;
+}
+/**
+ * Compare two DOCX documents and return the redlined result as a DOCX.
+ *
+ * @param original - Original DOCX document
+ * @param modified - Modified DOCX document
+ * @param options - Comparison options
+ * @returns Redlined DOCX as Uint8Array
+ * @throws Error if comparison fails
+ */
+export async function compareDocuments(original, modified, options) {
+    const exports = ensureInitialized();
+    const originalBytes = await toBytes(original);
+    const modifiedBytes = await toBytes(modified);
+    let result;
+    if (options?.detailThreshold !== undefined || options?.caseInsensitive) {
+        result = exports.DocumentComparer.CompareDocumentsWithOptions(originalBytes, modifiedBytes, options?.authorName ?? "Docxodus", options?.detailThreshold ?? 0.15, options?.caseInsensitive ?? false);
+    }
+    else {
+        result = exports.DocumentComparer.CompareDocuments(originalBytes, modifiedBytes, options?.authorName ?? "Docxodus");
+    }
+    if (result.length === 0) {
+        throw new Error("Comparison failed - empty result");
+    }
+    return result;
+}
+/**
+ * Compare two DOCX documents and return the result as HTML.
+ *
+ * @param original - Original DOCX document
+ * @param modified - Modified DOCX document
+ * @param options - Comparison options
+ * @returns HTML string with redlined content
+ * @throws Error if comparison fails
+ */
+export async function compareDocumentsToHtml(original, modified, options) {
+    const exports = ensureInitialized();
+    const originalBytes = await toBytes(original);
+    const modifiedBytes = await toBytes(modified);
+    const result = exports.DocumentComparer.CompareDocumentsToHtml(originalBytes, modifiedBytes, options?.authorName ?? "Docxodus");
+    if (isErrorResponse(result)) {
+        const error = parseError(result);
+        throw new Error(`Comparison failed: ${error.error}`);
+    }
+    return result;
+}
+/**
+ * Get revisions from a compared document.
+ *
+ * @param document - A document that has been through comparison (has tracked changes)
+ * @returns Array of revisions
+ * @throws Error if operation fails
+ */
+export async function getRevisions(document) {
+    const exports = ensureInitialized();
+    const bytes = await toBytes(document);
+    const result = exports.DocumentComparer.GetRevisionsJson(bytes);
+    if (isErrorResponse(result)) {
+        const error = parseError(result);
+        throw new Error(`Failed to get revisions: ${error.error}`);
+    }
+    const parsed = JSON.parse(result);
+    return (parsed.Revisions || parsed.revisions || []).map((r) => ({
+        author: r.Author || r.author,
+        date: r.Date || r.date,
+        revisionType: r.RevisionType || r.revisionType,
+        text: r.Text || r.text,
+    }));
+}
+/**
+ * Get version information about the library.
+ */
+export function getVersion() {
+    const exports = ensureInitialized();
+    const result = exports.DocumentConverter.GetVersion();
+    const parsed = JSON.parse(result);
+    return {
+        library: parsed.Library || parsed.library,
+        dotnetVersion: parsed.DotnetVersion || parsed.dotnetVersion,
+        platform: parsed.Platform || parsed.platform,
+    };
+}
+/**
+ * Check if the WASM runtime is initialized.
+ */
+export function isInitialized() {
+    return wasmExports !== null;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/react.d.ts

@@ -0,0 +1,134 @@
+import type { ConversionOptions, CompareOptions, Revision } from "./types.js";
+export type { ConversionOptions, CompareOptions, Revision };
+export interface UseDocxodusResult {
+    /** Whether the WASM runtime is loaded and ready */
+    isReady: boolean;
+    /** Whether the runtime is currently loading */
+    isLoading: boolean;
+    /** Error that occurred during initialization, if any */
+    error: Error | null;
+    /** Convert DOCX to HTML */
+    convertToHtml: (document: File | Uint8Array, options?: ConversionOptions) => Promise<string>;
+    /** Compare two documents and return redlined DOCX */
+    compare: (original: File | Uint8Array, modified: File | Uint8Array, options?: CompareOptions) => Promise<Uint8Array>;
+    /** Compare two documents and return HTML */
+    compareToHtml: (original: File | Uint8Array, modified: File | Uint8Array, options?: CompareOptions) => Promise<string>;
+    /** Get revisions from a compared document */
+    getRevisions: (document: File | Uint8Array) => Promise<Revision[]>;
+}
+/**
+ * React hook for using Docxodus WASM functionality.
+ * Automatically initializes the WASM runtime on mount.
+ *
+ * @param wasmBasePath - Optional base path to WASM files
+ * @returns Object with ready state and document functions
+ *
+ * @example
+ * ```tsx
+ * function App() {
+ *   const { isReady, isLoading, error, convertToHtml } = useDocxodus('/wasm/');
+ *
+ *   const handleFile = async (file: File) => {
+ *     if (!isReady) return;
+ *     const html = await convertToHtml(file);
+ *     setHtml(html);
+ *   };
+ *
+ *   if (isLoading) return <div>Loading WASM...</div>;
+ *   if (error) return <div>Error: {error.message}</div>;
+ *
+ *   return <input type="file" onChange={e => handleFile(e.target.files[0])} />;
+ * }
+ * ```
+ */
+export declare function useDocxodus(wasmBasePath?: string): UseDocxodusResult;
+export interface UseConversionResult {
+    /** The converted HTML output */
+    html: string | null;
+    /** Whether a conversion is in progress */
+    isConverting: boolean;
+    /** Error from the last conversion attempt */
+    error: Error | null;
+    /** Convert a DOCX file to HTML */
+    convert: (document: File | Uint8Array, options?: ConversionOptions) => Promise<void>;
+    /** Clear the current result */
+    clear: () => void;
+}
+/**
+ * React hook for DOCX to HTML conversion with state management.
+ *
+ * @param wasmBasePath - Optional base path to WASM files
+ *
+ * @example
+ * ```tsx
+ * function Converter() {
+ *   const { html, isConverting, error, convert } = useConversion('/wasm/');
+ *
+ *   return (
+ *     <div>
+ *       <input
+ *         type="file"
+ *         accept=".docx"
+ *         onChange={e => e.target.files?.[0] && convert(e.target.files[0])}
+ *         disabled={isConverting}
+ *       />
+ *       {isConverting && <p>Converting...</p>}
+ *       {error && <p>Error: {error.message}</p>}
+ *       {html && <div dangerouslySetInnerHTML={{ __html: html }} />}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useConversion(wasmBasePath?: string): UseConversionResult;
+export interface UseComparisonResult {
+    /** The comparison result as a Uint8Array (redlined DOCX) */
+    result: Uint8Array | null;
+    /** The comparison result as HTML (if compareToHtml was used) */
+    html: string | null;
+    /** Revisions extracted from the comparison */
+    revisions: Revision[] | null;
+    /** Whether a comparison is in progress */
+    isComparing: boolean;
+    /** Error from the last comparison attempt */
+    error: Error | null;
+    /** Compare two documents and get redlined DOCX */
+    compare: (original: File | Uint8Array, modified: File | Uint8Array, options?: CompareOptions) => Promise<void>;
+    /** Compare two documents and get HTML */
+    compareToHtml: (original: File | Uint8Array, modified: File | Uint8Array, options?: CompareOptions) => Promise<void>;
+    /** Clear all results */
+    clear: () => void;
+    /** Download the result as a DOCX file */
+    downloadResult: (filename?: string) => void;
+}
+/**
+ * React hook for document comparison with state management.
+ *
+ * @param wasmBasePath - Optional base path to WASM files
+ *
+ * @example
+ * ```tsx
+ * function Comparer() {
+ *   const { html, isComparing, error, compareToHtml, downloadResult } = useComparison('/wasm/');
+ *   const [original, setOriginal] = useState<File | null>(null);
+ *   const [modified, setModified] = useState<File | null>(null);
+ *
+ *   const handleCompare = () => {
+ *     if (original && modified) {
+ *       compareToHtml(original, modified, { authorName: 'User' });
+ *     }
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <input type="file" onChange={e => setOriginal(e.target.files?.[0] ?? null)} />
+ *       <input type="file" onChange={e => setModified(e.target.files?.[0] ?? null)} />
+ *       <button onClick={handleCompare} disabled={isComparing}>Compare</button>
+ *       {html && <div dangerouslySetInnerHTML={{ __html: html }} />}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useComparison(wasmBasePath?: string): UseComparisonResult;
+//# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"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"}