@wonderwhy-er/desktop-commander 0.2.38 → 0.2.39

package/dist/tools/docx/xml-view.js

@@ -1,169 +0,0 @@
-/**
- * DOCX XML View
- *
- * Exposes word/document.xml from a DOCX file as pretty-printed XML that can be
- * read with offset/length pagination and edited with find/replace, just like a
- * text file. All formatting is preserved because we operate on the actual XML.
- *
- * Round-trip: DOCX → unzip → pretty-print → edit → compact → repack → DOCX
- */
-import fs from 'fs/promises';
-import PizZip from 'pizzip';
-// ════════════════════════════════════════════════════════════════
-// XML pretty-print / compact
-// ════════════════════════════════════════════════════════════════
-/**
- * Pretty-print XML by splitting tags onto separate lines with indentation.
- *
- * Preserves content inside text nodes exactly. Self-closing tags, inline
- * open+close tags (e.g. <w:t>text</w:t>), and pure closing tags are all
- * handled so that compact→pretty→compact is lossless.
- */
-export function prettyPrintXml(xml) {
-    // Split between adjacent tags: "><" → ">\n<"
-    // But NOT inside text content — we only split where > is immediately followed by <
-    const parts = xml.split(/(?<=>)(?=<)/);
-    const lines = [];
-    let depth = 0;
-    for (const part of parts) {
-        const trimmed = part.trim();
-        if (!trimmed)
-            continue;
-        const isClosing = trimmed.startsWith('</');
-        const isSelfClosing = trimmed.endsWith('/>');
-        const isProcessingInstruction = trimmed.startsWith('<?');
-        // Inline: opens and closes on same fragment, e.g. <w:t>foo</w:t>
-        const isInline = !isClosing && !isSelfClosing && trimmed.includes('</');
-        if (isClosing) {
-            depth = Math.max(0, depth - 1);
-        }
-        lines.push('  '.repeat(depth) + trimmed);
-        if (!isClosing && !isSelfClosing && !isInline && !isProcessingInstruction) {
-            depth++;
-        }
-    }
-    return lines.join('\n');
-}
-/**
- * Compact pretty-printed XML back to a single line.
- *
- * CRITICAL: Must not introduce or remove whitespace inside <w:t> text nodes
- * or break xml:space="preserve" semantics. We achieve this by only stripping
- * leading indentation (which we added) and joining lines. The original XML
- * had no newlines between tags, so this restores the original form.
- */
-export function compactXml(prettyXml) {
-    const lines = prettyXml.split('\n');
-    return lines.map(l => l.trimStart()).join('');
-}
-/**
- * Read the document.xml from a DOCX as pretty-printed, line-based XML.
- * Supports offset/length pagination just like text file reading.
- */
-export async function readDocxXml(filePath, offset = 0, length) {
-    const buf = await fs.readFile(filePath);
-    const zip = new PizZip(buf);
-    const docFile = zip.file('word/document.xml');
-    if (!docFile)
-        throw new Error('Invalid DOCX: missing word/document.xml');
-    const rawXml = docFile.asText();
-    const pretty = prettyPrintXml(rawXml);
-    const allLines = pretty.split('\n');
-    const totalLines = allLines.length;
-    // Apply pagination
-    let startLine;
-    let sliceLength;
-    if (offset < 0) {
-        // Negative offset = tail (last N lines)
-        startLine = Math.max(0, totalLines + offset);
-        sliceLength = totalLines - startLine;
-    }
-    else {
-        startLine = offset;
-        sliceLength = length ?? totalLines;
-    }
-    const slicedLines = allLines.slice(startLine, startLine + sliceLength);
-    const content = slicedLines.join('\n');
-    return {
-        content,
-        lineCount: totalLines,
-        path: filePath,
-        rawSize: rawXml.length,
-    };
-}
-/**
- * Apply a find/replace edit to a DOCX file's XML and write a new DOCX.
- *
- * The edit operates on the pretty-printed XML so that line-based context
- * from read_file can be used directly as the search string. After editing,
- * the XML is compacted back and repacked into the DOCX zip.
- *
- * @returns result with status, match count, and output path
- */
-export async function editDocxXml(inputPath, outputPath, oldStr, newStr, expectedReplacements = 1) {
-    // 1. Read + pretty-print
-    const buf = await fs.readFile(inputPath);
-    const zip = new PizZip(buf);
-    const docFile = zip.file('word/document.xml');
-    if (!docFile)
-        throw new Error('Invalid DOCX: missing word/document.xml');
-    const rawXml = docFile.asText();
-    const pretty = prettyPrintXml(rawXml);
-    // 2. Normalize the search string's indentation to match our pretty-print.
-    //    The caller might copy lines from read_file output which uses the same
-    //    indentation, but just in case, we also try trimStart normalization.
-    let matchCount = countOccurrences(pretty, oldStr);
-    if (matchCount === 0) {
-        return {
-            status: 'no_match',
-            matchCount: 0,
-            outputPath,
-            message: `Search string not found in ${inputPath}`,
-        };
-    }
-    if (matchCount !== expectedReplacements) {
-        return {
-            status: 'unexpected_count',
-            matchCount,
-            outputPath,
-            message: `Expected ${expectedReplacements} occurrence(s) but found ${matchCount}. ` +
-                `Add more surrounding context to make the search string unique, ` +
-                `or set expected_replacements to ${matchCount} to replace all.`,
-        };
-    }
-    // 3. Apply edit(s)
-    let edited = pretty;
-    if (expectedReplacements === 1) {
-        const idx = edited.indexOf(oldStr);
-        edited = edited.substring(0, idx) + newStr + edited.substring(idx + oldStr.length);
-    }
-    else {
-        edited = edited.split(oldStr).join(newStr);
-    }
-    // 4. Compact + repack
-    const compacted = compactXml(edited);
-    zip.file('word/document.xml', compacted);
-    const outBuf = zip.generate({
-        type: 'nodebuffer',
-        compression: 'DEFLATE',
-        compressionOptions: { level: 6 },
-    });
-    await fs.writeFile(outputPath, outBuf);
-    return {
-        status: 'applied',
-        matchCount,
-        outputPath,
-    };
-}
-// ════════════════════════════════════════════════════════════════
-// Helpers
-// ════════════════════════════════════════════════════════════════
-function countOccurrences(haystack, needle) {
-    let count = 0;
-    let pos = haystack.indexOf(needle);
-    while (pos !== -1) {
-        count++;
-        pos = haystack.indexOf(needle, pos + 1);
-    }
-    return count;
-}

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

