@wonderwhy-er/desktop-commander 0.2.37 → 0.2.39

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

@@ -1,213 +0,0 @@
-/**
- * Type definitions for DOCX operations.
- * Single source of truth for every type used across the DOCX module.
- */
-export interface DocxMetadata {
-    title?: string;
-    author?: string;
-    subject?: string;
-    creator?: string;
-    paragraphCount: number;
-    wordCount: number;
-}
-export interface DocxParagraph {
-    index: number;
-    text: string;
-    hasText: boolean;
-}
-export interface DocxRun {
-    text: string;
-    bold?: boolean;
-    italic?: boolean;
-    color?: string;
-    fontSize?: number;
-    fontName?: string;
-}
-export interface DocxModification {
-    type: 'replace' | 'insert' | 'delete' | 'style';
-    paragraphIndex?: number;
-    findText?: string;
-    replaceText?: string;
-    insertText?: string;
-    style?: {
-        color?: string;
-        bold?: boolean;
-        italic?: boolean;
-    };
-}
-export interface ParagraphOutline {
-    bodyChildIndex: number;
-    paragraphIndex: number;
-    style: string | null;
-    text: string;
-}
-export interface TableOutline {
-    bodyChildIndex: number;
-    tableIndex: number;
-    style: string | null;
-    headers?: string[];
-    rows: string[][];
-}
-export interface ImageOutline {
-    bodyChildIndex: number;
-    imageIndex: number;
-    mediaPath: string;
-    rId: string;
-    altText?: string;
-}
-export interface ReadDocxResult {
-    path: string;
-    paragraphs: ParagraphOutline[];
-    tables: TableOutline[];
-    images: ImageOutline[];
-    stylesSeen: string[];
-    counts: {
-        tables: number;
-        images: number;
-        bodyChildren: number;
-    };
-}
-export interface WriteDocxStats {
-    tablesBefore: number;
-    tablesAfter: number;
-    bodyChildrenBefore: number;
-    bodyChildrenAfter: number;
-    bodySignatureBefore: string;
-    bodySignatureAfter: string;
-}
-export interface WriteDocxResult {
-    outputPath: string;
-    results: OpResult[];
-    stats: WriteDocxStats;
-    warnings: string[];
-}
-export interface BodySnapshot {
-    bodyChildCount: number;
-    tableCount: number;
-    signature: string;
-}
-export interface ReplaceParagraphTextExactOp {
-    type: 'replace_paragraph_text_exact';
-    from: string;
-    to: string;
-}
-export interface ReplaceParagraphAtBodyIndexOp {
-    type: 'replace_paragraph_at_body_index';
-    bodyChildIndex: number;
-    to: string;
-}
-export interface SetColorForStyleOp {
-    type: 'set_color_for_style';
-    style: string;
-    color: string;
-}
-export interface SetColorForParagraphExactOp {
-    type: 'set_color_for_paragraph_exact';
-    text: string;
-    color: string;
-}
-export interface SetParagraphStyleAtBodyIndexOp {
-    type: 'set_paragraph_style_at_body_index';
-    bodyChildIndex: number;
-    style: string;
-}
-export interface InsertParagraphAfterTextOp {
-    type: 'insert_paragraph_after_text';
-    after: string;
-    text: string;
-    style?: string;
-}
-export interface DeleteParagraphAtBodyIndexOp {
-    type: 'delete_paragraph_at_body_index';
-    bodyChildIndex: number;
-}
-export interface TableSetCellTextOp {
-    type: 'table_set_cell_text';
-    tableIndex: number;
-    row: number;
-    col: number;
-    text: string;
-}
-export interface ReplaceTableCellTextOp {
-    type: 'replace_table_cell_text';
-    from: string;
-    to: string;
-}
-export interface ReplaceHyperlinkUrlOp {
-    type: 'replace_hyperlink_url';
-    oldUrl: string;
-    newUrl: string;
-}
-export interface HeaderReplaceTextExactOp {
-    type: 'header_replace_text_exact';
-    from: string;
-    to: string;
-}
-export interface InsertTableOp {
-    type: 'insert_table';
-    /** Exact trimmed text of the paragraph to insert AFTER. Mutually exclusive with `before`. */
-    after?: string;
-    /** Exact trimmed text of the paragraph to insert BEFORE. Mutually exclusive with `after`. */
-    before?: string;
-    /** Optional header row (bold cells) */
-    headers?: string[];
-    /** Data rows — each row is an array of cell strings */
-    rows: string[][];
-    /** Optional column widths in twips (1/20 pt). Defaults to auto. */
-    colWidths?: number[];
-    /** Optional table style id (e.g. 'TableGrid') */
-    style?: string;
-}
-export interface InsertImageOp {
-    type: 'insert_image';
-    /** Exact trimmed text of the paragraph to insert AFTER. Mutually exclusive with `before`. */
-    after?: string;
-    /** Exact trimmed text of the paragraph to insert BEFORE. Mutually exclusive with `after`. */
-    before?: string;
-    /** Absolute or relative path to the image file */
-    imagePath: string;
-    /** Image width in pixels (default 300) */
-    width?: number;
-    /** Image height in pixels (default 200) */
-    height?: number;
-    /** Alt text for accessibility */
-    altText?: string;
-}
-export type DocxOp = ReplaceParagraphTextExactOp | ReplaceParagraphAtBodyIndexOp | SetColorForStyleOp | SetColorForParagraphExactOp | SetParagraphStyleAtBodyIndexOp | InsertParagraphAfterTextOp | DeleteParagraphAtBodyIndexOp | TableSetCellTextOp | ReplaceTableCellTextOp | ReplaceHyperlinkUrlOp | HeaderReplaceTextExactOp | InsertTableOp | InsertImageOp;
-export interface OpResult {
-    op: DocxOp;
-    status: 'applied' | 'skipped';
-    matched: number;
-    reason?: string;
-}
-export interface DocxContentParagraph {
-    type: 'paragraph';
-    text: string;
-    style?: string | null;
-}
-/**
- * Cell content can be:
- * - A string (simple case, creates one paragraph)
- * - An array of paragraphs (allows multiple paragraphs with different styles per cell)
- */
-export type DocxTableCellContent = string | DocxContentParagraph[];
-export interface DocxContentTable {
-    type: 'table';
-    /** Header cells - can be strings or arrays of paragraphs */
-    headers?: DocxTableCellContent[];
-    /** Data rows - each cell can be a string or array of paragraphs */
-    rows: DocxTableCellContent[][];
-    colWidths?: number[];
-    style?: string;
-}
-export interface DocxContentImage {
-    type: 'image';
-    imagePath: string;
-    width?: number;
-    height?: number;
-    altText?: string;
-}
-export type DocxContentItem = DocxContentParagraph | DocxContentTable | DocxContentImage;
-export interface DocxContentStructure {
-    items: DocxContentItem[];
-}

