@wonderwhy-er/desktop-commander 0.2.37 → 0.2.39

package/dist/tools/docx/builders/image.js

@@ -1,84 +0,0 @@
-/**
- * Image builder — creates w:drawing elements and manages image relationships.
- */
-import fs from 'fs/promises';
-import path from 'path';
-import { DOMParser } from '@xmldom/xmldom';
-import { addImageRelationship, ensureContentType } from '../relationships.js';
-import { escapeXmlAttr } from './utils.js';
-import { pixelsToEmu, DEFAULT_IMAGE_WIDTH, DEFAULT_IMAGE_HEIGHT, NAMESPACES } from '../constants.js';
-/**
- * Build an image element and add it to the ZIP archive.
- *
- * @param doc The XML document
- * @param zip The DOCX ZIP archive
- * @param spec The image specification (from content or operation)
- * @returns A w:p element containing the image drawing
- */
-export async function buildImageElement(doc, zip, spec) {
-    // Validate image exists
-    try {
-        await fs.access(spec.imagePath);
-    }
-    catch {
-        throw new Error(`Image file not found: ${spec.imagePath}`);
-    }
-    // Read image
-    const imgBuffer = await fs.readFile(spec.imagePath);
-    const ext = path.extname(spec.imagePath).toLowerCase();
-    const baseName = path.basename(spec.imagePath);
-    // Find next available media filename
-    let mediaIndex = 1;
-    while (zip.file(`word/media/image${mediaIndex}${ext}`)) {
-        mediaIndex++;
-    }
-    const mediaFileName = `image${mediaIndex}${ext}`;
-    // Add image to ZIP
-    zip.file(`word/media/${mediaFileName}`, imgBuffer);
-    // Add relationship
-    const rId = addImageRelationship(zip, mediaFileName);
-    // Ensure Content_Types entry
-    ensureContentType(zip, ext);
-    // Compute dimensions (EMU)
-    const widthPx = spec.width ?? DEFAULT_IMAGE_WIDTH;
-    const heightPx = spec.height ?? DEFAULT_IMAGE_HEIGHT;
-    const widthEmu = pixelsToEmu(widthPx);
-    const heightEmu = pixelsToEmu(heightPx);
-    // Build drawing XML
-    const altText = spec.altText ?? baseName;
-    const drawingXmlStr = buildDrawingXml(rId, widthEmu, heightEmu, altText, mediaFileName);
-    // Parse drawing XML into a paragraph
-    const drawingFragment = new DOMParser().parseFromString(`<w:p xmlns:w="${NAMESPACES.W}">` +
-        `<w:r>${drawingXmlStr}</w:r></w:p>`, 'application/xml');
-    return doc.importNode(drawingFragment.documentElement, true);
-}
-/**
- * Build the inline w:drawing XML for an image reference.
- */
-function buildDrawingXml(rId, widthEmu, heightEmu, altText, fileName) {
-    return (`<w:drawing xmlns:w="${NAMESPACES.W}">` +
-        `<wp:inline distT="0" distB="0" distL="0" distR="0" ` +
-        `xmlns:wp="${NAMESPACES.WP}">` +
-        `<wp:extent cx="${widthEmu}" cy="${heightEmu}"/>` +
-        `<wp:docPr id="1" name="${fileName}" descr="${escapeXmlAttr(altText)}"/>` +
-        `<a:graphic xmlns:a="${NAMESPACES.A}">` +
-        `<a:graphicData uri="http://schemas.openxmlformats.org/drawingml/2006/picture">` +
-        `<pic:pic xmlns:pic="${NAMESPACES.PIC}">` +
-        `<pic:nvPicPr>` +
-        `<pic:cNvPr id="0" name="${fileName}" descr="${escapeXmlAttr(altText)}"/>` +
-        `<pic:cNvPicPr/>` +
-        `</pic:nvPicPr>` +
-        `<pic:blipFill>` +
-        `<a:blip r:embed="${rId}" xmlns:r="${NAMESPACES.R}"/>` +
-        `<a:stretch><a:fillRect/></a:stretch>` +
-        `</pic:blipFill>` +
-        `<pic:spPr>` +
-        `<a:xfrm><a:off x="0" y="0"/><a:ext cx="${widthEmu}" cy="${heightEmu}"/></a:xfrm>` +
-        `<a:prstGeom prst="rect"><a:avLst/></a:prstGeom>` +
-        `</pic:spPr>` +
-        `</pic:pic>` +
-        `</a:graphicData>` +
-        `</a:graphic>` +
-        `</wp:inline>` +
-        `</w:drawing>`);
-}

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

@@ -1,11 +0,0 @@
-/**
- * DOCX element builders — Single Responsibility: build XML elements
- * for paragraphs, tables, and images.
- *
- * These builders are shared between create.ts and ops/ modules to
- * eliminate code duplication and ensure consistency.
- */
-export { buildParagraph } from './paragraph.js';
-export { buildTable } from './table.js';
-export { buildImageElement } from './image.js';
-export { escapeXml, escapeXmlAttr } from './utils.js';

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