@@ -1,21 +0,0 @@
-/**
- * DOCX ZIP I/O — Single Responsibility: file ↔ zip ↔ xml.
- *
- * Every other module depends on these three functions for disk I/O;
- * none of them touch the file system directly.
- */
-import PizZip from 'pizzip';
-/**
- * Read a .docx file from disk and return a PizZip instance.
- */
-export declare function loadDocxZip(filePath: string): Promise<PizZip>;
-/**
- * Extract the raw XML string from word/document.xml inside the zip.
- * Throws if the entry is missing.
- */
-export declare function getDocumentXml(zip: PizZip): string;
-/**
- * Replace word/document.xml in the zip with new XML,
- * then write the whole archive to outputPath.
- */
-export declare function saveDocxZip(zip: PizZip, newDocumentXml: string, outputPath: string): Promise<void>;

package/dist/tools/docx/zip.js

@@ -1,35 +0,0 @@
-/**
- * DOCX ZIP I/O — Single Responsibility: file ↔ zip ↔ xml.
- *
- * Every other module depends on these three functions for disk I/O;
- * none of them touch the file system directly.
- */
-import fs from 'fs/promises';
-import PizZip from 'pizzip';
-/**
- * Read a .docx file from disk and return a PizZip instance.
- */
-export async function loadDocxZip(filePath) {
-    const buf = await fs.readFile(filePath);
-    return new PizZip(buf);
-}
-/**
- * Extract the raw XML string from word/document.xml inside the zip.
- * Throws if the entry is missing.
- */
-export function getDocumentXml(zip) {
-    const entry = zip.file('word/document.xml');
-    if (!entry) {
-        throw new Error('Invalid DOCX: missing word/document.xml');
-    }
-    return entry.asText();
-}
-/**
- * Replace word/document.xml in the zip with new XML,
- * then write the whole archive to outputPath.
- */
-export async function saveDocxZip(zip, newDocumentXml, outputPath) {
-    zip.file('word/document.xml', newDocumentXml);
-    const buf = zip.generate({ type: 'nodebuffer' });
-    await fs.writeFile(outputPath, buf);
-}

package/dist/tools/macos-control/ax-adapter.d.ts

@@ -1,55 +0,0 @@
-import { AxBatchCommand, AxBatchResult, AxAppInfo, AxElement, AxStatus, MacosControlResult } from './types.js';
-export declare class AxAdapter {
-    private helperPathCache;
-    private signatures;
-    private resolveHelperPath;
-    private runHelper;
-    private rememberElements;
-    private elementScore;
-    private fallbackRefindElement;
-    status(): Promise<MacosControlResult<AxStatus>>;
-    listApps(): Promise<MacosControlResult<AxAppInfo[]>>;
-    listElements(args: {
-        scope?: 'top_window' | 'app' | 'all';
-        app?: string;
-        text?: string;
-        role?: string;
-        depth?: number;
-        limit?: number;
-    }): Promise<MacosControlResult<AxElement[]>>;
-    find(args: {
-        app: string;
-        text?: string;
-        role?: string;
-        depth?: number;
-        limit?: number;
-        index?: number;
-    }): Promise<MacosControlResult<AxElement[]>>;
-    clickById(id: string, appHint?: string): Promise<MacosControlResult<Record<string, unknown>>>;
-    typeText(text: string): Promise<MacosControlResult<Record<string, unknown>>>;
-    pressKey(key: string, modifiers?: string[]): Promise<MacosControlResult<Record<string, unknown>>>;
-    activate(app: string): Promise<MacosControlResult<Record<string, unknown>>>;
-    waitFor(args: {
-        app: string;
-        text: string;
-        role?: string;
-        timeout_ms?: number;
-        depth?: number;
-    }): Promise<MacosControlResult<AxElement>>;
-    getState(args: {
-        app: string;
-        text?: string;
-        role?: string;
-        depth?: number;
-        limit?: number;
-        index?: number;
-    }): Promise<MacosControlResult<Record<string, unknown>>>;
-    scroll(args: {
-        x: number;
-        y: number;
-        direction?: 'up' | 'down';
-        amount?: number;
-    }): Promise<MacosControlResult<Record<string, unknown>>>;
-    batch(commands: AxBatchCommand[], stopOnError: boolean): Promise<MacosControlResult<AxBatchResult>>;
-}
-export declare const axAdapter: AxAdapter;