@wonderwhy-er/desktop-commander 0.2.38 → 0.2.39

package/dist/tools/docx/parsers/zip-reader.d.ts

@@ -1,23 +0,0 @@
-/**
- * ZIP File Reader
- * Utilities for reading files from DOCX ZIP archives
- */
-declare const PizZip: any;
-export type ZipArchive = InstanceType<typeof PizZip>;
-/**
- * Create a ZIP archive from a buffer
- */
-export declare function createZipFromBuffer(buffer: Buffer): ZipArchive;
-/**
- * Read a text file from a ZIP archive
- */
-export declare function readZipFileText(zip: ZipArchive, filePath: string): string | null;
-/**
- * Read a binary file from a ZIP archive as Buffer
- */
-export declare function readZipFileBuffer(zip: ZipArchive, filePath: string): Buffer | null;
-/**
- * Check if a file exists in the ZIP archive
- */
-export declare function zipFileExists(zip: ZipArchive, filePath: string): boolean;
-export {};

package/dist/tools/docx/parsers/zip-reader.js

@@ -1,52 +0,0 @@
-/**
- * ZIP File Reader
- * Utilities for reading files from DOCX ZIP archives
- */
-import { createRequire } from 'module';
-const require = createRequire(import.meta.url);
-const PizZip = require('pizzip');
-/**
- * Create a ZIP archive from a buffer
- */
-export function createZipFromBuffer(buffer) {
-    return new PizZip(buffer);
-}
-/**
- * Read a text file from a ZIP archive
- */
-export function readZipFileText(zip, filePath) {
-    const file = zip.file(filePath);
-    if (!file)
-        return null;
-    if (typeof file.asText === 'function') {
-        return file.asText();
-    }
-    if (typeof file.asBinary === 'function') {
-        return Buffer.from(file.asBinary(), 'binary').toString('utf8');
-    }
-    return null;
-}
-/**
- * Read a binary file from a ZIP archive as Buffer
- */
-export function readZipFileBuffer(zip, filePath) {
-    const file = zip.file(filePath);
-    if (!file)
-        return null;
-    if (typeof file.asUint8Array === 'function') {
-        return Buffer.from(file.asUint8Array());
-    }
-    if (typeof file.asNodeBuffer === 'function') {
-        return file.asNodeBuffer();
-    }
-    if (typeof file.asBinary === 'function') {
-        return Buffer.from(file.asBinary(), 'binary');
-    }
-    return null;
-}
-/**
- * Check if a file exists in the ZIP archive
- */
-export function zipFileExists(zip, filePath) {
-    return zip.file(filePath) !== null;
-}

package/dist/tools/docx/read.d.ts

@@ -1,27 +0,0 @@
-/**
- * DOCX reading utilities
- * Extracts text, metadata, and compact outlines from DOCX files.
- */
-import type { DocxMetadata, DocxParagraph, ReadDocxResult } from './types.js';
-/**
- * Return a token-efficient outline of a DOCX file.
- * Extracts paragraphs, tables (with full cell content), and images (references only, not binary).
- * Every element gets a bodyChildIndex (among ALL w:body children).
- */
-export declare function readDocxOutline(filePath: string): Promise<ReadDocxResult>;
-/** Extract plain text from DOCX. */
-export declare function extractTextFromDocx(path: string): Promise<string>;
-/** Get comprehensive metadata. */
-export declare function getDocxMetadata(path: string): Promise<DocxMetadata>;
-/** Extract body XML. */
-export declare function extractBodyXml(path: string): Promise<string>;
-/** Read DOCX file with optional pagination. */
-export declare function readDocx(path: string, options?: {
-    offset?: number;
-    length?: number;
-}): Promise<{
-    text: string;
-    paragraphs: DocxParagraph[];
-    metadata: DocxMetadata;
-    bodyXml: string;
-}>;

package/dist/tools/docx/read.js

