@zengjing/xmind-mcp 1.0.0

package/dist/cli.js

@@ -0,0 +1,170 @@
+#!/usr/bin/env node
+/**
+ * CLI tool for extracting and analyzing XMind files.
+ * Usage: node dist/cli.js <file-path> [options]
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { parseXMindFile } from './core/parser.js';
+import { xmindToMarkdown } from './formatters/markdown-formatter.js';
+import { xmindToJSON } from './formatters/json-formatter.js';
+import { isXMindError } from './utils/errors.js';
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
+        printHelp();
+        process.exit(0);
+    }
+    const filePath = args[0];
+    const options = parseArgs(args.slice(1));
+    try {
+        // Resolve file path (support ~ expansion)
+        const resolvedPath = filePath.startsWith('~')
+            ? path.join(process.env.HOME || '/', filePath.slice(1))
+            : path.resolve(filePath);
+        // Check file exists
+        try {
+            await fs.access(resolvedPath);
+        }
+        catch {
+            console.error(`❌ File not found: ${resolvedPath}`);
+            process.exit(1);
+        }
+        if (options.verbose) {
+            console.log(`📖 Parsing: ${resolvedPath}`);
+        }
+        // Parse the file
+        const result = await parseXMindFile(resolvedPath);
+        // Display metadata
+        console.log('\n═══════════════════════════════════════');
+        console.log('📊 XMind File Information');
+        console.log('═══════════════════════════════════════');
+        console.log(`Format: ${result.meta?.formatVersion}`);
+        console.log(`Sheets: ${result.sheets.length}`);
+        console.log(`Total Topics: ${result.meta?.topicCount}`);
+        console.log(`Parsed at: ${result.meta?.parsedAt}`);
+        if (options.verbose) {
+            result.sheets.forEach((sheet, idx) => {
+                console.log(`  Sheet ${idx + 1}: "${sheet.title}"`);
+            });
+        }
+        // Format content
+        let content;
+        if (options.format === 'json') {
+            content = xmindToJSON(result);
+        }
+        else {
+            content = xmindToMarkdown(result);
+        }
+        // Handle search
+        if (options.search) {
+            content = filterContentBySearch(content, options.search, options.format);
+        }
+        // Output
+        console.log('\n═══════════════════════════════════════');
+        console.log(`📄 Content (${options.format.toUpperCase()} format)`);
+        console.log('═══════════════════════════════════════\n');
+        console.log(content);
+        // Save to file if specified
+        if (options.output) {
+            await fs.writeFile(options.output, content, 'utf-8');
+            console.log(`\n✅ Content saved to: ${options.output}`);
+        }
+        process.exit(0);
+    }
+    catch (error) {
+        if (isXMindError(error)) {
+            console.error(`\n❌ Error: ${error.message}`);
+        }
+        else if (error instanceof Error) {
+            console.error(`\n❌ Unexpected error: ${error.message}`);
+        }
+        else {
+            console.error('\n❌ An unknown error occurred');
+        }
+        process.exit(1);
+    }
+}
+function parseArgs(args) {
+    const options = {
+        format: 'markdown',
+        verbose: false,
+    };
+    for (let i = 0; i < args.length; i++) {
+        switch (args[i]) {
+            case '--format':
+            case '-f':
+                if (args[i + 1] && (args[i + 1] === 'json' || args[i + 1] === 'markdown')) {
+                    options.format = args[i + 1];
+                    i++;
+                }
+                break;
+            case '--output':
+            case '-o':
+                if (args[i + 1]) {
+                    options.output = args[i + 1];
+                    i++;
+                }
+                break;
+            case '--search':
+            case '-s':
+                if (args[i + 1]) {
+                    options.search = args[i + 1];
+                    i++;
+                }
+                break;
+            case '--verbose':
+            case '-v':
+                options.verbose = true;
+                break;
+        }
+    }
+    return options;
+}
+function filterContentBySearch(content, query, format) {
+    const lines = content.split('\n');
+    const filtered = lines.filter(line => line.toLowerCase().includes(query.toLowerCase()));
+    if (filtered.length === 0) {
+        return `No results found for: "${query}"`;
+    }
+    return filtered.join('\n');
+}
+function printHelp() {
+    console.log(`
+╔════════════════════════════════════════════════════════════╗
+║          XMind Parser CLI - Extract Mind Map Content       ║
+╚════════════════════════════════════════════════════════════╝
+
+USAGE:
+  node dist/cli.js <file-path> [options]
+
+ARGUMENTS:
+  <file-path>     Path to the .xmind file (supports ~ for home directory)
+
+OPTIONS:
+  -f, --format    Output format: 'markdown' (default) or 'json'
+  -o, --output    Save output to file (optional)
+  -s, --search    Filter results by keyword (optional)
+  -v, --verbose   Show detailed information
+  -h, --help      Show this help message
+
+EXAMPLES:
+  # Basic usage - print to console
+  node dist/cli.js ~/Documents/my-mindmap.xmind
+
+  # JSON format
+  node dist/cli.js ~/Documents/my-mindmap.xmind --format json
+
+  # Save to file
+  node dist/cli.js ~/Documents/my-mindmap.xmind -o output.md
+
+  # Search and filter
+  node dist/cli.js ~/Documents/my-mindmap.xmind --search "important"
+
+  # Verbose with output file
+  node dist/cli.js ~/Documents/my-mindmap.xmind -v -o result.json --format json
+
+`);
+}
+main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AASjD,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAClE,SAAS,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAEzC,IAAI,CAAC;QACH,0CAA0C;QAC1C,MAAM,YAAY,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC;YAC3C,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACvD,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAE3B,oBAAoB;QACpB,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,KAAK,CAAC,qBAAqB,YAAY,EAAE,CAAC,CAAC;YACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,eAAe,YAAY,EAAE,CAAC,CAAC;QAC7C,CAAC;QAED,iBAAiB;QACjB,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,YAAY,CAAC,CAAC;QAElD,mBAAmB;QACnB,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;QACvD,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,iBAAiB,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAEnD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;gBACnC,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,MAAM,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;YACtD,CAAC,CAAC,CAAC;QACL,CAAC;QAED,iBAAiB;QACjB,IAAI,OAAe,CAAC;QACpB,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC9B,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QACpC,CAAC;QAED,gBAAgB;QAChB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,OAAO,GAAG,qBAAqB,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC3E,CAAC;QAED,SAAS;QACT,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,eAAe,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QACnE,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAErB,4BAA4B;QAC5B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YACrD,OAAO,CAAC,GAAG,CAAC,yBAAyB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,KAAK,CAAC,cAAc,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/C,CAAC;aAAM,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAClC,OAAO,CAAC,KAAK,CAAC,yBAAyB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1D,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,OAAO,GAAe;QAC1B,MAAM,EAAE,UAAU;QAClB,OAAO,EAAE,KAAK;KACf,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,QAAQ,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAChB,KAAK,UAAU,CAAC;YAChB,KAAK,IAAI;gBACP,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,UAAU,CAAC,EAAE,CAAC;oBAC1E,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAwB,CAAC;oBACpD,CAAC,EAAE,CAAC;gBACN,CAAC;gBACD,MAAM;YACR,KAAK,UAAU,CAAC;YAChB,KAAK,IAAI;gBACP,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;oBAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;oBAC7B,CAAC,EAAE,CAAC;gBACN,CAAC;gBACD,MAAM;YACR,KAAK,UAAU,CAAC;YAChB,KAAK,IAAI;gBACP,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;oBAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;oBAC7B,CAAC,EAAE,CAAC;gBACN,CAAC;gBACD,MAAM;YACR,KAAK,WAAW,CAAC;YACjB,KAAK,IAAI;gBACP,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;gBACvB,MAAM;QACV,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,qBAAqB,CAAC,OAAe,EAAE,KAAa,EAAE,MAAc;IAC3E,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CACnC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CACjD,CAAC;IAEF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,0BAA0B,KAAK,GAAG,CAAC;IAC5C,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCb,CAAC,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/core/legacy-parser.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Parser for legacy XMind format (XML-based, versions 8 and earlier).
+ * Legacy XMind files use XML structure within the ZIP container.
+ */
+import type { XMindNode, XMindSheet } from '../model/types.js';
+interface LegacyTopic {
+    '@_id': string;
+    '@_href'?: string;
+    title?: string | {
+        '#text': string;
+    };
+    'notes'?: string | {
+        '#text': string;
+    };
+    markers?: {
+        marker?: Array<{
+            '@_markerId': string;
+        }> | {
+            '@_markerId': string;
+        };
+    };
+    labels?: {
+        label?: Array<{
+            '#text': string;
+        }> | {
+            '#text': string;
+        };
+    };
+    topic?: LegacyTopic[] | LegacyTopic;
+    children?: {
+        topics?: Array<{
+            topic?: LegacyTopic[] | LegacyTopic;
+            '@_type'?: string;
+        }> | {
+            topic?: LegacyTopic[] | LegacyTopic;
+            '@_type'?: string;
+        };
+    };
+    'relationship'?: Array<{
+        '@_id': string;
+        '@_end': string;
+        '@_sourceId': string;
+        '@_targetId': string;
+        '@_title'?: string;
+    }> | {
+        '@_id': string;
+        '@_end': string;
+        '@_sourceId': string;
+        '@_targetId': string;
+        '@_title'?: string;
+    };
+}
+/**
+ * Transform raw Legacy XML topic to normalized XMindNode.
+ * Recursively processes child topics.
+ */
+export declare function transformLegacyTopic(legacyTopic: LegacyTopic): XMindNode;
+/**
+ * Parse Legacy XML format content into XMindSheet objects.
+ */
+export declare function parseLegacyContent(xmlText: string): Promise<XMindSheet[]>;
+export {};
+//# sourceMappingURL=legacy-parser.d.ts.map

