npm - @wonderwhy-er/desktop-commander - Versions diffs - 0.2.34 → 0.2.35 - Mend

@wonderwhy-er/desktop-commander 0.2.34 → 0.2.35

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (78) hide show

package/dist/tools/docx/builders/html-builder.d.ts +17 -0
package/dist/tools/docx/builders/html-builder.js +92 -0
package/dist/tools/docx/builders/index.d.ts +5 -0
package/dist/tools/docx/builders/index.js +5 -0
package/dist/tools/docx/builders/markdown-builder.d.ts +2 -0
package/dist/tools/docx/builders/markdown-builder.js +260 -0
package/dist/tools/docx/constants.d.ts +36 -0
package/dist/tools/docx/constants.js +57 -0
package/dist/tools/docx/converters/markdown-to-html.d.ts +17 -0
package/dist/tools/docx/converters/markdown-to-html.js +111 -0
package/dist/tools/docx/errors.d.ts +28 -0
package/dist/tools/docx/errors.js +48 -0
package/dist/tools/docx/extractors/images.d.ts +14 -0
package/dist/tools/docx/extractors/images.js +40 -0
package/dist/tools/docx/extractors/metadata.d.ts +14 -0
package/dist/tools/docx/extractors/metadata.js +64 -0
package/dist/tools/docx/extractors/sections.d.ts +14 -0
package/dist/tools/docx/extractors/sections.js +61 -0
package/dist/tools/docx/html.d.ts +17 -0
package/dist/tools/docx/html.js +111 -0
package/dist/tools/docx/index.d.ts +14 -0
package/dist/tools/docx/index.js +16 -0
package/dist/tools/docx/markdown.d.ts +84 -0
package/dist/tools/docx/markdown.js +507 -0
package/dist/tools/docx/operations/handlers/index.d.ts +39 -0
package/dist/tools/docx/operations/handlers/index.js +152 -0
package/dist/tools/docx/operations/html-manipulator.d.ts +24 -0
package/dist/tools/docx/operations/html-manipulator.js +352 -0
package/dist/tools/docx/operations/index.d.ts +14 -0
package/dist/tools/docx/operations/index.js +61 -0
package/dist/tools/docx/operations/operation-handlers.d.ts +3 -0
package/dist/tools/docx/operations/operation-handlers.js +67 -0
package/dist/tools/docx/operations/preprocessor.d.ts +14 -0
package/dist/tools/docx/operations/preprocessor.js +44 -0
package/dist/tools/docx/operations/xml-replacer.d.ts +9 -0
package/dist/tools/docx/operations/xml-replacer.js +35 -0
package/dist/tools/docx/operations.d.ts +13 -0
package/dist/tools/docx/operations.js +13 -0
package/dist/tools/docx/parsers/image-extractor.d.ts +18 -0
package/dist/tools/docx/parsers/image-extractor.js +61 -0
package/dist/tools/docx/parsers/index.d.ts +9 -0
package/dist/tools/docx/parsers/index.js +9 -0
package/dist/tools/docx/parsers/paragraph-parser.d.ts +2 -0
package/dist/tools/docx/parsers/paragraph-parser.js +88 -0
package/dist/tools/docx/parsers/table-parser.d.ts +9 -0
package/dist/tools/docx/parsers/table-parser.js +72 -0
package/dist/tools/docx/parsers/xml-parser.d.ts +25 -0
package/dist/tools/docx/parsers/xml-parser.js +71 -0
package/dist/tools/docx/parsers/zip-reader.d.ts +23 -0
package/dist/tools/docx/parsers/zip-reader.js +52 -0
package/dist/tools/docx/structure.d.ts +25 -0
package/dist/tools/docx/structure.js +102 -0
package/dist/tools/docx/styled-html-parser.d.ts +23 -0
package/dist/tools/docx/styled-html-parser.js +1262 -0
package/dist/tools/docx/types.d.ts +114 -0
package/dist/tools/docx/types.js +8 -0
package/dist/tools/docx/utils/escaping.d.ts +13 -0
package/dist/tools/docx/utils/escaping.js +26 -0
package/dist/tools/docx/utils/images.d.ts +9 -0
package/dist/tools/docx/utils/images.js +26 -0
package/dist/tools/docx/utils/index.d.ts +12 -0
package/dist/tools/docx/utils/index.js +17 -0
package/dist/tools/docx/utils/markdown.d.ts +13 -0
package/dist/tools/docx/utils/markdown.js +32 -0
package/dist/tools/docx/utils/paths.d.ts +15 -0
package/dist/tools/docx/utils/paths.js +27 -0
package/dist/tools/docx/utils/versioning.d.ts +25 -0
package/dist/tools/docx/utils/versioning.js +55 -0
package/dist/tools/docx/utils.d.ts +101 -0
package/dist/tools/docx/utils.js +299 -0
package/dist/tools/docx/validators.d.ts +13 -0
package/dist/tools/docx/validators.js +40 -0
package/dist/utils/capture.js +4 -4
package/dist/utils/files/docx.d.ts +41 -0
package/dist/utils/files/docx.js +245 -0
package/dist/version.d.ts +1 -1
package/dist/version.js +1 -1
package/package.json +1 -1

