@agilehub/docx-converter 0.0.0-stage → 0.2.0

package/dist/browser-metafile.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./metafile-rasterizer-C9QNCFz9.cjs");function t(t){return e.t(t)}function n(t){return t.formula?e.t(t):Promise.resolve(void 0)}exports.convertMathTypePreview=n,exports.convertMetafileImage=t;

package/dist/browser-metafile.d.ts

@@ -0,0 +1 @@
+export { convertMetafileImage, convertMathTypePreview } from './adapters/browser/metafile-preview.js';

package/dist/browser-metafile.js

@@ -0,0 +1,9 @@
+import { t as e } from "./metafile-rasterizer-B07sBlcp.js";
+// src/adapters/browser/metafile-preview.ts
+function t(t) {
+	return e(t);
+}
+function n(t) {
+	return t.formula ? e(t) : Promise.resolve(void 0);
+}
+export { n as convertMathTypePreview, t as convertMetafileImage };

package/dist/contracts/conversion.d.ts

@@ -0,0 +1,92 @@
+/** HTTP(S) URL, browser File/Blob, ArrayBuffer or Node Buffer (a Uint8Array). */
+export type DocxInput = Blob | ArrayBuffer | Uint8Array | string;
+export interface Diagnostic {
+    code: string;
+    message: string;
+    part?: string;
+}
+export interface ProgressEvent {
+    stage: 'reading' | 'extracting' | 'parsing' | 'rendering' | 'complete';
+    completed?: number;
+    total?: number;
+}
+export interface Resource {
+    path: string;
+    mimeType: string;
+    bytes: Uint8Array;
+}
+export interface ImageContext extends Resource {
+    alt: string;
+    formula: boolean;
+}
+export interface ImageResult {
+    bytes: Uint8Array;
+    mimeType: string;
+}
+export interface ProcessedImage {
+    fileUrl: string;
+    fileSize?: number;
+    fileName?: string;
+}
+export type LargeImageHandler = (fileBlob: Blob, fileSuffix: string, fileName: string) => ProcessedImage | Promise<ProcessedImage>;
+export interface ConversionLimits {
+    inputBytes: number;
+    totalBytes: number;
+    entryBytes: number;
+    entries: number;
+    xmlDepth: number;
+}
+export interface ConversionOptions {
+    output?: 'document' | 'fragment';
+    /** OMML equations render as images by default; mathml keeps semantic markup instead. */
+    formulaOutput?: 'image' | 'mathml';
+    /**
+     * Format for generated formula and chart images.
+     * Defaults to PNG. Use SVG when scalable vectors and smaller markup are preferred.
+     */
+    generatedImageOutput?: 'png' | 'svg';
+    /** Word grouped drawings: format override; omitted follows generatedImageOutput. */
+    drawingOutput?: 'png' | 'svg';
+    title?: string;
+    imageHandler?: {
+        /** Defaults to 2048 bytes (2 KB). Images at or below the threshold stay Base64 even with processLargeImage; larger ones use that callback when supplied. */
+        base64ImageSize?: number;
+        /** Receives the final displayable image after any format conversion; its fileUrl becomes <img src>. */
+        processLargeImage?: LargeImageHandler;
+        /** Called only for browser-supported raster formats. Returned URLs are checked. */
+        resolve?: (image: ImageContext) => string | Promise<string>;
+        /** Override or extend built-in EMF handling; return PNG/JPEG/GIF/WebP bytes for WMF/TIFF/SVG etc. */
+        convert?: (image: ImageContext) => ImageResult | undefined | Promise<ImageResult | undefined>;
+    };
+    onProgress?: (event: ProgressEvent) => void;
+    signal?: AbortSignal;
+    limits?: Partial<ConversionLimits>;
+}
+export interface ConversionResult {
+    html: string;
+    warnings: Diagnostic[];
+    /** Includes unsupported original images and embedded OLE files for caller recovery. */
+    resources: Resource[];
+    stats: {
+        paragraphs: number;
+        tables: number;
+        images: number;
+        formulas: number;
+    };
+}
+export interface PdfConversionOptions extends ConversionOptions {
+    pdf?: {
+        format?: 'a4' | 'letter';
+        landscape?: boolean;
+        /** Page margins in millimeters. Default 15. */
+        margin?: number;
+        /** Browser rasterization scale, default 2 (1–4). */
+        scale?: number;
+        /** Node only: local Chrome/Edge executable; omitted uses installed Chrome. */
+        executablePath?: string;
+    };
+}
+export interface PdfConversionResult extends Omit<ConversionResult, 'html'> {
+    bytes: Uint8Array;
+    mimeType: 'application/pdf';
+}

package/dist/contracts/errors.d.ts

@@ -0,0 +1,4 @@
+export declare class DocxError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}

package/dist/contracts/ports.d.ts

@@ -0,0 +1,16 @@
+import type { Diagnostic, ProgressEvent } from './conversion.js';
+/** Minimal resource access needed by output strategies; no ZIP/XML dependency. */
+export interface ResourceReader {
+    bytes(path: string): Uint8Array | undefined;
+    mime(path: string): string;
+}
+export interface DiagnosticSink {
+    report(diagnostic: Diagnostic): void;
+}
+/** Per-conversion operations passed to modules instead of sharing the parser. */
+export interface ConversionContext extends DiagnosticSink {
+    warn(code: string, message: string): void;
+    checkAbort(): void;
+    progress(event: ProgressEvent): void;
+}
+export type RenderContext = Pick<ConversionContext, 'warn' | 'checkAbort'>;