@@ -1,11 +0,0 @@
-/**
- * DOCX element builders — Single Responsibility: build XML elements
- * for paragraphs, tables, and images.
- *
- * These builders are shared between create.ts and ops/ modules to
- * eliminate code duplication and ensure consistency.
- */
-export { buildParagraph } from './paragraph.js';
-export { buildTable } from './table.js';
-export { buildImageElement } from './image.js';
-export { escapeXml, escapeXmlAttr } from './utils.js';

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

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

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

@@ -1,260 +0,0 @@
-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/builders/paragraph.d.ts

@@ -1,12 +0,0 @@
-/**
- * Paragraph builder — creates w:p elements with optional styles.
- */
-import type { DocxContentParagraph } from '../types.js';
-/**
- * Build a paragraph element from content structure.
- *
- * @param doc The XML document
- * @param item The paragraph content item
- * @returns A w:p element
- */
-export declare function buildParagraph(doc: Document, item: DocxContentParagraph): Element;

package/dist/tools/docx/builders/paragraph.js

@@ -1,29 +0,0 @@
-/**
- * Paragraph builder — creates w:p elements with optional styles.
- */
-/**
- * Build a paragraph element from content structure.
- *
- * @param doc The XML document
- * @param item The paragraph content item
- * @returns A w:p element
- */
-export function buildParagraph(doc, item) {
-    const p = doc.createElement('w:p');
-    // Set style if provided
-    if (item.style) {
-        const pPr = doc.createElement('w:pPr');
-        const pStyle = doc.createElement('w:pStyle');
-        pStyle.setAttribute('w:val', item.style);
-        pPr.appendChild(pStyle);
-        p.appendChild(pPr);
-    }
-    // Add text run
-    const r = doc.createElement('w:r');
-    const t = doc.createElement('w:t');
-    t.setAttribute('xml:space', 'preserve');
-    t.textContent = item.text;
-    r.appendChild(t);
-    p.appendChild(r);
-    return p;
-}

package/dist/tools/docx/builders/table.d.ts

@@ -1,10 +0,0 @@
-/**
- * Table builder — creates w:tbl elements with headers, rows, and styling.
- * Supports multiple paragraphs per cell with different styles.
- */
-import type { DocxContentTable, InsertTableOp } from '../types.js';
-/**
- * Build a table element from content structure or operation.
- * Supports cells with multiple paragraphs, each with its own style.
- */
-export declare function buildTable(doc: Document, spec: DocxContentTable | InsertTableOp): Element;

package/dist/tools/docx/builders/table.js

