docxodus 3.9.0 → 4.0.0

package/dist/docxodus.worker.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Docxodus Web Worker
+ *
+ * This worker runs the WASM runtime in a separate thread, keeping the main
+ * thread free for UI updates and user interactions.
+ *
+ * Communication is via postMessage with structured request/response types.
+ * Document bytes are transferred (not copied) for efficiency.
+ */
+export {};
+//# sourceMappingURL=docxodus.worker.d.ts.map

package/dist/docxodus.worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docxodus.worker.d.ts","sourceRoot":"","sources":["../src/docxodus.worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/docxodus.worker.js

@@ -0,0 +1,384 @@
+// src/docxodus.worker.ts
+var wasmExports = null;
+var initPromise = null;
+async function initializeWasm(basePath) {
+  if (wasmExports) {
+    return;
+  }
+  if (initPromise) {
+    return initPromise;
+  }
+  initPromise = (async () => {
+    try {
+      const normalizedPath = basePath.endsWith("/") ? basePath : basePath + "/";
+      const dotnetModule = await import(
+        /* webpackIgnore: true */
+        `${normalizedPath}_framework/dotnet.js`
+      );
+      const { getAssemblyExports, getConfig } = await dotnetModule.dotnet.withDiagnosticTracing(false).create();
+      const config = getConfig();
+      const exports = await getAssemblyExports(config.mainAssemblyName);
+      wasmExports = {
+        DocumentConverter: exports.DocxodusWasm.DocumentConverter,
+        DocumentComparer: exports.DocxodusWasm.DocumentComparer
+      };
+    } catch (error) {
+      initPromise = null;
+      throw error;
+    }
+  })();
+  return initPromise;
+}
+function ensureInitialized() {
+  if (!wasmExports) {
+    throw new Error("Worker not initialized. Call init first.");
+  }
+  return wasmExports;
+}
+function isErrorResponse(result) {
+  return result.startsWith("{") && result.includes('"Error"');
+}
+function parseError(result) {
+  try {
+    const parsed = JSON.parse(result);
+    return { error: parsed.Error || parsed.error || "Unknown error" };
+  } catch {
+    return { error: result };
+  }
+}
+function handleConvert(request) {
+  const exports = ensureInitialized();
+  const options = request.options;
+  try {
+    let result;
+    const needsCompleteMethod = options?.renderFootnotesAndEndnotes !== void 0 || options?.renderHeadersAndFooters !== void 0 || options?.renderTrackedChanges !== void 0 || options?.showDeletedContent !== void 0 || options?.renderMoveOperations !== void 0;
+    if (needsCompleteMethod || options?.renderAnnotations) {
+      result = exports.DocumentConverter.ConvertDocxToHtmlComplete(
+        request.documentBytes,
+        options?.pageTitle ?? "Document",
+        options?.cssPrefix ?? "docx-",
+        options?.fabricateClasses ?? true,
+        options?.additionalCss ?? "",
+        options?.commentRenderMode ?? -1,
+        options?.commentCssClassPrefix ?? "comment-",
+        options?.paginationMode ?? 0,
+        options?.paginationScale ?? 1,
+        options?.paginationCssClassPrefix ?? "page-",
+        options?.renderAnnotations ?? false,
+        options?.annotationLabelMode ?? 0,
+        options?.annotationCssClassPrefix ?? "annot-",
+        options?.renderFootnotesAndEndnotes ?? false,
+        options?.renderHeadersAndFooters ?? false,
+        options?.renderTrackedChanges ?? false,
+        options?.showDeletedContent ?? true,
+        options?.renderMoveOperations ?? true
+      );
+    } else if (options?.paginationMode !== void 0 && options.paginationMode !== 0) {
+      result = exports.DocumentConverter.ConvertDocxToHtmlWithPagination(
+        request.documentBytes,
+        options.pageTitle ?? "Document",
+        options.cssPrefix ?? "docx-",
+        options.fabricateClasses ?? true,
+        options.additionalCss ?? "",
+        options.commentRenderMode ?? -1,
+        options.commentCssClassPrefix ?? "comment-",
+        options.paginationMode,
+        options.paginationScale ?? 1,
+        options.paginationCssClassPrefix ?? "page-"
+      );
+    } else if (options) {
+      result = exports.DocumentConverter.ConvertDocxToHtmlWithOptions(
+        request.documentBytes,
+        options.pageTitle ?? "Document",
+        options.cssPrefix ?? "docx-",
+        options.fabricateClasses ?? true,
+        options.additionalCss ?? "",
+        options.commentRenderMode ?? -1,
+        options.commentCssClassPrefix ?? "comment-"
+      );
+    } else {
+      result = exports.DocumentConverter.ConvertDocxToHtml(
+        request.documentBytes
+      );
+    }
+    if (isErrorResponse(result)) {
+      return parseError(result);
+    }
+    return { html: result };
+  } catch (error) {
+    return { error: String(error) };
+  }
+}
+function handleCompare(request) {
+  const exports = ensureInitialized();
+  const options = request.options;
+  try {
+    let result;
+    if (options?.detailThreshold !== void 0 || options?.caseInsensitive) {
+      result = exports.DocumentComparer.CompareDocumentsWithOptions(
+        request.originalBytes,
+        request.modifiedBytes,
+        options?.authorName ?? "Docxodus",
+        options?.detailThreshold ?? 0.15,
+        options?.caseInsensitive ?? false
+      );
+    } else {
+      result = exports.DocumentComparer.CompareDocuments(
+        request.originalBytes,
+        request.modifiedBytes,
+        options?.authorName ?? "Docxodus"
+      );
+    }
+    if (result.length === 0) {
+      return { error: "Comparison returned empty result" };
+    }
+    return { documentBytes: result };
+  } catch (error) {
+    return { error: String(error) };
+  }
+}
+function handleCompareToHtml(request) {
+  const exports = ensureInitialized();
+  const options = request.options;
+  try {
+    const renderTrackedChanges = options?.renderTrackedChanges ?? true;
+    const result = exports.DocumentComparer.CompareDocumentsToHtmlWithOptions(
+      request.originalBytes,
+      request.modifiedBytes,
+      options?.authorName ?? "Docxodus",
+      renderTrackedChanges
+    );
+    if (isErrorResponse(result)) {
+      return parseError(result);
+    }
+    return { html: result };
+  } catch (error) {
+    return { error: String(error) };
+  }
+}
+function handleGetRevisions(request) {
+  const exports = ensureInitialized();
+  const options = request.options;
+  try {
+    const detectMoves = options?.detectMoves ?? true;
+    const moveSimilarityThreshold = options?.moveSimilarityThreshold ?? 0.8;
+    const moveMinimumWordCount = options?.moveMinimumWordCount ?? 3;
+    const caseInsensitive = options?.caseInsensitive ?? false;
+    const result = exports.DocumentComparer.GetRevisionsJsonWithOptions(
+      request.documentBytes,
+      detectMoves,
+      moveSimilarityThreshold,
+      moveMinimumWordCount,
+      caseInsensitive
+    );
+    if (isErrorResponse(result)) {
+      return parseError(result);
+    }
+    const parsed = JSON.parse(result);
+    const revisions = (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,
+        moveGroupId: r.MoveGroupId ?? r.moveGroupId,
+        isMoveSource: r.IsMoveSource ?? r.isMoveSource,
+        formatChange: r.FormatChange || r.formatChange ? {
+          oldProperties: r.FormatChange?.OldProperties || r.formatChange?.oldProperties,
+          newProperties: r.FormatChange?.NewProperties || r.formatChange?.newProperties,
+          changedPropertyNames: r.FormatChange?.ChangedPropertyNames || r.formatChange?.changedPropertyNames
+        } : void 0
+      })
+    );
+    return { revisions };
+  } catch (error) {
+    return { error: String(error) };
+  }
+}
+function handleGetDocumentMetadata(request) {
+  const exports = ensureInitialized();
+  try {
+    const result = exports.DocumentConverter.GetDocumentMetadata(
+      request.documentBytes
+    );
+    if (isErrorResponse(result)) {
+      return parseError(result);
+    }
+    const parsed = JSON.parse(result);
+    const convertSection = (s) => ({
+      sectionIndex: s.SectionIndex ?? s.sectionIndex,
+      pageWidthPt: s.PageWidthPt ?? s.pageWidthPt,
+      pageHeightPt: s.PageHeightPt ?? s.pageHeightPt,
+      marginTopPt: s.MarginTopPt ?? s.marginTopPt,
+      marginRightPt: s.MarginRightPt ?? s.marginRightPt,
+      marginBottomPt: s.MarginBottomPt ?? s.marginBottomPt,
+      marginLeftPt: s.MarginLeftPt ?? s.marginLeftPt,
+      contentWidthPt: s.ContentWidthPt ?? s.contentWidthPt,
+      contentHeightPt: s.ContentHeightPt ?? s.contentHeightPt,
+      headerPt: s.HeaderPt ?? s.headerPt,
+      footerPt: s.FooterPt ?? s.footerPt,
+      paragraphCount: s.ParagraphCount ?? s.paragraphCount,
+      tableCount: s.TableCount ?? s.tableCount,
+      hasHeader: s.HasHeader ?? s.hasHeader,
+      hasFooter: s.HasFooter ?? s.hasFooter,
+      hasFirstPageHeader: s.HasFirstPageHeader ?? s.hasFirstPageHeader,
+      hasFirstPageFooter: s.HasFirstPageFooter ?? s.hasFirstPageFooter,
+      hasEvenPageHeader: s.HasEvenPageHeader ?? s.hasEvenPageHeader,
+      hasEvenPageFooter: s.HasEvenPageFooter ?? s.hasEvenPageFooter,
+      startParagraphIndex: s.StartParagraphIndex ?? s.startParagraphIndex,
+      endParagraphIndex: s.EndParagraphIndex ?? s.endParagraphIndex,
+      startTableIndex: s.StartTableIndex ?? s.startTableIndex,
+      endTableIndex: s.EndTableIndex ?? s.endTableIndex
+    });
+    const metadata = {
+      sections: (parsed.Sections || parsed.sections || []).map(convertSection),
+      totalParagraphs: parsed.TotalParagraphs ?? parsed.totalParagraphs,
+      totalTables: parsed.TotalTables ?? parsed.totalTables,
+      hasFootnotes: parsed.HasFootnotes ?? parsed.hasFootnotes,
+      hasEndnotes: parsed.HasEndnotes ?? parsed.hasEndnotes,
+      hasTrackedChanges: parsed.HasTrackedChanges ?? parsed.hasTrackedChanges,
+      hasComments: parsed.HasComments ?? parsed.hasComments,
+      estimatedPageCount: parsed.EstimatedPageCount ?? parsed.estimatedPageCount
+    };
+    return { metadata };
+  } catch (error) {
+    return { error: String(error) };
+  }
+}
+function handleGetVersion() {
+  const exports = ensureInitialized();
+  try {
+    const result = exports.DocumentConverter.GetVersion();
+    const parsed = JSON.parse(result);
+    return {
+      version: {
+        library: parsed.Library || parsed.library,
+        dotnetVersion: parsed.DotnetVersion || parsed.dotnetVersion,
+        platform: parsed.Platform || parsed.platform
+      }
+    };
+  } catch (error) {
+    return { error: String(error) };
+  }
+}
+self.onmessage = async (event) => {
+  const request = event.data;
+  try {
+    let response;
+    switch (request.type) {
+      case "init": {
+        const initRequest = request;
+        try {
+          await initializeWasm(initRequest.wasmBasePath);
+          response = {
+            id: request.id,
+            type: "init",
+            success: true
+          };
+        } catch (error) {
+          response = {
+            id: request.id,
+            type: "init",
+            success: false,
+            error: String(error)
+          };
+        }
+        break;
+      }
+      case "convertDocxToHtml": {
+        const convertRequest = request;
+        const result = handleConvert(convertRequest);
+        response = {
+          id: request.id,
+          type: "convertDocxToHtml",
+          success: !result.error,
+          html: result.html,
+          error: result.error
+        };
+        break;
+      }
+      case "compareDocuments": {
+        const compareRequest = request;
+        const result = handleCompare(compareRequest);
+        response = {
+          id: request.id,
+          type: "compareDocuments",
+          success: !result.error,
+          documentBytes: result.documentBytes,
+          error: result.error
+        };
+        if (result.documentBytes) {
+          self.postMessage(response, { transfer: [result.documentBytes.buffer] });
+          return;
+        }
+        break;
+      }
+      case "compareDocumentsToHtml": {
+        const compareToHtmlRequest = request;
+        const result = handleCompareToHtml(compareToHtmlRequest);
+        response = {
+          id: request.id,
+          type: "compareDocumentsToHtml",
+          success: !result.error,
+          html: result.html,
+          error: result.error
+        };
+        break;
+      }
+      case "getRevisions": {
+        const getRevisionsRequest = request;
+        const result = handleGetRevisions(getRevisionsRequest);
+        response = {
+          id: request.id,
+          type: "getRevisions",
+          success: !result.error,
+          revisions: result.revisions,
+          error: result.error
+        };
+        break;
+      }
+      case "getDocumentMetadata": {
+        const getMetadataRequest = request;
+        const result = handleGetDocumentMetadata(getMetadataRequest);
+        response = {
+          id: request.id,
+          type: "getDocumentMetadata",
+          success: !result.error,
+          metadata: result.metadata,
+          error: result.error
+        };
+        break;
+      }
+      case "getVersion": {
+        const result = handleGetVersion();
+        response = {
+          id: request.id,
+          type: "getVersion",
+          success: !result.error,
+          version: result.version,
+          error: result.error
+        };
+        break;
+      }
+      default: {
+        const unknownRequest = request;
+        self.postMessage({
+          id: unknownRequest.id,
+          type: unknownRequest.type,
+          success: false,
+          error: `Unknown request type: ${unknownRequest.type}`
+        });
+        return;
+      }
+    }
+    self.postMessage(response);
+  } catch (error) {
+    self.postMessage({
+      id: request.id,
+      type: request.type,
+      success: false,
+      error: String(error)
+    });
+  }
+};
+self.postMessage({ type: "ready" });