package/dist/tools/docx/builders/html-builder.d.ts ADDED Viewed

@@ -0,0 +1,17 @@
+/**
+ * HTML → DOCX Conversion (html-to-docx)
+ *
+ * Converts processed HTML content into a DOCX buffer, injecting the original
+ * document's default font and font size so unstyled text keeps its appearance.
+ *
+ * @module docx/builders/html-builder
+ */
+import type { DocxBuildOptions } from '../types.js';
+/**
+ * Create a DOCX Buffer from HTML content.
+ *
+ * @param html - HTML content to convert
+ * @param options - Build options (baseDir, documentDefaults, etc.)
+ * @returns DOCX file as a Buffer
+ */
+export declare function createDocxFromHtml(html: string, options?: DocxBuildOptions): Promise<Buffer>;

package/dist/tools/docx/builders/html-builder.js ADDED Viewed

@@ -0,0 +1,92 @@
+/**
+ * HTML → DOCX Conversion (html-to-docx)
+ *
+ * Converts processed HTML content into a DOCX buffer, injecting the original
+ * document's default font and font size so unstyled text keeps its appearance.
+ *
+ * @module docx/builders/html-builder
+ */
+import { createRequire } from 'module';
+import { DocxError, DocxErrorCode, withErrorContext } from '../errors.js';
+import { DEFAULT_BUILD_OPTIONS, HTML_WRAPPER_TEMPLATE } from '../constants.js';
+const require = createRequire(import.meta.url);
+const HTMLtoDOCX = require('html-to-docx');
+// ─── HTML Structure Helpers ──────────────────────────────────────────────────
+/** Build a `<style>` tag with the original document's default font/size as CSS `body` rules. */
+function buildDefaultStyleTag(defaults) {
+    if (!defaults)
+        return '';
+    const rules = [];
+    if (defaults.font)
+        rules.push(`font-family: '${defaults.font}'`);
+    if (defaults.fontSize)
+        rules.push(`font-size: ${defaults.fontSize}pt`);
+    if (rules.length === 0)
+        return '';
+    return `<style>body { ${rules.join('; ')}; }</style>`;
+}
+/**
+ * Ensure the HTML has a proper structure (DOCTYPE, `<html>`, `<head>`, `<body>`).
+ * Injects the document-default CSS into `<head>` when available.
+ */
+function ensureHtmlStructure(html, defaults) {
+    const trimmed = html.trim();
+    const styleTag = buildDefaultStyleTag(defaults);
+    if (!trimmed) {
+        const wrapped = HTML_WRAPPER_TEMPLATE.split('{content}').join('');
+        return styleTag ? wrapped.replace('</head>', `${styleTag}\n</head>`) : wrapped;
+    }
+    const lower = trimmed.toLowerCase();
+    const hasDoctype = lower.startsWith('<!doctype');
+    const hasHtml = lower.includes('<html');
+    const hasBody = lower.includes('<body');
+    // Already complete — inject styles only
+    if (hasDoctype && hasHtml && hasBody) {
+        if (styleTag && trimmed.includes('</head>')) {
+            return trimmed.replace('</head>', `${styleTag}\n</head>`);
+        }
+        return trimmed;
+    }
+    // Partial structure — add DOCTYPE, inject styles
+    if (hasHtml || hasBody) {
+        const result = `<!DOCTYPE html>\n${trimmed}`;
+        return styleTag && result.includes('</head>')
+            ? result.replace('</head>', `${styleTag}\n</head>`)
+            : result;
+    }
+    // Plain fragment — wrap fully
+    // Use split/join instead of replace to avoid $-pattern interpretation in base64 data URLs
+    const wrapped = HTML_WRAPPER_TEMPLATE.split('{content}').join(trimmed);
+    return styleTag ? wrapped.replace('</head>', `${styleTag}\n</head>`) : wrapped;
+}
+// ─── Public API ──────────────────────────────────────────────────────────────
+/**
+ * Create a DOCX Buffer from HTML content.
+ *
+ * @param html - HTML content to convert
+ * @param options - Build options (baseDir, documentDefaults, etc.)
+ * @returns DOCX file as a Buffer
+ */
+export async function createDocxFromHtml(html, options = {}) {
+    return withErrorContext(async () => {
+        if (!html?.trim()) {
+            throw new DocxError('HTML content cannot be empty', DocxErrorCode.DOCX_CREATE_FAILED, { htmlLength: 0 });
+        }
+        const defaults = options.documentDefaults;
+        const processedHtml = ensureHtmlStructure(html, defaults);
+        const docxOptions = {
+            table: { row: { cantSplit: true } },
+            footer: DEFAULT_BUILD_OPTIONS.footer,
+            pageNumber: DEFAULT_BUILD_OPTIONS.pageNumber,
+            font: defaults?.font || DEFAULT_BUILD_OPTIONS.font,
+            fontSize: defaults?.fontSize || DEFAULT_BUILD_OPTIONS.fontSize,
+            orientation: DEFAULT_BUILD_OPTIONS.orientation,
+            margins: { ...DEFAULT_BUILD_OPTIONS.margins },
+        };
+        const docxBuffer = await HTMLtoDOCX(processedHtml, null, docxOptions);
+        if (!docxBuffer || docxBuffer.length === 0) {
+            throw new DocxError('Failed to generate DOCX: empty buffer', DocxErrorCode.DOCX_CREATE_FAILED, { htmlLength: html.length });
+        }
+        return Buffer.from(docxBuffer);
+    }, DocxErrorCode.DOCX_CREATE_FAILED, { htmlLength: html.length });
+}