@@ -1,138 +0,0 @@
-/**
- * Table builder — creates w:tbl elements with headers, rows, and styling.
- * Supports multiple paragraphs per cell with different styles.
- */
-import { buildParagraph } from './paragraph.js';
-/**
- * Build a table element from content structure or operation.
- * Supports cells with multiple paragraphs, each with its own style.
- */
-export function buildTable(doc, spec) {
-    const tbl = doc.createElement('w:tbl');
-    // Table properties
-    const tblPr = doc.createElement('w:tblPr');
-    if (spec.style) {
-        const tblStyle = doc.createElement('w:tblStyle');
-        tblStyle.setAttribute('w:val', spec.style);
-        tblPr.appendChild(tblStyle);
-    }
-    const tblW = doc.createElement('w:tblW');
-    tblW.setAttribute('w:w', '0');
-    tblW.setAttribute('w:type', 'auto');
-    tblPr.appendChild(tblW);
-    // Table borders
-    const tblBorders = doc.createElement('w:tblBorders');
-    for (const side of ['top', 'left', 'bottom', 'right', 'insideH', 'insideV']) {
-        const border = doc.createElement(`w:${side}`);
-        border.setAttribute('w:val', 'single');
-        border.setAttribute('w:sz', '4');
-        border.setAttribute('w:space', '0');
-        border.setAttribute('w:color', '000000');
-        tblBorders.appendChild(border);
-    }
-    tblPr.appendChild(tblBorders);
-    tbl.appendChild(tblPr);
-    // Determine column count
-    const colCount = spec.headers
-        ? spec.headers.length
-        : spec.rows.length > 0
-            ? spec.rows[0].length
-            : 0;
-    // Table grid
-    if (colCount > 0) {
-        const tblGrid = doc.createElement('w:tblGrid');
-        for (let c = 0; c < colCount; c++) {
-            const gridCol = doc.createElement('w:gridCol');
-            const w = spec.colWidths?.[c] ?? Math.floor(9000 / colCount);
-            gridCol.setAttribute('w:w', String(w));
-            tblGrid.appendChild(gridCol);
-        }
-        tbl.appendChild(tblGrid);
-    }
-    /**
-     * Build a cell from content.
-     * Content can be:
-     * - A string: creates one paragraph with that text
-     * - An array of DocxContentParagraph: creates multiple paragraphs, each with its own style
-     */
-    const buildCell = (content, isHeader, widthTwips) => {
-        const tc = doc.createElement('w:tc');
-        // Cell properties (width)
-        if (widthTwips) {
-            const tcPr = doc.createElement('w:tcPr');
-            const tcW = doc.createElement('w:tcW');
-            tcW.setAttribute('w:w', String(widthTwips));
-            tcW.setAttribute('w:type', 'dxa');
-            tcPr.appendChild(tcW);
-            tc.appendChild(tcPr);
-        }
-        // Handle content: string or array of paragraphs
-        if (typeof content === 'string') {
-            // Simple case: single paragraph
-            const p = doc.createElement('w:p');
-            const r = doc.createElement('w:r');
-            // Header cells get bold
-            if (isHeader) {
-                const rPr = doc.createElement('w:rPr');
-                const b = doc.createElement('w:b');
-                rPr.appendChild(b);
-                r.appendChild(rPr);
-            }
-            const t = doc.createElement('w:t');
-            t.setAttribute('xml:space', 'preserve');
-            t.textContent = content;
-            r.appendChild(t);
-            p.appendChild(r);
-            tc.appendChild(p);
-        }
-        else {
-            // Complex case: multiple paragraphs with different styles
-            for (const paraSpec of content) {
-                const p = buildParagraph(doc, paraSpec);
-                // If header and first paragraph, ensure bold on runs
-                if (isHeader) {
-                    const runs = p.getElementsByTagName('w:r');
-                    for (let i = 0; i < runs.length; i++) {
-                        const run = runs.item(i);
-                        let rPr = run.getElementsByTagName('w:rPr').item(0);
-                        if (!rPr) {
-                            rPr = doc.createElement('w:rPr');
-                            if (run.firstChild) {
-                                run.insertBefore(rPr, run.firstChild);
-                            }
-                            else {
-                                run.appendChild(rPr);
-                            }
-                        }
-                        // Add bold if not already present
-                        if (!rPr.getElementsByTagName('w:b').length) {
-                            const b = doc.createElement('w:b');
-                            rPr.appendChild(b);
-                        }
-                    }
-                }
-                tc.appendChild(p);
-            }
-        }
-        return tc;
-    };
-    // Header row
-    if (spec.headers && spec.headers.length > 0) {
-        const tr = doc.createElement('w:tr');
-        for (let i = 0; i < spec.headers.length; i++) {
-            const width = spec.colWidths?.[i];
-            tr.appendChild(buildCell(spec.headers[i], true, width));
-        }
-        tbl.appendChild(tr);
-    }
-    // Data rows
-    for (const row of spec.rows) {
-        const tr = doc.createElement('w:tr');
-        for (let i = 0; i < row.length; i++) {
-            const width = spec.colWidths?.[i];
-            tr.appendChild(buildCell(row[i], false, width));
-        }
-        tbl.appendChild(tr);
-    }
-    return tbl;
-}

package/dist/tools/docx/builders/utils.d.ts

@@ -1,5 +0,0 @@
-/**
- * XML escaping utilities.
- */
-export declare function escapeXml(s: string): string;
-export declare function escapeXmlAttr(s: string): string;

package/dist/tools/docx/builders/utils.js

@@ -1,18 +0,0 @@
-/**
- * XML escaping utilities.
- */
-export function escapeXml(s) {
-    return s
-        .replace(/&/g, '&')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;')
-        .replace(/'/g, '&apos;');
-}
-export function escapeXmlAttr(s) {
-    return s
-        .replace(/&/g, '&amp;')
-        .replace(/"/g, '&quot;')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;');
-}

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

@@ -1,32 +0,0 @@
-/**
- * DOCX constants — shared values used across the module.
- */
-export declare const IMAGE_MIME_TYPES: Record<string, string>;
-export declare function getMimeType(ext: string): string;
-/**
- * Convert pixels to EMU (English Metric Units).
- * 1 inch = 914400 EMU, 1 px ≈ 9525 EMU (at 96 DPI)
- */
-export declare const PX_TO_EMU = 9525;
-export declare function pixelsToEmu(px: number): number;
-export declare const NAMESPACES: {
-    readonly W: "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
-    readonly WP: "http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing";
-    readonly A: "http://schemas.openxmlformats.org/drawingml/2006/main";
-    readonly PIC: "http://schemas.openxmlformats.org/drawingml/2006/picture";
-    readonly R: "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
-    readonly RELS: "http://schemas.openxmlformats.org/package/2006/relationships";
-};
-export declare const DEFAULT_IMAGE_WIDTH = 300;
-export declare const DEFAULT_IMAGE_HEIGHT = 200;
-export declare const DOCX_PATHS: {
-    readonly CONTENT_TYPES: "[Content_Types].xml";
-    readonly DOCUMENT_XML: "word/document.xml";
-    readonly DOCUMENT_RELS: "word/_rels/document.xml.rels";
-    readonly ROOT_RELS: "_rels/.rels";
-    readonly STYLES_XML: "word/styles.xml";
-    readonly SETTINGS_XML: "word/settings.xml";
-    readonly WEB_SETTINGS_XML: "word/webSettings.xml";
-    readonly FONT_TABLE_XML: "word/fontTable.xml";
-    readonly MEDIA_FOLDER: "word/media";
-};