package/dist/core/legacy-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-parser.d.ts","sourceRoot":"","sources":["../../src/core/legacy-parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAI/D,UAAU,WAAW;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,KAAK,CAAC;YAAE,YAAY,EAAE,MAAM,CAAA;SAAE,CAAC,GAAG;YAAE,YAAY,EAAE,MAAM,CAAA;SAAE,CAAC;KACrE,CAAC;IACF,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,GAAG;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;KAC1D,CAAC;IACF,KAAK,CAAC,EAAE,WAAW,EAAE,GAAG,WAAW,CAAC;IAEpC,QAAQ,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,KAAK,CAAC;YAAE,KAAK,CAAC,EAAE,WAAW,EAAE,GAAG,WAAW,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,GAAG;YAAE,KAAK,CAAC,EAAE,WAAW,EAAE,GAAG,WAAW,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KACzI,CAAC;IACF,cAAc,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACnO;AAqCD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,SAAS,CAoDxE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CA+D/E"}

package/dist/core/legacy-parser.js

@@ -0,0 +1,139 @@
+/**
+ * Parser for legacy XMind format (XML-based, versions 8 and earlier).
+ * Legacy XMind files use XML structure within the ZIP container.
+ */
+import { XMLParser } from 'fast-xml-parser';
+import { ParseError } from '../utils/errors.js';
+import { debug } from '../utils/logger.js';
+/**
+ * Normalize a single item or array to always be an array.
+ * fast-xml-parser returns a single object if there's one item,
+ * and an array if there are multiple items.
+ */
+function normalizeArray(value) {
+    if (!value)
+        return [];
+    return Array.isArray(value) ? value : [value];
+}
+/**
+ * Extract text from a string or object with #text property.
+ */
+function extractText(value) {
+    if (!value)
+        return undefined;
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'object' && '#text' in value)
+        return value['#text'];
+    return undefined;
+}
+/**
+ * Transform raw Legacy XML topic to normalized XMindNode.
+ * Recursively processes child topics.
+ */
+export function transformLegacyTopic(legacyTopic) {
+    const node = {
+        id: legacyTopic['@_id'],
+        title: extractText(legacyTopic.title) || '',
+        children: [],
+        href: legacyTopic['@_href'],
+    };
+    // Extract note
+    const noteValue = legacyTopic.notes;
+    if (noteValue) {
+        node.note = extractText(noteValue);
+    }
+    // Extract markers
+    if (legacyTopic.markers && legacyTopic.markers.marker) {
+        const markerArray = normalizeArray(legacyTopic.markers.marker);
+        node.markers = markerArray.map(m => m['@_markerId']);
+    }
+    // Extract labels
+    if (legacyTopic.labels && legacyTopic.labels.label) {
+        const labelArray = normalizeArray(legacyTopic.labels.label);
+        node.labels = labelArray.map(l => extractText(l) || '').filter(l => l.length > 0);
+    }
+    // Recursively process child topics
+    // Support two formats:
+    // 1. Old format: <topic><topic>...</topic></topic> (direct topic children)
+    // 2. New format: <children><topics type="attached"><topic>...</topic></topics></children>
+    let childTopics = [];
+    if (legacyTopic.topic) {
+        // Old format: direct topic children
+        childTopics = normalizeArray(legacyTopic.topic);
+    }
+    else if (legacyTopic.children?.topics) {
+        // New format: children > topics array
+        const topicsArray = normalizeArray(legacyTopic.children.topics);
+        // Each topics element can have topic children
+        topicsArray.forEach(topicsElement => {
+            if (topicsElement.topic) {
+                const topicChildren = normalizeArray(topicsElement.topic);
+                childTopics.push(...topicChildren);
+            }
+        });
+    }
+    if (childTopics.length > 0) {
+        node.children = childTopics.map(child => transformLegacyTopic(child));
+    }
+    return node;
+}
+/**
+ * Parse Legacy XML format content into XMindSheet objects.
+ */
+export async function parseLegacyContent(xmlText) {
+    try {
+        const parser = new XMLParser({
+            ignoreAttributes: false,
+            attributeNamePrefix: '@_',
+            textNodeName: '#text',
+        });
+        const parsed = parser.parse(xmlText);
+        if (!parsed['xmap-content']) {
+            throw new ParseError('Invalid Legacy XML format: missing xmap-content root element');
+        }
+        const xcontent = parsed['xmap-content'];
+        if (!xcontent.sheet) {
+            throw new ParseError('Invalid Legacy XML format: missing sheet element');
+        }
+        const sheets = normalizeArray(xcontent.sheet);
+        // Extract relationships from relationship-map (optional)
+        const relationshipsMap = new Map();
+        if (xcontent['relationship-map'] && xcontent['relationship-map'].relationship) {
+            const relArray = normalizeArray(xcontent['relationship-map'].relationship);
+            // Group relationships by sheet ID if available (relationships are usually global)
+            relArray.forEach(rel => {
+                if (!relationshipsMap.has('global')) {
+                    relationshipsMap.set('global', []);
+                }
+                relationshipsMap.get('global').push(rel);
+            });
+        }
+        return sheets.map(sheet => {
+            if (!sheet['topic']) {
+                throw new ParseError(`Sheet "${sheet.title}" is missing root topic`);
+            }
+            debug('Transforming Legacy XML sheet', { sheetId: sheet['@_id'], title: sheet.title });
+            const rootTopic = transformLegacyTopic(sheet['topic']);
+            // Transform relationships for this sheet
+            const relationships = (relationshipsMap.get('global') || []).map(rel => ({
+                id: rel['@_id'],
+                title: rel['@_title'],
+                sourceId: rel['@_sourceId'],
+                targetId: rel['@_targetId'],
+            }));
+            return {
+                id: sheet['@_id'],
+                title: sheet.title,
+                rootTopic,
+                relationships: relationships.length > 0 ? relationships : undefined,
+            };
+        });
+    }
+    catch (err) {
+        if (err instanceof ParseError)
+            throw err;
+        throw new ParseError('Failed to parse Legacy XML', err.message);
+    }
+}
+//# sourceMappingURL=legacy-parser.js.map