package/dist/tools/docx/builders/index.d.ts ADDED Viewed

@@ -0,0 +1,5 @@
+/**
+ * DOCX Builders
+ * Centralized exports for all building utilities
+ */
+export * from './markdown-builder.js';

package/dist/tools/docx/builders/index.js ADDED Viewed

@@ -0,0 +1,5 @@
+/**
+ * DOCX Builders
+ * Centralized exports for all building utilities
+ */
+export * from './markdown-builder.js';

package/dist/tools/docx/builders/markdown-builder.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ import type { DocxBuildOptions } from '../types.js';
2	+ export declare function createDocxFromMarkdown(markdown: string, options?: DocxBuildOptions): Promise<Buffer>;

package/dist/tools/docx/builders/markdown-builder.js ADDED Viewed

@@ -0,0 +1,260 @@
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+// @ts-ignore
+import * as docx from 'docx';
+const { AlignmentType, Document, HeadingLevel, Paragraph, Table, TableCell, TableRow, TextRun, WidthType, Packer, } = docx;
+import { DocxErrorCode, withErrorContext } from '../errors.js';
+import { normalizeLineEndings, prepareImageForDocx, createImageRun, } from '../utils.js';
+export async function createDocxFromMarkdown(markdown, options = {}) {
+    return withErrorContext(async () => {
+        const children = [];
+        const baseDir = options.baseDir;
+        const lines = normalizeLineEndings(markdown).split('\n');
+        let i = 0;
+        while (i < lines.length) {
+            const rawLine = lines[i];
+            const line = rawLine.trimEnd();
+            // Skip empty lines
+            if (!line.trim()) {
+                i++;
+                continue;
+            }
+            // 1) Markdown table detection
+            const isHeader = isTableHeaderLine(line);
+            const hasSeparator = i + 1 < lines.length && isTableSeparatorLine(lines[i + 1]);
+            if (isHeader && hasSeparator) {
+                const tableLines = [line];
+                i++;
+                tableLines.push(lines[i]); // Add separator line
+                i++;
+                // Collect all subsequent table rows
+                while (i < lines.length) {
+                    const nextLine = lines[i].trim();
+                    if (!nextLine || !isTableRowLine(nextLine)) {
+                        break;
+                    }
+                    tableLines.push(nextLine);
+                    i++;
+                }
+                try {
+                    const table = createTableFromMarkdown(tableLines);
+                    children.push(table);
+                }
+                catch (error) {
+                    console.error('[DOCX Build] Failed to create table:', error);
+                    // Fallback: add table lines as plain text
+                    for (const tableLine of tableLines) {
+                        children.push(new Paragraph({ text: tableLine }));
+                    }
+                }
+                continue;
+            }
+            // 2) Images
+            const imageMatch = line.match(/!\[([^\]]*)\]\(([^)]+)\)/);
+            if (imageMatch) {
+                const altText = imageMatch[1] || '';
+                const src = imageMatch[2];
+                try {
+                    const imageData = await prepareImageForDocx(src, altText, baseDir);
+                    const imageRun = createImageRun(imageData);
+                    const paragraph = new Paragraph({
+                        children: [imageRun],
+                        alignment: AlignmentType.CENTER,
+                    });
+                    children.push(paragraph);
+                }
+                catch (error) {
+                    console.warn(`Failed to embed image ${src}:`, error);
+                    children.push(new Paragraph({
+                        text: `[Image: ${altText || src}]`,
+                    }));
+                }
+                i++;
+                continue;
+            }
+            // 3) Headings
+            const headingMatch = line.match(/^(#{1,6})\s+(.+)$/);
+            if (headingMatch) {
+                const level = headingMatch[1].length;
+                const text = headingMatch[2].trim();
+                const textRuns = parseInlineFormatting(text);
+                const heading = new Paragraph({
+                    children: textRuns,
+                    heading: getHeadingLevel(level),
+                });
+                children.push(heading);
+                i++;
+                continue;
+            }
+            // 4) Regular paragraphs
+            const textRuns = parseInlineFormatting(rawLine);
+            const paragraph = new Paragraph({
+                children: textRuns,
+            });
+            children.push(paragraph);
+            i++;
+        }
+        const doc = new Document({
+            sections: [{
+                    properties: {},
+                    children: children,
+                }],
+        });
+        return await Packer.toBuffer(doc);
+    }, DocxErrorCode.DOCX_CREATE_FAILED, { markdownLength: markdown.length });
+}
+// ============================================================================
+// Helper Functions
+// ============================================================================
+function isTableHeaderLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed.includes('|'))
+        return false;
+    const startsWithPipe = trimmed.startsWith('|');
+    const endsWithPipe = trimmed.endsWith('|');
+    const pipeCount = (trimmed.match(/\|/g) || []).length;
+    if (startsWithPipe && endsWithPipe) {
+        return pipeCount >= 2;
+    }
+    return pipeCount >= 1;
+}
+function isTableSeparatorLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed.includes('|'))
+        return false;
+    let content = trimmed;
+    if (content.startsWith('|'))
+        content = content.substring(1);
+    if (content.endsWith('|'))
+        content = content.substring(0, content.length - 1);
+    const parts = content.split('|');
+    let validParts = 0;
+    for (const part of parts) {
+        const cleaned = part.trim();
+        if (cleaned.length === 0)
+            continue;
+        if (/^:?-+:?$/.test(cleaned)) {
+            validParts++;
+        }
+        else {
+            return false;
+        }
+    }
+    return validParts > 0;
+}
+function isTableRowLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed.includes('|'))
+        return false;
+    if (isTableSeparatorLine(trimmed))
+        return false;
+    const pipeCount = (trimmed.match(/\|/g) || []).length;
+    return pipeCount >= 1;
+}
+function splitTableRow(line) {
+    const trimmed = line.trim();
+    let withoutBorders = trimmed;
+    if (withoutBorders.startsWith('|')) {
+        withoutBorders = withoutBorders.substring(1);
+    }
+    if (withoutBorders.endsWith('|')) {
+        withoutBorders = withoutBorders.substring(0, withoutBorders.length - 1);
+    }
+    return withoutBorders.split('|').map(cell => cell.trim());
+}
+function createTableFromMarkdown(lines) {
+    if (lines.length < 2) {
+        return new Table({ rows: [] });
+    }
+    const headerCells = splitTableRow(lines[0]);
+    const rows = [];
+    // Header row
+    rows.push(new TableRow({
+        children: headerCells.map((cell) => {
+            const textRuns = parseInlineFormatting(cell.trim());
+            textRuns.forEach(run => {
+                run.bold = true;
+            });
+            return new TableCell({
+                children: [
+                    new Paragraph({
+                        children: textRuns,
+                        alignment: AlignmentType.CENTER,
+                    }),
+                ],
+            });
+        }),
+    }));
+    // Data rows (skip separator at index 1)
+    for (let i = 2; i < lines.length; i++) {
+        const cells = splitTableRow(lines[i]);
+        rows.push(new TableRow({
+            children: cells.map((cell) => {
+                const textRuns = parseInlineFormatting(cell.trim());
+                return new TableCell({
+                    children: [
+                        new Paragraph({
+                            children: textRuns,
+                        }),
+                    ],
+                });
+            }),
+        }));
+    }
+    return new Table({
+        width: { size: 100, type: WidthType.PERCENTAGE },
+        rows,
+    });
+}
+function parseInlineFormatting(text) {
+    const runs = [];
+    let currentText = '';
+    let i = 0;
+    while (i < text.length) {
+        // Check for **bold**
+        if (text.substring(i, i + 2) === '**') {
+            if (currentText) {
+                runs.push(new TextRun({ text: currentText }));
+                currentText = '';
+            }
+            const closeIndex = text.indexOf('**', i + 2);
+            if (closeIndex !== -1) {
+                const boldText = text.substring(i + 2, closeIndex);
+                runs.push(new TextRun({ text: boldText, bold: true }));
+                i = closeIndex + 2;
+                continue;
+            }
+        }
+        // Check for *italic*
+        if (text[i] === '*' && text[i + 1] !== '*') {
+            if (currentText) {
+                runs.push(new TextRun({ text: currentText }));
+                currentText = '';
+            }
+            const closeIndex = text.indexOf('*', i + 1);
+            if (closeIndex !== -1) {
+                const italicText = text.substring(i + 1, closeIndex);
+                runs.push(new TextRun({ text: italicText, italics: true }));
+                i = closeIndex + 1;
+                continue;
+            }
+        }
+        currentText += text[i];
+        i++;
+    }
+    if (currentText) {
+        runs.push(new TextRun({ text: currentText }));
+    }
+    return runs.length > 0 ? runs : [new TextRun({ text: text })];
+}
+function getHeadingLevel(level) {
+    const levelMap = {
+        1: HeadingLevel.HEADING_1,
+        2: HeadingLevel.HEADING_2,
+        3: HeadingLevel.HEADING_3,
+        4: HeadingLevel.HEADING_4,
+        5: HeadingLevel.HEADING_5,
+        6: HeadingLevel.HEADING_6,
+    };
+    return levelMap[level] ?? HeadingLevel.HEADING_1;
+}