@@ -1,308 +0,0 @@
-/**
- * DOCX reading utilities
- * Extracts text, metadata, and compact outlines from DOCX files.
- */
-import fs from 'fs/promises';
-import PizZip from 'pizzip';
-import { DOMParser, XMLSerializer } from '@xmldom/xmldom';
-import { nodeListToArray, getParagraphText, getParagraphStyle, getBody, getBodyChildren, getAllBodyTables, countImages, getTableContent, getTableStyle, getImageReference, } from './dom.js';
-// ═══════════════════════════════════════════════════════════════════════
-// Internal helpers
-// ═══════════════════════════════════════════════════════════════════════
-async function loadDocx(path) {
-    const inputBuf = await fs.readFile(path);
-    return new PizZip(inputBuf);
-}
-// ═══════════════════════════════════════════════════════════════════════
-// readDocxOutline — compact JSON outline (used by read_docx tool)
-// ═══════════════════════════════════════════════════════════════════════
-/**
- * Extract image relationship mappings from word/_rels/document.xml.rels.
- * Returns a map of rId -> mediaPath (e.g., "rId1" -> "word/media/image1.png").
- */
-function extractImageRelationships(zip) {
-    const relsPath = 'word/_rels/document.xml.rels';
-    const relsFile = zip.file(relsPath);
-    if (!relsFile)
-        return new Map();
-    const relsXml = relsFile.asText();
-    const relsDom = new DOMParser().parseFromString(relsXml, 'application/xml');
-    const relationships = relsDom.getElementsByTagName('Relationship');
-    const imageMap = new Map();
-    for (const rel of nodeListToArray(relationships)) {
-        const relEl = rel;
-        const type = relEl.getAttribute('Type');
-        const id = relEl.getAttribute('Id');
-        const target = relEl.getAttribute('Target');
-        // Check if it's an image relationship
-        if (type &&
-            type.includes('/image') &&
-            id &&
-            target &&
-            target.startsWith('media/')) {
-            imageMap.set(id, `word/${target}`);
-        }
-    }
-    return imageMap;
-}
-/**
- * Extract alt text from wp:docPr/@descr or pic:cNvPr/@descr in a drawing element.
- */
-function getImageAltText(drawing) {
-    // Try wp:docPr/@descr first
-    const docPr = drawing.getElementsByTagName('wp:docPr').item(0);
-    if (docPr) {
-        const descr = docPr.getAttribute('descr');
-        if (descr)
-            return descr;
-    }
-    // Fall back to pic:cNvPr/@descr
-    const cNvPr = drawing.getElementsByTagName('pic:cNvPr').item(0);
-    if (cNvPr) {
-        const descr = cNvPr.getAttribute('descr');
-        if (descr)
-            return descr;
-    }
-    return undefined;
-}
-/**
- * Return a token-efficient outline of a DOCX file.
- * Extracts paragraphs, tables (with full cell content), and images (references only, not binary).
- * Every element gets a bodyChildIndex (among ALL w:body children).
- */
-export async function readDocxOutline(filePath) {
-    const zip = await loadDocx(filePath);
-    const docFile = zip.file('word/document.xml');
-    if (!docFile)
-        throw new Error('Invalid DOCX: missing word/document.xml');
-    const xmlStr = docFile.asText();
-    const dom = new DOMParser().parseFromString(xmlStr, 'application/xml');
-    const body = getBody(dom);
-    const children = getBodyChildren(body);
-    // Extract image relationships (rId -> mediaPath)
-    const imageRelationships = extractImageRelationships(zip);
-    const paragraphs = [];
-    const tables = [];
-    const images = [];
-    const stylesSet = new Set();
-    let paragraphIndex = 0;
-    let tableIndex = 0;
-    let imageIndex = 0;
-    for (let i = 0; i < children.length; i++) {
-        const child = children[i];
-        if (child.nodeName === 'w:p') {
-            // Extract paragraph
-            const text = getParagraphText(child).trim();
-            const style = getParagraphStyle(child);
-            if (style)
-                stylesSet.add(style);
-            paragraphs.push({
-                bodyChildIndex: i,
-                paragraphIndex,
-                style,
-                text,
-            });
-            paragraphIndex++;
-            // Check if paragraph contains an image (w:drawing)
-            const drawings = child.getElementsByTagName('w:drawing');
-            for (let d = 0; d < drawings.length; d++) {
-                const drawing = drawings.item(d);
-                const imgRef = getImageReference(drawing);
-                if (imgRef.rId) {
-                    const mediaPath = imageRelationships.get(imgRef.rId);
-                    if (mediaPath) {
-                        const altText = getImageAltText(drawing);
-                        images.push({
-                            bodyChildIndex: i,
-                            imageIndex,
-                            mediaPath,
-                            rId: imgRef.rId,
-                            altText,
-                        });
-                        imageIndex++;
-                    }
-                }
-            }
-        }
-        else if (child.nodeName === 'w:tbl') {
-            // Extract table content (direct table in body)
-            const tableContent = getTableContent(child);
-            const style = getTableStyle(child);
-            if (style)
-                stylesSet.add(style);
-            tables.push({
-                bodyChildIndex: i,
-                tableIndex,
-                style,
-                headers: tableContent.headers,
-                rows: tableContent.rows,
-            });
-            tableIndex++;
-        }
-        else if (child.nodeName === 'w:sdt') {
-            // Structured document tag: look inside w:sdtContent for tables that
-            // are logically at this body position.
-            const sdtContent = child.getElementsByTagName('w:sdtContent').item(0);
-            if (sdtContent) {
-                for (const sdtChild of nodeListToArray(sdtContent.childNodes)) {
-                    if (sdtChild.nodeType === 1 &&
-                        sdtChild.nodeName === 'w:tbl') {
-                        const tbl = sdtChild;
-                        const tableContent = getTableContent(tbl);
-                        const style = getTableStyle(tbl);
-                        if (style)
-                            stylesSet.add(style);
-                        tables.push({
-                            bodyChildIndex: i,
-                            tableIndex,
-                            style,
-                            headers: tableContent.headers,
-                            rows: tableContent.rows,
-                        });
-                        tableIndex++;
-                    }
-                }
-            }
-        }
-    }
-    return {
-        path: filePath,
-        paragraphs,
-        tables,
-        images,
-        stylesSeen: [...stylesSet].sort(),
-        counts: {
-            // Table count should reflect all logical tables, including those
-            // wrapped in SDTs, so we reuse the same helper used by ops.
-            tables: getAllBodyTables(body).length,
-            images: countImages(body),
-            bodyChildren: children.length,
-        },
-    };
-}
-// ═══════════════════════════════════════════════════════════════════════
-// Legacy read functions (used by read_file handler / file handler)
-// ═══════════════════════════════════════════════════════════════════════
-/** Extract plain text from DOCX. */
-export async function extractTextFromDocx(path) {
-    const zip = await loadDocx(path);
-    const docFile = zip.file('word/document.xml');
-    if (!docFile)
-        throw new Error('Invalid DOCX: missing word/document.xml');
-    const xmlStr = docFile.asText();
-    const dom = new DOMParser().parseFromString(xmlStr, 'application/xml');
-    const body = dom.getElementsByTagName('w:body').item(0);
-    if (!body)
-        throw new Error('Invalid DOCX: missing w:body');
-    const paragraphs = [];
-    for (const child of nodeListToArray(body.childNodes)) {
-        if (child.nodeType !== 1)
-            continue;
-        if (child.nodeName !== 'w:p')
-            continue;
-        const text = getParagraphText(child).trim();
-        if (text)
-            paragraphs.push(text);
-    }
-    return paragraphs.join('\n\n');
-}
-/** Extract paragraphs from DOCX. */
-async function extractParagraphs(path) {
-    const zip = await loadDocx(path);
-    const docFile = zip.file('word/document.xml');
-    if (!docFile)
-        throw new Error('Invalid DOCX: missing word/document.xml');
-    const xmlStr = docFile.asText();
-    const dom = new DOMParser().parseFromString(xmlStr, 'application/xml');
-    const body = dom.getElementsByTagName('w:body').item(0);
-    if (!body)
-        throw new Error('Invalid DOCX: missing w:body');
-    const paragraphs = [];
-    let index = 0;
-    for (const child of nodeListToArray(body.childNodes)) {
-        if (child.nodeType !== 1)
-            continue;
-        if (child.nodeName !== 'w:p')
-            continue;
-        const text = getParagraphText(child).trim();
-        paragraphs.push({ index, text, hasText: text.length > 0 });
-        index++;
-    }
-    return paragraphs;
-}
-/** Get core properties from DOCX. */
-async function getCoreProperties(zip) {
-    const corePropsFile = zip.file('docProps/core.xml');
-    if (!corePropsFile)
-        return {};
-    const xmlStr = corePropsFile.asText();
-    const dom = new DOMParser().parseFromString(xmlStr, 'application/xml');
-    const getProperty = (name) => {
-        const elements = dom.getElementsByTagName(name);
-        if (elements.length > 0)
-            return elements[0].textContent || undefined;
-        return undefined;
-    };
-    return {
-        title: getProperty('dc:title'),
-        author: getProperty('dc:creator'),
-        subject: getProperty('dc:subject'),
-        creator: getProperty('cp:creator'),
-    };
-}
-/** Get comprehensive metadata. */
-export async function getDocxMetadata(path) {
-    const zip = await loadDocx(path);
-    const paragraphs = await extractParagraphs(path);
-    const coreProps = await getCoreProperties(zip);
-    const fullText = paragraphs.map((p) => p.text).join(' ');
-    const wordCount = fullText.split(/\s+/).filter((w) => w.length > 0).length;
-    return { ...coreProps, paragraphCount: paragraphs.length, wordCount };
-}
-/** Extract body XML. */
-export async function extractBodyXml(path) {
-    const inputBuf = await fs.readFile(path);
-    const zip = new PizZip(inputBuf);
-    const docFile = zip.file('word/document.xml');
-    if (!docFile)
-        throw new Error('Invalid DOCX: missing word/document.xml');
-    const xmlStr = docFile.asText();
-    const dom = new DOMParser().parseFromString(xmlStr, 'application/xml');
-    const body = dom.getElementsByTagName('w:body').item(0);
-    if (!body)
-        throw new Error('Invalid DOCX: missing w:body');
-    return new XMLSerializer().serializeToString(body);
-}
-/** Read DOCX file with optional pagination. */
-export async function readDocx(path, options) {
-    const zip = await loadDocx(path);
-    const docFile = zip.file('word/document.xml');
-    if (!docFile)
-        throw new Error('Invalid DOCX: missing word/document.xml');
-    const xmlStr = docFile.asText();
-    const dom = new DOMParser().parseFromString(xmlStr, 'application/xml');
-    const body = dom.getElementsByTagName('w:body').item(0);
-    if (!body)
-        throw new Error('Invalid DOCX: missing w:body');
-    const allParagraphs = [];
-    let index = 0;
-    for (const child of nodeListToArray(body.childNodes)) {
-        if (child.nodeType !== 1)
-            continue;
-        if (child.nodeName !== 'w:p')
-            continue;
-        const text = getParagraphText(child).trim();
-        allParagraphs.push({ index, text, hasText: text.length > 0 });
-        index++;
-    }
-    let paragraphs = allParagraphs;
-    if (options?.offset !== undefined || options?.length !== undefined) {
-        const offset = options.offset || 0;
-        const length = options.length !== undefined ? options.length : allParagraphs.length;
-        paragraphs = allParagraphs.slice(offset, offset + length);
-    }
-    const metadata = await getDocxMetadata(path);
-    const text = paragraphs.map((p) => p.text).join('\n\n');
-    const bodyXml = new XMLSerializer().serializeToString(body);
-    return { text, paragraphs, metadata, bodyXml };
-}