package/dist/core/legacy-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-parser.js","sourceRoot":"","sources":["../../src/core/legacy-parser.ts"],"names":[],"mappings":"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"}

package/dist/core/parser.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Main parser dispatcher for XMind files.
+ * Detects file format (Zen or Legacy) and routes to appropriate parser.
+ * Handles ZIP extraction, format detection, and unified result generation.
+ */
+import type { XMindParsedResult } from '../model/types.js';
+/**
+ * Parse an XMind file (.xmind is a ZIP container).
+ * Detects format (Zen JSON or Legacy XML) and routes to appropriate parser.
+ * Returns a unified XMindParsedResult with metadata.
+ *
+ * @param filePath - Absolute path to the .xmind file
+ * @returns Parsed XMind document with sheets and metadata
+ * @throws FileNotFoundError if file does not exist
+ * @throws InvalidFormatError if ZIP is corrupted or format cannot be detected
+ * @throws ParseError if content parsing fails
+ */
+export declare function parseXMindFile(filePath: string): Promise<XMindParsedResult>;
+//# sourceMappingURL=parser.d.ts.map

package/dist/core/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/core/parser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAa,iBAAiB,EAAc,MAAM,mBAAmB,CAAC;AAMlF;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA+FjF"}

package/dist/core/parser.js