package/dist/tools/docx/constants.d.ts ADDED Viewed

@@ -0,0 +1,36 @@
+/**
+ * DOCX Constants
+ *
+ * Centralised constants shared across the DOCX module.
+ *
+ * @module docx/constants
+ */
+export declare const DEFAULT_CONVERSION_OPTIONS: {
+    readonly includeImages: true;
+    readonly preserveFormatting: true;
+    readonly styleMap: readonly string[];
+};
+export declare const DEFAULT_BUILD_OPTIONS: {
+    readonly font: "Calibri";
+    readonly fontSize: 11;
+    readonly orientation: "portrait";
+    readonly margins: {
+        readonly top: 1440;
+        readonly right: 1440;
+        readonly bottom: 1440;
+        readonly left: 1440;
+        readonly header: 720;
+        readonly footer: 720;
+        readonly gutter: 0;
+    };
+    readonly footer: true;
+    readonly pageNumber: false;
+};
+export declare const DOCX_NAMESPACES: {
+    readonly DUBLIN_CORE: "dc";
+    readonly CUSTOM_PROPERTIES: "cp";
+    readonly DCTERMS: "dcterms";
+};
+export declare const CORE_PROPERTIES_PATH = "docProps/core.xml";
+export declare const IMAGE_MIME_TYPES: Readonly<Record<string, string>>;
+export declare const HTML_WRAPPER_TEMPLATE = "<!DOCTYPE html>\n<html>\n<head>\n  <meta charset=\"UTF-8\">\n</head>\n<body>\n{content}\n</body>\n</html>";