package/dist/tools/docx/types.js

@@ -1,5 +0,0 @@
-/**
- * Type definitions for DOCX operations.
- * Single source of truth for every type used across the DOCX module.
- */
-export {};

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

@@ -1,13 +0,0 @@
-/**
- * HTML Escaping Utilities
- *
- * Pure functions for escaping HTML special characters and regex patterns.
- *
- * @module docx/utils/escaping
- */
-/** Escape HTML special characters in text content. */
-export declare function escapeHtml(text: string): string;
-/** Escape a value for safe use inside an HTML attribute (double- and single-quoted). */
-export declare function escapeHtmlAttribute(value: string): string;
-/** Escape special regex characters for literal string matching. */
-export declare function escapeRegExp(str: string): string;

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

@@ -1,26 +0,0 @@
-/**
- * HTML Escaping Utilities
- *
- * Pure functions for escaping HTML special characters and regex patterns.
- *
- * @module docx/utils/escaping
- */
-const HTML_ESCAPE_MAP = {
-    '&': '&',
-    '<': '&lt;',
-    '>': '&gt;',
-    '"': '&quot;',
-    "'": '&#039;',
-};
-/** Escape HTML special characters in text content. */
-export function escapeHtml(text) {
-    return text.replace(/[&<>"']/g, (ch) => HTML_ESCAPE_MAP[ch] || ch);
-}
-/** Escape a value for safe use inside an HTML attribute (double- and single-quoted). */
-export function escapeHtmlAttribute(value) {
-    return value.replace(/"/g, '&quot;').replace(/'/g, '&#039;');
-}
-/** Escape special regex characters for literal string matching. */
-export function escapeRegExp(str) {
-    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}

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

@@ -1,9 +0,0 @@
-/**
- * Image Utilities
- *
- * Pure functions for MIME type detection and image path handling.
- *
- * @module docx/utils/images
- */
-/** Derive MIME type from a file extension or data URL. Returns `null` if unrecognised. */
-export declare function getMimeType(source: string): string | null;

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

@@ -1,26 +0,0 @@
-/**
- * Image Utilities
- *
- * Pure functions for MIME type detection and image path handling.
- *
- * @module docx/utils/images
- */
-import path from 'path';
-import { isDataUrl } from './paths.js';
-/** Derive MIME type from a file extension or data URL. Returns `null` if unrecognised. */
-export function getMimeType(source) {
-    if (isDataUrl(source)) {
-        const match = source.match(/^data:([^;]+);/);
-        return match ? match[1] : null;
-    }
-    const MIME_BY_EXT = {
-        '.png': 'image/png',
-        '.jpg': 'image/jpeg',
-        '.jpeg': 'image/jpeg',
-        '.gif': 'image/gif',
-        '.bmp': 'image/bmp',
-        '.webp': 'image/webp',
-        '.svg': 'image/svg+xml',
-    };
-    return MIME_BY_EXT[path.extname(source).toLowerCase()] || null;
-}

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

@@ -1,12 +0,0 @@
-/**
- * DOCX Utilities — Re-exports
- *
- * Centralized re-exports for all utility modules.
- *
- * @module docx/utils
- */
-export { escapeHtml, escapeHtmlAttribute, escapeRegExp } from './escaping.js';
-export { isDataUrl, isUrl, isDocxPath, resolveImagePath } from './paths.js';
-export { getMimeType } from './images.js';
-export { convertToHtmlIfNeeded } from './markdown.js';
-export { generateOutputPath } from './versioning.js';

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

@@ -1,17 +0,0 @@
-/**
- * DOCX Utilities — Re-exports
- *
- * Centralized re-exports for all utility modules.
- *
- * @module docx/utils
- */
-// Escaping
-export { escapeHtml, escapeHtmlAttribute, escapeRegExp } from './escaping.js';
-// Paths & URLs
-export { isDataUrl, isUrl, isDocxPath, resolveImagePath } from './paths.js';
-// Images
-export { getMimeType } from './images.js';
-// Markdown
-export { convertToHtmlIfNeeded } from './markdown.js';
-// Versioning
-export { generateOutputPath } from './versioning.js';

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

@@ -1,13 +0,0 @@
-/**
- * Markdown Conversion Utilities
- *
- * Lightweight markdown-to-HTML conversion for backward compatibility.
- * Used by filesystem.ts and DOCX file-handler.
- *
- * @module docx/utils/markdown
- */
-/**
- * Convert simple markdown to HTML if the content appears to be markdown.
- * If it already contains HTML tags it is returned unchanged.
- */
-export declare function convertToHtmlIfNeeded(content: string): string;

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

@@ -1,32 +0,0 @@
-/**
- * Markdown Conversion Utilities
- *
- * Lightweight markdown-to-HTML conversion for backward compatibility.
- * Used by filesystem.ts and DOCX file-handler.
- *
- * @module docx/utils/markdown
- */
-/**
- * Convert simple markdown to HTML if the content appears to be markdown.
- * If it already contains HTML tags it is returned unchanged.
- */
-export function convertToHtmlIfNeeded(content) {
-    const hasMarkdown = /^#{1,6}\s|^\*\*|^\[.*\]\(|^\|.*\|/.test(content);
-    const hasHtmlTags = /<[a-z][\s\S]*>/i.test(content);
-    if (!hasMarkdown || hasHtmlTags)
-        return content;
-    let html = content;
-    html = html.replace(/^### (.*)$/gm, '<h3>$1</h3>');
-    html = html.replace(/^## (.*)$/gm, '<h2>$1</h2>');
-    html = html.replace(/^# (.*)$/gm, '<h1>$1</h1>');
-    html = html.replace(/\*\*(.*?)\*\*/g, '<strong>$1</strong>');
-    html = html.replace(/\*(.*?)\*/g, '<em>$1</em>');
-    html = html.replace(/!\[([^\]]*)\]\(([^)]+)\)/g, '<img src="$2" alt="$1" />');
-    html = html.replace(/\[([^\]]+)\]\(([^)]+)\)/g, '<a href="$2">$1</a>');
-    return html
-        .split('\n\n')
-        .map((p) => p.trim())
-        .filter(Boolean)
-        .map((p) => `<p>${p.replace(/\n/g, '<br>')}</p>`)
-        .join('\n');
-}

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

@@ -1,15 +0,0 @@
-/**
- * Path and URL Utilities
- *
- * Pure functions for path detection, resolution, and URL validation.
- *
- * @module docx/utils/paths
- */
-/** Check if a string is a base64 data URL. */
-export declare function isDataUrl(src: string): boolean;
-/** Check if a string is an HTTP(S) URL. */
-export declare function isUrl(src: string): boolean;
-/** Check if a file path has a `.docx` extension. */
-export declare function isDocxPath(filePath: string): boolean;
-/** Resolve an image path relative to a base directory (pass-through for absolute, URL, and data URLs). */
-export declare function resolveImagePath(imagePath: string, baseDir?: string): string;

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

@@ -1,27 +0,0 @@
-/**
- * Path and URL Utilities
- *
- * Pure functions for path detection, resolution, and URL validation.
- *
- * @module docx/utils/paths
- */
-import path from 'path';
-/** Check if a string is a base64 data URL. */
-export function isDataUrl(src) {
-    return src.startsWith('data:') && src.includes('base64,');
-}
-/** Check if a string is an HTTP(S) URL. */
-export function isUrl(src) {
-    return src.startsWith('http://') || src.startsWith('https://');
-}
-/** Check if a file path has a `.docx` extension. */
-export function isDocxPath(filePath) {
-    return filePath.toLowerCase().endsWith('.docx');
-}
-/** Resolve an image path relative to a base directory (pass-through for absolute, URL, and data URLs). */
-export function resolveImagePath(imagePath, baseDir) {
-    if (path.isAbsolute(imagePath) || isUrl(imagePath) || isDataUrl(imagePath)) {
-        return imagePath;
-    }
-    return baseDir ? path.join(baseDir, imagePath) : path.resolve(imagePath);
-}

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

@@ -1,25 +0,0 @@
-/**
- * Versioning Utilities
- *
- * Generates versioned output paths for DOCX modifications.
- *
- * @module docx/utils/versioning
- */
-/**
- * Generate the versioned output path for a DOCX modification.
- *
- * Strategy:
- * - Look at existing sibling files `{base}_vN.ext` and pick the next N.
- * - If no versions exist yet, start at `_v1`.
- * - If some versions exist, always return the highest existing + 1.
- *
- * This gives you `version_i` per update over time **even if** every request
- * always uses the original file as `filePath`, while still producing only
- * ONE output file per request (callers invoke this once per edit).
- *
- * Examples:
- *   demo.docx     → demo_v1.docx  (always _v1, overwrites if exists)
- *   demo_v1.docx  → demo_v2.docx  (increments to _v2, overwrites if exists)
- *   demo_v2.docx  → demo_v3.docx  (increments to _v3, overwrites if exists)
- */
-export declare function generateOutputPath(filePath: string): Promise<string>;

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

@@ -1,55 +0,0 @@
-/**
- * Versioning Utilities
- *
- * Generates versioned output paths for DOCX modifications.
- *
- * @module docx/utils/versioning
- */
-import fs from 'fs/promises';
-import path from 'path';
-/**
- * Generate the versioned output path for a DOCX modification.
- *
- * Strategy:
- * - Look at existing sibling files `{base}_vN.ext` and pick the next N.
- * - If no versions exist yet, start at `_v1`.
- * - If some versions exist, always return the highest existing + 1.
- *
- * This gives you `version_i` per update over time **even if** every request
- * always uses the original file as `filePath`, while still producing only
- * ONE output file per request (callers invoke this once per edit).
- *
- * Examples:
- *   demo.docx     → demo_v1.docx  (always _v1, overwrites if exists)
- *   demo_v1.docx  → demo_v2.docx  (increments to _v2, overwrites if exists)
- *   demo_v2.docx  → demo_v3.docx  (increments to _v3, overwrites if exists)
- */
-export async function generateOutputPath(filePath) {
-    const dir = path.dirname(filePath);
-    const ext = path.extname(filePath);
-    const baseName = path.basename(filePath, ext);
-    // Normalise base to strip any existing _vN suffix so that
-    // passing in either "demo.docx" or "demo_v3.docx" still
-    // continues the same version sequence.
-    const cleanBase = baseName.replace(/_v\d+$/, '');
-    try {
-        const entries = await fs.readdir(dir);
-        let maxVersion = 0;
-        const versionRegex = new RegExp(`^${cleanBase}_v(\\d+)${ext.replace('.', '\\.')}$`, 'i');
-        for (const entry of entries) {
-            const match = entry.match(versionRegex);
-            if (match) {
-                const v = parseInt(match[1], 10);
-                if (!Number.isNaN(v) && v > maxVersion) {
-                    maxVersion = v;
-                }
-            }
-        }
-        const nextVersion = maxVersion + 1 || 1;
-        return path.join(dir, `${cleanBase}_v${nextVersion}${ext}`);
-    }
-    catch {
-        // If we can't list the directory for any reason, fall back to _v1.
-        return path.join(dir, `${cleanBase}_v1${ext}`);
-    }
-}

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

@@ -1,101 +0,0 @@
-/**
- * DOCX Utility Functions
- * Helper functions for DOCX operations, validation, and data transformation
- */
-/**
- * Check if a string is a valid data URL
- */
-export declare function isDataUrl(src: string): boolean;
-/**
- * Check if a source is a URL (http/https)
- */
-export declare function isUrl(src: string): boolean;
-/**
- * Parse data URL into buffer
- * @returns Buffer if successful, null if invalid
- */
-export declare function parseDataUrl(dataUrl: string): Buffer | null;
-/**
- * Resolve image path relative to base directory
- */
-export declare function resolveImagePath(imagePath: string, baseDir?: string): string;
-/**
- * Check if a file exists
- */
-export declare function fileExists(filePath: string): Promise<boolean>;
-/**
- * Validate image file
- */
-export declare function validateImageFile(imagePath: string): Promise<{
-    valid: boolean;
-    error?: string;
-}>;
-/**
- * Escape special regex characters for literal string matching
- */
-export declare function escapeRegExp(str: string): string;
-/**
- * Validate markdown table format
- */
-export declare function isValidMarkdownTable(markdown: string): boolean;
-/**
- * Build a markdown table from a 2D array of rows
- */
-export declare function buildMarkdownTableFromRows(rows: string[][]): string;
-/**
- * Parse markdown table into 2D array
- */
-export declare function parseMarkdownTable(markdown: string): string[][] | null;
-/**
- * Get MIME type from file extension or data URL
- */
-export declare function getMimeType(source: string): string | null;
-/**
- * Format file size in human-readable format
- */
-export declare function formatFileSize(bytes: number): string;
-/**
- * Normalize line endings to \n
- */
-export declare function normalizeLineEndings(text: string): string;
-/**
- * Split markdown into lines, preserving empty lines
- */
-export declare function splitMarkdownLines(markdown: string): string[];
-/**
- * Validate DOCX file path
- */
-export declare function isDocxPath(filePath: string): boolean;
-/**
- * Extract file name without extension
- */
-export declare function getFileNameWithoutExtension(filePath: string): string;
-export { DocxError, DocxErrorCode, withErrorContext } from './errors.js';
-/**
- * Image data prepared for DOCX embedding
- */
-export interface PreparedImage {
-    buffer: Buffer;
-    width?: number;
-    height?: number;
-    altText: string;
-    mimeType: string;
-}
-/**
- * Load and prepare an image for DOCX embedding
- * Handles both local files and data URLs
- *
- * @param imagePath - Path to image file or data URL
- * @param altText - Alternative text for the image
- * @param baseDir - Base directory for resolving relative paths
- * @returns Prepared image data ready for embedding
- */
-export declare function prepareImageForDocx(imagePath: string, altText?: string, baseDir?: string): Promise<PreparedImage>;
-/**
- * Create an ImageRun instance for embedding in DOCX paragraphs
- * This is a lower-level utility for direct image insertion
- *
- * @param imageData - Prepared image data
- * @returns ImageRun instance ready to be added to a paragraph
- */
-export declare function createImageRun(imageData: PreparedImage): any;