package/dist/docxodus.worker.js.map

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

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import type { ConversionOptions, CompareOptions, Revision, VersionInfo, ErrorResponse, CompareResult, GetRevisionsOptions, FormatChangeDetails, Annotation, AddAnnotationRequest, AddAnnotationResponse, RemoveAnnotationResponse, AnnotationOptions, DocumentStructure, DocumentElement, TableColumnInfo, AnnotationTarget, AddAnnotationWithTargetRequest } from "./types.js";
+import type { ConversionOptions, CompareOptions, Revision, VersionInfo, ErrorResponse, CompareResult, GetRevisionsOptions, FormatChangeDetails, Annotation, AddAnnotationRequest, AddAnnotationResponse, RemoveAnnotationResponse, AnnotationOptions, DocumentStructure, DocumentElement, TableColumnInfo, AnnotationTarget, AddAnnotationWithTargetRequest, DocumentMetadata, SectionMetadata } from "./types.js";
 import { CommentRenderMode, PaginationMode, AnnotationLabelMode, RevisionType, DocumentElementType, isInsertion, isDeletion, isMove, isMoveSource, isMoveDestination, findMovePair, isFormatChange, findElementById, findElementsByType, getParagraphs, getTables, getTableColumns, targetElement, targetParagraph, targetParagraphRange, targetRun, targetTable, targetTableRow, targetTableCell, targetTableColumn, targetSearch, targetSearchInElement } from "./types.js";
 export type { PageDimensions, MeasuredBlock, PageInfo, PaginationResult, PaginationOptions, } from "./pagination.js";
 export { PaginationEngine, paginateHtml } from "./pagination.js";