package/dist/tools/docx/constants.js ADDED Viewed

@@ -0,0 +1,57 @@
+/**
+ * DOCX Constants
+ *
+ * Centralised constants shared across the DOCX module.
+ *
+ * @module docx/constants
+ */
+// ─── Conversion Defaults ─────────────────────────────────────────────────────
+export const DEFAULT_CONVERSION_OPTIONS = {
+    includeImages: true,
+    preserveFormatting: true,
+    styleMap: [],
+};
+// ─── Build (html-to-docx) Defaults ──────────────────────────────────────────
+export const DEFAULT_BUILD_OPTIONS = {
+    font: 'Calibri',
+    fontSize: 11,
+    orientation: 'portrait',
+    margins: {
+        top: 1440,
+        right: 1440,
+        bottom: 1440,
+        left: 1440,
+        header: 720,
+        footer: 720,
+        gutter: 0,
+    },
+    footer: true,
+    pageNumber: false,
+};
+// ─── DOCX Internal XML Namespaces ────────────────────────────────────────────
+export const DOCX_NAMESPACES = {
+    DUBLIN_CORE: 'dc',
+    CUSTOM_PROPERTIES: 'cp',
+    DCTERMS: 'dcterms',
+};
+// ─── DOCX Archive Paths ─────────────────────────────────────────────────────
+export const CORE_PROPERTIES_PATH = 'docProps/core.xml';
+// ─── Image MIME Types (extension → MIME) ─────────────────────────────────────
+export const IMAGE_MIME_TYPES = {
+    jpg: 'image/jpeg',
+    jpeg: 'image/jpeg',
+    gif: 'image/gif',
+    bmp: 'image/bmp',
+    webp: 'image/webp',
+    png: 'image/png',
+};
+// ─── HTML Wrapper Template ───────────────────────────────────────────────────
+export const HTML_WRAPPER_TEMPLATE = `<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="UTF-8">
+</head>
+<body>
+{content}
+</body>
+</html>`;