@@ -0,0 +1,111 @@
+/**
+ * Main parser dispatcher for XMind files.
+ * Detects file format (Zen or Legacy) and routes to appropriate parser.
+ * Handles ZIP extraction, format detection, and unified result generation.
+ */
+import * as fs from 'fs/promises';
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+import JSZip from 'jszip';
+import { FileNotFoundError, InvalidFormatError, ParseError } from '../utils/errors.js';
+import { debug, info } from '../utils/logger.js';
+import { parseZenContent, countTopics } from './zen-parser.js';
+import { parseLegacyContent } from './legacy-parser.js';
+/**
+ * Parse an XMind file (.xmind is a ZIP container).
+ * Detects format (Zen JSON or Legacy XML) and routes to appropriate parser.
+ * Returns a unified XMindParsedResult with metadata.
+ *
+ * @param filePath - Absolute path to the .xmind file
+ * @returns Parsed XMind document with sheets and metadata
+ * @throws FileNotFoundError if file does not exist
+ * @throws InvalidFormatError if ZIP is corrupted or format cannot be detected
+ * @throws ParseError if content parsing fails
+ */
+export async function parseXMindFile(filePath) {
+    info('Starting XMind file parsing', { filePath });
+    // Step 1: Verify file exists
+    try {
+        await fs.access(filePath);
+    }
+    catch (err) {
+        throw new FileNotFoundError(filePath);
+    }
+    // Step 2: Read file and extract ZIP
+    let zipData;
+    try {
+        zipData = await fs.readFile(filePath);
+    }
+    catch (err) {
+        throw new FileNotFoundError(filePath);
+    }
+    let zip;
+    try {
+        zip = new JSZip();
+        await zip.loadAsync(zipData);
+    }
+    catch (err) {
+        throw new InvalidFormatError('ZIP container is corrupted or invalid');
+    }
+    debug('ZIP loaded successfully', { fileSize: zipData.length });
+    // Step 3: Detect format (Zen or Legacy)
+    let sheets;
+    let formatVersion;
+    // Try Zen format first (content.json)
+    if (zip.file('content.json')) {
+        debug('Detected Zen format (content.json)');
+        formatVersion = 'zen';
+        try {
+            const jsonData = await zip.file('content.json').async('string');
+            sheets = await parseZenContent(jsonData);
+        }
+        catch (err) {
+            throw new ParseError(`Failed to parse Zen format: ${err.message}`);
+        }
+    }
+    else if (zip.file('content.xml')) {
+        // Fall back to Legacy format (content.xml)
+        debug('Detected Legacy format (content.xml)');
+        formatVersion = 'legacy';
+        try {
+            const xmlData = await zip.file('content.xml').async('string');
+            sheets = await parseLegacyContent(xmlData);
+        }
+        catch (err) {
+            throw new ParseError(`Failed to parse Legacy format: ${err.message}`);
+        }
+    }
+    else {
+        // Neither format detected
+        throw new InvalidFormatError('Neither content.json (Zen) nor content.xml (Legacy) found in ZIP. File may be corrupted or created with an unsupported XMind version.');
+    }
+    // Step 4: Validate sheets
+    if (!sheets || sheets.length === 0) {
+        throw new InvalidFormatError('No sheets found in parsed document');
+    }
+    debug('Sheets parsed successfully', { sheetCount: sheets.length });
+    // Step 5: Calculate total topic count across all sheets
+    let totalTopicCount = 0;
+    for (const sheet of sheets) {
+        const sheetTopicCount = countTopics(sheet.rootTopic);
+        totalTopicCount += sheetTopicCount;
+        debug('Sheet topic count', { sheetId: sheet.id, topicCount: sheetTopicCount });
+    }
+    // Step 6: Construct and return unified result
+    const result = {
+        filePath,
+        sheets,
+        meta: {
+            formatVersion,
+            topicCount: totalTopicCount,
+            parsedAt: new Date().toISOString(),
+        },
+    };
+    info('XMind file parsed successfully', {
+        filePath,
+        formatVersion,
+        sheetCount: sheets.length,
+        topicCount: totalTopicCount,
+    });
+    return result;
+}
+//# sourceMappingURL=parser.js.map