package/dist/tools/docx/relationships.d.ts

@@ -1,22 +0,0 @@
-/**
- * DOCX relationship management — Single Responsibility: manage relationships
- * in word/_rels/document.xml.rels and Content_Types.xml.
- *
- * Used for adding images, hyperlinks, and other external resources.
- */
-import PizZip from 'pizzip';
-/**
- * Add an image relationship to word/_rels/document.xml.rels and return the rId.
- *
- * @param zip The DOCX ZIP archive
- * @param mediaFileName The filename in word/media/ (e.g., "image1.png")
- * @returns The relationship ID (e.g., "rId1")
- */
-export declare function addImageRelationship(zip: PizZip, mediaFileName: string): string;
-/**
- * Ensure the Content_Types.xml has a Default entry for the given file extension.
- *
- * @param zip The DOCX ZIP archive
- * @param ext The file extension (e.g., ".png")
- */
-export declare function ensureContentType(zip: PizZip, ext: string): void;

package/dist/tools/docx/relationships.js

@@ -1,76 +0,0 @@
-/**
- * DOCX relationship management — Single Responsibility: manage relationships
- * in word/_rels/document.xml.rels and Content_Types.xml.
- *
- * Used for adding images, hyperlinks, and other external resources.
- */
-import { DOMParser, XMLSerializer } from '@xmldom/xmldom';
-import { nodeListToArray } from './dom.js';
-import { getMimeType } from './constants.js';
-import { DOCX_PATHS, NAMESPACES } from './constants.js';
-/**
- * Add an image relationship to word/_rels/document.xml.rels and return the rId.
- *
- * @param zip The DOCX ZIP archive
- * @param mediaFileName The filename in word/media/ (e.g., "image1.png")
- * @returns The relationship ID (e.g., "rId1")
- */
-export function addImageRelationship(zip, mediaFileName) {
-    const relsPath = DOCX_PATHS.DOCUMENT_RELS;
-    let relsEntry = zip.file(relsPath);
-    // Create .rels file if it doesn't exist
-    if (!relsEntry) {
-        const emptyRels = '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>' +
-            `<Relationships xmlns="${NAMESPACES.RELS}"></Relationships>`;
-        zip.file(relsPath, emptyRels);
-        relsEntry = zip.file(relsPath);
-    }
-    const relsXml = relsEntry.asText();
-    const relsDom = new DOMParser().parseFromString(relsXml, 'application/xml');
-    const relationships = relsDom.getElementsByTagName('Relationship');
-    // Find max existing rId
-    let maxId = 0;
-    for (const rel of nodeListToArray(relationships)) {
-        const id = rel.getAttribute('Id') || '';
-        const match = id.match(/^rId(\d+)$/);
-        if (match) {
-            maxId = Math.max(maxId, parseInt(match[1], 10));
-        }
-    }
-    const newRId = `rId${maxId + 1}`;
-    // Create new Relationship element
-    const newRel = relsDom.createElement('Relationship');
-    newRel.setAttribute('Id', newRId);
-    newRel.setAttribute('Type', `${NAMESPACES.R}/image`);
-    newRel.setAttribute('Target', `media/${mediaFileName}`);
-    relsDom.documentElement.appendChild(newRel);
-    // Write back
-    const newRelsXml = new XMLSerializer().serializeToString(relsDom);
-    zip.file(relsPath, newRelsXml);
-    return newRId;
-}
-/**
- * Ensure the Content_Types.xml has a Default entry for the given file extension.
- *
- * @param zip The DOCX ZIP archive
- * @param ext The file extension (e.g., ".png")
- */
-export function ensureContentType(zip, ext) {
-    const ctPath = DOCX_PATHS.CONTENT_TYPES;
-    const ctEntry = zip.file(ctPath);
-    if (!ctEntry)
-        return;
-    const ctXml = ctEntry.asText();
-    const extNoDot = ext.replace(/^\./, '');
-    // Check if already present
-    if (ctXml.includes(`Extension="${extNoDot}"`))
-        return;
-    const ctDom = new DOMParser().parseFromString(ctXml, 'application/xml');
-    const types = ctDom.documentElement;
-    const defaultEl = ctDom.createElement('Default');
-    defaultEl.setAttribute('Extension', extNoDot);
-    defaultEl.setAttribute('ContentType', getMimeType(ext));
-    types.appendChild(defaultEl);
-    const newCtXml = new XMLSerializer().serializeToString(ctDom);
-    zip.file(ctPath, newCtXml);
-}