-export type { ConversionOptions, CompareOptions, Revision, VersionInfo, ErrorResponse, CompareResult, GetRevisionsOptions, FormatChangeDetails, Annotation, AddAnnotationRequest, AddAnnotationResponse, RemoveAnnotationResponse, AnnotationOptions, DocumentStructure, DocumentElement, TableColumnInfo, AnnotationTarget, AddAnnotationWithTargetRequest, };
+export type { ConversionOptions, CompareOptions, Revision, VersionInfo, ErrorResponse, CompareResult, GetRevisionsOptions, FormatChangeDetails, Annotation, AddAnnotationRequest, AddAnnotationResponse, RemoveAnnotationResponse, AnnotationOptions, DocumentStructure, DocumentElement, TableColumnInfo, AnnotationTarget, AddAnnotationWithTargetRequest, DocumentMetadata, SectionMetadata, };
 export { CommentRenderMode, PaginationMode, AnnotationLabelMode, RevisionType, DocumentElementType, isInsertion, isDeletion, isMove, isMoveSource, isMoveDestination, findMovePair, isFormatChange, findElementById, findElementsByType, getParagraphs, getTables, getTableColumns, targetElement, targetParagraph, targetParagraphRange, targetRun, targetTable, targetTableRow, targetTableCell, targetTableColumn, targetSearch, targetSearchInElement, };
 /**
  * Current base path for WASM files.
@@ -241,6 +241,40 @@ export declare function hasAnnotations(document: File | Uint8Array): Promise<boo
  * ```
  */
 export declare function getDocumentStructure(document: File | Uint8Array): Promise<DocumentStructure>;