package/dist/tools/docx/converters/markdown-to-html.d.ts ADDED Viewed

@@ -0,0 +1,17 @@
+/**
+ * Markdown → HTML Converter
+ *
+ * Provides markdown-to-HTML conversion for DOCX content operations
+ * (appendMarkdown, insertTable with markdown input, etc.).
+ *
+ * @module docx/converters/markdown-to-html
+ */
+/** Convert basic markdown text to HTML. */
+export declare function markdownToHtml(markdown: string): string;
+/**
+ * Convert a markdown table to an HTML `<table>` with inline CSS borders.
+ * html-to-docx needs explicit border styles — without them, tables are invisible in Word.
+ */
+export declare function markdownTableToHtml(markdown: string): string;
+/** Build a markdown table string from a 2-D rows array (first row = header). */
+export declare function buildMarkdownTableFromRows(rows: string[][]): string;

package/dist/tools/docx/converters/markdown-to-html.js ADDED Viewed

@@ -0,0 +1,111 @@
+/**
+ * Markdown → HTML Converter
+ *
+ * Provides markdown-to-HTML conversion for DOCX content operations
+ * (appendMarkdown, insertTable with markdown input, etc.).
+ *
+ * @module docx/converters/markdown-to-html
+ */
+import { escapeHtml } from '../utils/escaping.js';
+// ─── Markdown → HTML ─────────────────────────────────────────────────────────
+/** Convert basic markdown text to HTML. */
+export function markdownToHtml(markdown) {
+    if (!markdown?.trim())
+        return '';
+    let html = markdown.trim();
+    // Headings (h6 → h1 to avoid partial matches)
+    html = html.replace(/^######\s+(.+)$/gm, '<h6>$1</h6>');
+    html = html.replace(/^#####\s+(.+)$/gm, '<h5>$1</h5>');
+    html = html.replace(/^####\s+(.+)$/gm, '<h4>$1</h4>');
+    html = html.replace(/^###\s+(.+)$/gm, '<h3>$1</h3>');
+    html = html.replace(/^##\s+(.+)$/gm, '<h2>$1</h2>');
+    html = html.replace(/^#\s+(.+)$/gm, '<h1>$1</h1>');
+    // Bold (before italic to avoid conflicts)
+    html = html.replace(/\*\*(.+?)\*\*/g, '<strong>$1</strong>');
+    html = html.replace(/__(.+?)__/g, '<strong>$1</strong>');
+    // Italic
+    html = html.replace(/\*(.+?)\*/g, '<em>$1</em>');
+    html = html.replace(/_(.+?)_/g, '<em>$1</em>');
+    // Images & links
+    html = html.replace(/!\[([^\]]*)\]\(([^)]+)\)/g, '<img src="$2" alt="$1" />');
+    html = html.replace(/\[([^\]]+)\]\(([^)]+)\)/g, '<a href="$2">$1</a>');
+    // Inline code
+    html = html.replace(/`([^`]+)`/g, '<code>$1</code>');
+    // Paragraphs (double-newline separated)
+    return html
+        .split(/\n\n+/)
+        .map((p) => p.trim())
+        .filter(Boolean)
+        .map((p) => {
+        // Don't wrap blocks that are already complete HTML elements
+        if (p.startsWith('<') && p.endsWith('>'))
+            return p.replace(/\n/g, '<br>');
+        return `<p>${p.replace(/\n/g, '<br>')}</p>`;
+    })
+        .join('\n');
+}
+// ─── Markdown Table → HTML ───────────────────────────────────────────────────
+/** Parse a single markdown table row into cell values. */
+function parseTableRow(row) {
+    return row.replace(/^\|/, '').replace(/\|$/, '').split('|').map((c) => c.trim());
+}
+/**
+ * Convert a markdown table to an HTML `<table>` with inline CSS borders.
+ * html-to-docx needs explicit border styles — without them, tables are invisible in Word.
+ */
+export function markdownTableToHtml(markdown) {
+    if (!markdown?.trim())
+        return '';
+    const lines = markdown
+        .trim()
+        .split('\n')
+        .map((l) => l.trim())
+        .filter(Boolean);
+    if (lines.length < 2)
+        return '';
+    const headerCells = parseTableRow(lines[0]);
+    if (headerCells.length === 0)
+        return '';
+    const dataRows = lines.slice(2).map(parseTableRow);
+    const BORDER = 'border:1px solid #000;';
+    const CELL = `${BORDER} padding:6px 10px;`;
+    const HEADER = `${CELL} background-color:#f2f2f2; font-weight:bold;`;
+    let html = `<table style="border-collapse:collapse; width:100%; ${BORDER}">\n`;
+    html += '  <thead>\n    <tr>\n';
+    for (const cell of headerCells) {
+        html += `      <th style="${HEADER}">${escapeHtml(cell)}</th>\n`;
+    }
+    html += '    </tr>\n  </thead>\n';
+    if (dataRows.length > 0) {
+        html += '  <tbody>\n';
+        for (const row of dataRows) {
+            html += '    <tr>\n';
+            for (const cell of row) {
+                html += `      <td style="${CELL}">${escapeHtml(cell)}</td>\n`;
+            }
+            html += '    </tr>\n';
+        }
+        html += '  </tbody>\n';
+    }
+    return html + '</table>';
+}
+// ─── Rows Array → Markdown Table ─────────────────────────────────────────────
+/** Build a markdown table string from a 2-D rows array (first row = header). */
+export function buildMarkdownTableFromRows(rows) {
+    if (!rows?.length)
+        return '';
+    const header = rows[0];
+    if (!header?.length)
+        return '';
+    const lines = [
+        `| ${header.join(' | ')} |`,
+        `| ${header.map(() => '---').join(' | ')} |`,
+    ];
+    for (const row of rows.slice(1)) {
+        const padded = [...row];
+        while (padded.length < header.length)
+            padded.push('');
+        lines.push(`| ${padded.slice(0, header.length).join(' | ')} |`);
+    }
+    return lines.join('\n');
+}

package/dist/tools/docx/errors.d.ts ADDED Viewed

@@ -0,0 +1,28 @@
+/**
+ * DOCX Error Handling
+ *
+ * Centralised error class and async error-wrapping utility.
+ *
+ * @module docx/errors
+ */
+export declare class DocxError extends Error {
+    readonly code: string;
+    readonly context?: Record<string, unknown> | undefined;
+    constructor(message: string, code: string, context?: Record<string, unknown> | undefined);
+    toJSON(): Record<string, unknown>;
+}
+export declare enum DocxErrorCode {
+    INVALID_DOCX = "INVALID_DOCX",
+    INVALID_PATH = "INVALID_PATH",
+    OPERATION_FAILED = "OPERATION_FAILED",
+    UNKNOWN_OPERATION = "UNKNOWN_OPERATION",
+    UNSUPPORTED_OPERATION = "UNSUPPORTED_OPERATION",
+    DOCX_CREATE_FAILED = "DOCX_CREATE_FAILED",
+    DOCX_EDIT_FAILED = "DOCX_EDIT_FAILED",
+    DOCX_READ_FAILED = "DOCX_READ_FAILED",
+    INVALID_IMAGE_FILE = "INVALID_IMAGE_FILE",
+    INVALID_IMAGE_DATA_URL = "INVALID_IMAGE_DATA_URL",
+    GET_INFO_FAILED = "GET_INFO_FAILED"
+}
+/** Wrap an async operation — re-throws existing DocxErrors, wraps everything else. */
+export declare function withErrorContext<T>(operation: () => Promise<T>, errorCode: DocxErrorCode | string, context?: Record<string, unknown>): Promise<T>;