package/dist/tools/docx/structure.d.ts

@@ -1,25 +0,0 @@
-/**
- * DOCX Structure Parser and Builder
- *
- * Provides structure-preserving parsing and building of DOCX files.
- * This approach maintains tables, images, and formatting at the DOCX element level,
- * avoiding lossy markdown round-trips.
- */
-import type { DocxStructure, DocxElement } from './types.js';
-export type { DocxElement, DocxStructure };
-/**
- * Parse a DOCX file into structured elements that can be manipulated and rebuilt
- *
- * @param buffer - DOCX file buffer
- * @returns Structured representation of the DOCX document
- * @throws {DocxError} If the DOCX file is invalid or cannot be parsed
- */
-export declare function parseDocxStructure(buffer: Buffer): Promise<DocxStructure>;
-/**
- * Build a DOCX file from structured elements
- *
- * @param structure - Structured DOCX representation
- * @returns Buffer containing the DOCX file
- * @throws {DocxError} If document building fails
- */
-export declare function buildDocxFromStructure(structure: DocxStructure): Promise<Buffer>;

package/dist/tools/docx/structure.js

@@ -1,102 +0,0 @@
-/**
- * DOCX Structure Parser and Builder
- *
- * Provides structure-preserving parsing and building of DOCX files.
- * This approach maintains tables, images, and formatting at the DOCX element level,
- * avoiding lossy markdown round-trips.
- */
-import { createRequire } from 'module';
-const require = createRequire(import.meta.url);
-// @ts-ignore
-import * as docx from 'docx';
-const { Document, Packer } = docx;
-import { DocxError, DocxErrorCode, withErrorContext } from './errors.js';
-import { createZipFromBuffer, readZipFileText, } from './parsers/zip-reader.js';
-import { parseXml, getElementChildren, extractRelationshipMap, getHeadingLevelFromParagraph, } from './parsers/xml-parser.js';
-import { extractImagesFromZip } from './parsers/image-extractor.js';
-import { parseParagraphElement } from './parsers/paragraph-parser.js';
-import { parseTableElement } from './parsers/table-parser.js';
-/**
- * Parse a DOCX file into structured elements that can be manipulated and rebuilt
- *
- * @param buffer - DOCX file buffer
- * @returns Structured representation of the DOCX document
- * @throws {DocxError} If the DOCX file is invalid or cannot be parsed
- */
-export async function parseDocxStructure(buffer) {
-    return withErrorContext(async () => {
-        const zip = createZipFromBuffer(buffer);
-        const documentXml = readZipFileText(zip, 'word/document.xml');
-        if (!documentXml) {
-            throw new DocxError('Invalid DOCX file: word/document.xml not found', DocxErrorCode.INVALID_DOCX, {});
-        }
-        const relsXml = readZipFileText(zip, 'word/_rels/document.xml.rels');
-        const relMap = extractRelationshipMap(relsXml);
-        // Extract all images
-        const images = extractImagesFromZip(zip, relMap);
-        // Parse document body
-        const doc = parseXml(documentXml);
-        const body = doc.getElementsByTagName('w:body')[0];
-        if (!body) {
-            throw new DocxError('Invalid DOCX file: <w:body> not found', DocxErrorCode.INVALID_DOCX_XML, {});
-        }
-        // Parse all elements
-        const elements = [];
-        const children = getElementChildren(body);
-        for (const child of children) {
-            const nodeName = child.nodeName;
-            if (nodeName === 'w:p') {
-                const headingLevel = getHeadingLevelFromParagraph(child);
-                const para = parseParagraphElement(child, images, headingLevel);
-                if (para) {
-                    if (headingLevel) {
-                        elements.push({
-                            type: 'heading',
-                            level: headingLevel,
-                            content: para,
-                        });
-                    }
-                    else {
-                        elements.push({
-                            type: 'paragraph',
-                            content: para,
-                        });
-                    }
-                }
-            }
-            else if (nodeName === 'w:tbl') {
-                const table = parseTableElement(child, images);
-                if (table) {
-                    elements.push({
-                        type: 'table',
-                        content: table,
-                    });
-                }
-            }
-        }
-        return {
-            elements,
-            images,
-            relationships: relMap,
-        };
-    }, DocxErrorCode.DOCX_READ_FAILED, { bufferSize: buffer.length });
-}
-/**
- * Build a DOCX file from structured elements
- *
- * @param structure - Structured DOCX representation
- * @returns Buffer containing the DOCX file
- * @throws {DocxError} If document building fails
- */
-export async function buildDocxFromStructure(structure) {
-    return withErrorContext(async () => {
-        const children = structure.elements.map(el => el.content);
-        const doc = new Document({
-            sections: [{
-                    properties: {},
-                    children: children,
-                }],
-        });
-        return await Packer.toBuffer(doc);
-    }, DocxErrorCode.DOCX_CREATE_FAILED, { elementCount: structure.elements.length });
-}

package/dist/tools/docx/styled-html-parser.d.ts

@@ -1,23 +0,0 @@
-/**
- * Direct DOCX XML → Styled HTML Parser
- *
- * Parses the raw DOCX XML and produces HTML with full inline style preservation
- * (font colours, sizes, families, text alignment, highlights, bold/italic/underline,
- * images, hyperlinks, tables, and lists).
- *
- * mammoth.js deliberately strips visual styling; this parser fills that gap.
- *
- * @module docx/styled-html-parser
- */
-import type { DocxImage, DocxDocumentDefaults } from './types.js';
-/**
- * Convert a DOCX buffer to styled HTML by parsing the DOCX XML directly.
- *
- * Bypasses mammoth.js to preserve all inline styles (colours, fonts, sizes,
- * alignment, highlights, bold/italic/underline, images, hyperlinks, tables).
- */
-export declare function convertDocxToStyledHtml(buffer: Buffer, includeImages?: boolean): Promise<{
-    html: string;
-    images: DocxImage[];
-    documentDefaults: DocxDocumentDefaults;
-}>;