+/**
+ * Get document metadata for lazy loading pagination.
+ * This is a fast operation that extracts structure information without full HTML rendering.
+ *
+ * @param document - DOCX file as File object or Uint8Array
+ * @returns Document metadata including sections, dimensions, and content counts
+ * @throws Error if operation fails
+ *
+ * @example
+ * ```typescript
+ * const metadata = await getDocumentMetadata(docxFile);
+ *
+ * // Check document overview
+ * console.log(`Document has ${metadata.totalParagraphs} paragraphs`);
+ * console.log(`Document has ${metadata.sections.length} sections`);
+ * console.log(`Estimated ${metadata.estimatedPageCount} pages`);
+ *
+ * // Check section properties
+ * for (const section of metadata.sections) {
+ *   console.log(`Section ${section.sectionIndex}: ${section.pageWidthPt}x${section.pageHeightPt}pt`);
+ *   console.log(`  Paragraphs: ${section.paragraphCount}, Tables: ${section.tableCount}`);
+ *   console.log(`  Has header: ${section.hasHeader}, Has footer: ${section.hasFooter}`);
+ * }
+ *
+ * // Check document features
+ * if (metadata.hasTrackedChanges) {
+ *   console.log("Document has tracked changes");
+ * }
+ * if (metadata.hasFootnotes) {
+ *   console.log("Document has footnotes");
+ * }
+ * ```
+ */
+export declare function getDocumentMetadata(document: File | Uint8Array): Promise<DocumentMetadata>;
 /**
  * Add an annotation using flexible targeting (element ID, indices, or text search).
  *

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -7,6 +7,32 @@ findElementById, findElementsByType, getParagraphs, getTables, getTableColumns,
 targetElement, targetParagraph, targetParagraphRange, targetRun, targetTable, targetTableRow, targetTableCell, targetTableColumn, targetSearch, targetSearchInElement, };
 let wasmExports = null;
 let initPromise = null;
+/**
+ * Yields to the browser's main thread, allowing pending UI updates to render.
+ *
+ * This is critical for WASM operations: since WASM runs synchronously on the
+ * main thread, React state updates (like loading spinners) won't paint unless
+ * we yield before the blocking work begins.
+ *
+ * Uses requestAnimationFrame which fires just before the next paint, ensuring
+ * any queued state updates are committed to the DOM.
+ *
+ * @internal
+ */
+async function yieldToMain() {
+    // In non-browser environments (SSR, tests), skip yielding
+    if (typeof requestAnimationFrame === "undefined") {
+        return;
+    }
+    // Double-rAF ensures the browser has fully painted before we continue
+    // First rAF: scheduled for next frame
+    // Second rAF: ensures first frame actually painted
+    await new Promise((resolve) => {
+        requestAnimationFrame(() => {
+            requestAnimationFrame(() => resolve());
+        });
+    });
+}
 /**
  * Derive the WASM base path from this module's URL.
  * Works whether loaded from node_modules, CDN, or bundled.
@@ -188,6 +214,8 @@ async function toBytes(input) {
 export async function convertDocxToHtml(document, options) {
     const exports = ensureInitialized();
     const bytes = await toBytes(document);
+    // Yield to browser before heavy WASM work - allows loading states to render
+    await yieldToMain();
     let result;
     // Check if any of the new complete options are specified
     const needsCompleteMethod = options?.renderFootnotesAndEndnotes !== undefined ||
@@ -228,6 +256,8 @@ export async function compareDocuments(original, modified, options) {
     const exports = ensureInitialized();
     const originalBytes = await toBytes(original);
     const modifiedBytes = await toBytes(modified);
+    // Yield to browser before heavy WASM work - allows loading states to render
+    await yieldToMain();
     let result;
     if (options?.detailThreshold !== undefined || options?.caseInsensitive) {
         result = exports.DocumentComparer.CompareDocumentsWithOptions(originalBytes, modifiedBytes, options?.authorName ?? "Docxodus", options?.detailThreshold ?? 0.15, options?.caseInsensitive ?? false);
@@ -253,6 +283,8 @@ export async function compareDocumentsToHtml(original, modified, options) {
     const exports = ensureInitialized();
     const originalBytes = await toBytes(original);
     const modifiedBytes = await toBytes(modified);
+    // Yield to browser before heavy WASM work - allows loading states to render
+    await yieldToMain();
     // Use the new options method if renderTrackedChanges is explicitly set
     const renderTrackedChanges = options?.renderTrackedChanges ?? true;
     const result = exports.DocumentComparer.CompareDocumentsToHtmlWithOptions(originalBytes, modifiedBytes, options?.authorName ?? "Docxodus", renderTrackedChanges);
@@ -290,6 +322,8 @@ export async function compareDocumentsToHtml(original, modified, options) {
 export async function getRevisions(document, options) {
     const exports = ensureInitialized();
     const bytes = await toBytes(document);
+    // Yield to browser before WASM work - allows loading states to render
+    await yieldToMain();
     // Apply defaults for move detection options
     const detectMoves = options?.detectMoves ?? true;
     const moveSimilarityThreshold = options?.moveSimilarityThreshold ?? 0.8;
@@ -409,6 +443,8 @@ export async function getAnnotations(document) {
 export async function addAnnotation(document, request) {
     const exports = ensureInitialized();
     const bytes = await toBytes(document);
+    // Yield to browser before WASM work - allows loading states to render
+    await yieldToMain();
     const requestJson = JSON.stringify({
         Id: request.id,
         LabelId: request.labelId,
@@ -532,6 +568,8 @@ export async function hasAnnotations(document) {
 export async function getDocumentStructure(document) {
     const exports = ensureInitialized();
     const bytes = await toBytes(document);
+    // Yield to browser before WASM work - allows loading states to render
+    await yieldToMain();
     const result = exports.DocumentConverter.GetDocumentStructure(bytes);
     if (isErrorResponse(result)) {
         const error = parseError(result);
@@ -575,6 +613,87 @@ export async function getDocumentStructure(document) {
         tableColumns,
     };
 }
+/**
+ * Get document metadata for lazy loading pagination.
+ * This is a fast operation that extracts structure information without full HTML rendering.
+ *
+ * @param document - DOCX file as File object or Uint8Array
+ * @returns Document metadata including sections, dimensions, and content counts
+ * @throws Error if operation fails
+ *
+ * @example
+ * ```typescript
+ * const metadata = await getDocumentMetadata(docxFile);
+ *
+ * // Check document overview
+ * console.log(`Document has ${metadata.totalParagraphs} paragraphs`);
+ * console.log(`Document has ${metadata.sections.length} sections`);
+ * console.log(`Estimated ${metadata.estimatedPageCount} pages`);
+ *
+ * // Check section properties
+ * for (const section of metadata.sections) {
+ *   console.log(`Section ${section.sectionIndex}: ${section.pageWidthPt}x${section.pageHeightPt}pt`);
+ *   console.log(`  Paragraphs: ${section.paragraphCount}, Tables: ${section.tableCount}`);
+ *   console.log(`  Has header: ${section.hasHeader}, Has footer: ${section.hasFooter}`);
+ * }
+ *
+ * // Check document features
+ * if (metadata.hasTrackedChanges) {
+ *   console.log("Document has tracked changes");
+ * }
+ * if (metadata.hasFootnotes) {
+ *   console.log("Document has footnotes");
+ * }
+ * ```
+ */
+export async function getDocumentMetadata(document) {
+    const exports = ensureInitialized();
+    const bytes = await toBytes(document);
+    // Yield to browser before WASM work - allows loading states to render
+    await yieldToMain();
+    const result = exports.DocumentConverter.GetDocumentMetadata(bytes);
+    if (isErrorResponse(result)) {
+        const error = parseError(result);
+        throw new Error(`Failed to get document metadata: ${error.error}`);
+    }
+    const parsed = JSON.parse(result);
+    // Convert from PascalCase to camelCase
+    const convertSection = (s) => ({
+        sectionIndex: s.SectionIndex ?? s.sectionIndex,
+        pageWidthPt: s.PageWidthPt ?? s.pageWidthPt,
+        pageHeightPt: s.PageHeightPt ?? s.pageHeightPt,
+        marginTopPt: s.MarginTopPt ?? s.marginTopPt,
+        marginRightPt: s.MarginRightPt ?? s.marginRightPt,
+        marginBottomPt: s.MarginBottomPt ?? s.marginBottomPt,
+        marginLeftPt: s.MarginLeftPt ?? s.marginLeftPt,
+        contentWidthPt: s.ContentWidthPt ?? s.contentWidthPt,
+        contentHeightPt: s.ContentHeightPt ?? s.contentHeightPt,
+        headerPt: s.HeaderPt ?? s.headerPt,
+        footerPt: s.FooterPt ?? s.footerPt,
+        paragraphCount: s.ParagraphCount ?? s.paragraphCount,
+        tableCount: s.TableCount ?? s.tableCount,
+        hasHeader: s.HasHeader ?? s.hasHeader,
+        hasFooter: s.HasFooter ?? s.hasFooter,
+        hasFirstPageHeader: s.HasFirstPageHeader ?? s.hasFirstPageHeader,
+        hasFirstPageFooter: s.HasFirstPageFooter ?? s.hasFirstPageFooter,
+        hasEvenPageHeader: s.HasEvenPageHeader ?? s.hasEvenPageHeader,
+        hasEvenPageFooter: s.HasEvenPageFooter ?? s.hasEvenPageFooter,
+        startParagraphIndex: s.StartParagraphIndex ?? s.startParagraphIndex,
+        endParagraphIndex: s.EndParagraphIndex ?? s.endParagraphIndex,
+        startTableIndex: s.StartTableIndex ?? s.startTableIndex,
+        endTableIndex: s.EndTableIndex ?? s.endTableIndex,
+    });
+    return {
+        sections: (parsed.Sections || parsed.sections || []).map(convertSection),
+        totalParagraphs: parsed.TotalParagraphs ?? parsed.totalParagraphs,
+        totalTables: parsed.TotalTables ?? parsed.totalTables,
+        hasFootnotes: parsed.HasFootnotes ?? parsed.hasFootnotes,
+        hasEndnotes: parsed.HasEndnotes ?? parsed.hasEndnotes,
+        hasTrackedChanges: parsed.HasTrackedChanges ?? parsed.hasTrackedChanges,
+        hasComments: parsed.HasComments ?? parsed.hasComments,
+        estimatedPageCount: parsed.EstimatedPageCount ?? parsed.estimatedPageCount,
+    };
+}
 /**
  * Add an annotation using flexible targeting (element ID, indices, or text search).
  *
@@ -628,6 +747,8 @@ export async function getDocumentStructure(document) {
 export async function addAnnotationWithTarget(document, request) {
     const exports = ensureInitialized();
     const bytes = await toBytes(document);
+    // Yield to browser before WASM work - allows loading states to render
+    await yieldToMain();
     const requestJson = JSON.stringify({
         Id: request.id,
         LabelId: request.labelId,