package/dist/core/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/core/parser.ts"],"names":[],"mappings":"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"}

package/dist/core/zen-parser.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Parser for modern XMind Zen format (content.json).
+ * Zen files use a straightforward JSON structure within the ZIP container.
+ */
+import type { XMindNode, XMindSheet } from '../model/types.js';
+/**
+ * Parse Zen format JSON content into XMindSheet objects.
+ * Supports two formats: direct array of sheets or object with sheets property.
+ */
+export declare function parseZenContent(jsonText: string): Promise<XMindSheet[]>;
+/**
+ * Count total nodes in a parsed sheet (for metadata).
+ */
+export declare function countTopics(node: XMindNode): number;
+//# sourceMappingURL=zen-parser.d.ts.map

package/dist/core/zen-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zen-parser.d.ts","sourceRoot":"","sources":["../../src/core/zen-parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAuE/D;;;GAGG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAmC7E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAMnD"}

package/dist/core/zen-parser.js

@@ -0,0 +1,90 @@
+/**
+ * Parser for modern XMind Zen format (content.json).
+ * Zen files use a straightforward JSON structure within the ZIP container.
+ */
+import { ParseError } from '../utils/errors.js';
+import { debug } from '../utils/logger.js';
+/**
+ * Transform raw Zen JSON topic to normalized XMindNode.
+ * Recursively processes children (both attached and detached).
+ */
+function transformZenTopic(zenTopic) {
+    const node = {
+        id: zenTopic.id,
+        title: zenTopic.title,
+        children: [],
+        labels: zenTopic.labels,
+        href: zenTopic.href,
+    };
+    // Extract note (can be string or object with format)
+    if (zenTopic.notes) {
+        if (typeof zenTopic.notes === 'string') {
+            node.note = zenTopic.notes;
+        }
+        else if (typeof zenTopic.notes === 'object' && 'content' in zenTopic.notes) {
+            node.note = zenTopic.notes.content;
+        }
+    }
+    // Transform markers (extract marker IDs)
+    if (zenTopic.markers && zenTopic.markers.length > 0) {
+        node.markers = zenTopic.markers.map(m => m.markerId);
+    }
+    // Recursively process children (attached and detached)
+    if (zenTopic.children) {
+        const attached = zenTopic.children.attached || [];
+        const detached = zenTopic.children.detached || [];
+        const allChildren = [...attached, ...detached];
+        node.children = allChildren.map(child => transformZenTopic(child));
+    }
+    return node;
+}
+/**
+ * Parse Zen format JSON content into XMindSheet objects.
+ * Supports two formats: direct array of sheets or object with sheets property.
+ */
+export async function parseZenContent(jsonText) {
+    try {
+        const parsed = JSON.parse(jsonText);
+        let sheets;
+        // Handle both formats:
+        // 1. Direct array: [{ id, title, rootTopic }, ...]
+        // 2. Object with sheets: { sheets: [{ id, title, rootTopic }, ...] }
+        if (Array.isArray(parsed)) {
+            sheets = parsed;
+        }
+        else if (parsed.sheets && Array.isArray(parsed.sheets)) {
+            sheets = parsed.sheets;
+        }
+        else {
+            throw new ParseError('Invalid Zen format: missing or malformed sheets array');
+        }
+        return sheets.map(sheet => {
+            if (!sheet.rootTopic) {
+                throw new ParseError(`Sheet "${sheet.title}" is missing rootTopic`);
+            }
+            debug('Transforming Zen sheet', { sheetId: sheet.id, title: sheet.title });
+            return {
+                id: sheet.id,
+                title: sheet.title,
+                rootTopic: transformZenTopic(sheet.rootTopic),
+                relationships: sheet.relationships,
+            };
+        });
+    }
+    catch (err) {
+        if (err instanceof ParseError)
+            throw err;
+        throw new ParseError('Failed to parse Zen JSON', err.message);
+    }
+}
+/**
+ * Count total nodes in a parsed sheet (for metadata).
+ */
+export function countTopics(node) {
+    let count = 1;
+    for (const child of node.children) {
+        count += countTopics(child);
+    }
+    return count;
+}
+//# sourceMappingURL=zen-parser.js.map

package/dist/core/zen-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zen-parser.js","sourceRoot":"","sources":["../../src/core/zen-parser.ts"],"names":[],"mappings":"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"}