vimd 0.1.11 → 0.2.0

package/dist/core/converter.js

@@ -9,8 +9,37 @@ const __dirname = path.dirname(__filename);
 export class MarkdownConverter {
     constructor(config) {
         this.config = config;
+        this.parser = null;
+    }
+    /**
+     * Set the parser to use for conversion.
+     * If not set, falls back to legacy pandoc conversion.
+     * @param parser - The parser instance to use
+     */
+    setParser(parser) {
+        this.parser = parser;
+    }
+    /**
+     * Get the currently set parser.
+     * @returns The parser instance or null if not set
+     */
+    getParser() {
+        return this.parser;
     }
     async convert(markdownPath) {
+        // If a parser is set, use it
+        if (this.parser) {
+            const content = await fs.readFile(markdownPath, 'utf-8');
+            return this.parser.parse(content);
+        }
+        // Legacy: use direct pandoc execution for backward compatibility
+        return this.convertWithPandocLegacy(markdownPath);
+    }
+    /**
+     * Legacy pandoc conversion method.
+     * Used when no parser is explicitly set (backward compatibility).
+     */
+    async convertWithPandocLegacy(markdownPath) {
         const pandocArgs = this.buildPandocArgs();
         const command = `pandoc ${pandocArgs.join(' ')} "${markdownPath}"`;
         try {
@@ -68,7 +97,7 @@ export class MarkdownConverter {
             }
         }
         if (this.config.pandocOptions.highlightStyle) {
-            args.push(`--highlight-style=${this.config.pandocOptions.highlightStyle}`);
+            args.push(`--syntax-highlighting=${this.config.pandocOptions.highlightStyle}`);
         }
         // Metadata
         if (this.config.pandocOptions.metadata) {

package/dist/core/pandoc-detector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pandoc-detector.d.ts","sourceRoot":"","sources":["../../src/core/pandoc-detector.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEjD,qBAAa,cAAc;IACzB,MAAM,CAAC,KAAK,IAAI,OAAO;IASvB,MAAM,CAAC,QAAQ,IAAI,MAAM;IAczB,MAAM,CAAC,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IA4CzC,MAAM,CAAC,eAAe,IAAI,IAAI;CAQ/B"}
+{"version":3,"file":"pandoc-detector.d.ts","sourceRoot":"","sources":["../../src/core/pandoc-detector.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEjD,qBAAa,cAAc;IACzB,MAAM,CAAC,KAAK,IAAI,OAAO;IASvB,MAAM,CAAC,QAAQ,IAAI,MAAM;IAczB,MAAM,CAAC,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAiDzC,MAAM,CAAC,eAAe,IAAI,IAAI;CAQ/B"}

package/dist/core/pandoc-detector.js

@@ -26,8 +26,13 @@ export class PandocDetector {
     static showInstallGuide(os) {
         console.error('⚠️  pandoc not found');
         console.error('');
-        console.error('vimd requires pandoc to convert Markdown to HTML.');
-        console.error('Please install pandoc manually:');
+        console.error('pandoc is required for the selected parser mode.');
+        console.error('');
+        console.error('Option 1: Use markdown-it mode (no pandoc needed)');
+        console.error('  vimd dev document.md       (default, fast preview)');
+        console.error('  vimd build document.md --fast');
+        console.error('');
+        console.error('Option 2: Install pandoc for high-quality output');
         console.error('');
         switch (os) {
             case 'macos':

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

@@ -0,0 +1,5 @@
+export type { Parser, ParserType } from './types.js';
+export { MarkdownItParser } from './markdown-it-parser.js';
+export { PandocParser } from './pandoc-parser.js';
+export { ParserFactory } from './parser-factory.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/parser/index.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/core/parser/index.js

@@ -0,0 +1,4 @@
+// src/core/parser/index.ts
+export { MarkdownItParser } from './markdown-it-parser.js';
+export { PandocParser } from './pandoc-parser.js';
+export { ParserFactory } from './parser-factory.js';

package/dist/core/parser/markdown-it-parser.d.ts

@@ -0,0 +1,23 @@
+import { Parser } from './types.js';
+/**
+ * Markdown parser using markdown-it library.
+ * Provides fast markdown to HTML conversion with GFM support.
+ */
+export declare class MarkdownItParser implements Parser {
+    readonly name = "markdown-it";
+    private md;
+    constructor();
+    /**
+     * Convert markdown to HTML.
+     * @param markdown - The markdown content to convert
+     * @returns The converted HTML string
+     */
+    parse(markdown: string): Promise<string>;
+    /**
+     * Check if the parser is available.
+     * markdown-it is always available as it's an npm package.
+     * @returns Always returns true
+     */
+    isAvailable(): Promise<boolean>;
+}
+//# sourceMappingURL=markdown-it-parser.d.ts.map

package/dist/core/parser/markdown-it-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-it-parser.d.ts","sourceRoot":"","sources":["../../../src/core/parser/markdown-it-parser.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEpC;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,MAAM;IAC7C,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,OAAO,CAAC,EAAE,CAAa;;IAwBvB;;;;OAIG;IACG,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI9C;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAGtC"}

package/dist/core/parser/markdown-it-parser.js

@@ -0,0 +1,49 @@
+// src/core/parser/markdown-it-parser.ts
+import MarkdownIt from 'markdown-it';
+import hljs from 'highlight.js';
+import strikethrough from 'markdown-it-strikethrough-alt';
+import taskLists from 'markdown-it-task-lists';
+/**
+ * Markdown parser using markdown-it library.
+ * Provides fast markdown to HTML conversion with GFM support.
+ */
+export class MarkdownItParser {
+    constructor() {
+        this.name = 'markdown-it';
+        this.md = new MarkdownIt({
+            html: true,
+            linkify: true,
+            typographer: true,
+            highlight: (str, lang) => {
+                if (lang && hljs.getLanguage(lang)) {
+                    try {
+                        return hljs.highlight(str, { language: lang }).value;
+                    }
+                    catch {
+                        // Ignore highlight errors
+                    }
+                }
+                return ''; // Use external default escaping
+            },
+        });
+        // Enable GFM plugins
+        this.md.use(strikethrough); // ~~strikethrough~~
+        this.md.use(taskLists); // - [ ] task list
+    }
+    /**
+     * Convert markdown to HTML.
+     * @param markdown - The markdown content to convert
+     * @returns The converted HTML string
+     */
+    async parse(markdown) {
+        return this.md.render(markdown);
+    }
+    /**
+     * Check if the parser is available.
+     * markdown-it is always available as it's an npm package.
+     * @returns Always returns true
+     */
+    async isAvailable() {
+        return true;
+    }
+}

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

@@ -0,0 +1,27 @@
+import { Parser } from './types.js';
+import { PandocConfig } from '../../config/types.js';
+/**
+ * Markdown parser using pandoc.
+ * Provides high-quality markdown to HTML conversion with extensive features.
+ */
+export declare class PandocParser implements Parser {
+    readonly name = "pandoc";
+    private config;
+    constructor(config?: Partial<PandocConfig>);
+    /**
+     * Convert markdown to HTML using pandoc.
+     * @param markdown - The markdown content to convert
+     * @returns The converted HTML string
+     */
+    parse(markdown: string): Promise<string>;
+    /**
+     * Check if pandoc is available.
+     * @returns true if pandoc is installed and accessible
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Build pandoc command arguments from config.
+     */
+    private buildPandocArgs;
+}
+//# sourceMappingURL=pandoc-parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pandoc-parser.d.ts","sourceRoot":"","sources":["../../../src/core/parser/pandoc-parser.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAYrD;;;GAGG;AACH,qBAAa,YAAa,YAAW,MAAM;IACzC,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM;IAI9C;;;;OAIG;IACG,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAkB9C;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IASrC;;OAEG;IACH,OAAO,CAAC,eAAe;CA+BxB"}

package/dist/core/parser/pandoc-parser.js

@@ -0,0 +1,83 @@
+// src/core/parser/pandoc-parser.ts
+import { execSync } from 'child_process';
+/**
+ * Default pandoc configuration for high-quality HTML output.
+ */
+const DEFAULT_PANDOC_CONFIG = {
+    standalone: false,
+    toc: false,
+    tocDepth: 3,
+    highlightStyle: 'pygments',
+};
+/**
+ * Markdown parser using pandoc.
+ * Provides high-quality markdown to HTML conversion with extensive features.
+ */
+export class PandocParser {
+    constructor(config = {}) {
+        this.name = 'pandoc';
+        this.config = { ...DEFAULT_PANDOC_CONFIG, ...config };
+    }
+    /**
+     * Convert markdown to HTML using pandoc.
+     * @param markdown - The markdown content to convert
+     * @returns The converted HTML string
+     */
+    async parse(markdown) {
+        const pandocArgs = this.buildPandocArgs();
+        const command = `pandoc ${pandocArgs.join(' ')}`;
+        try {
+            const html = execSync(command, {
+                encoding: 'utf-8',
+                input: markdown,
+                maxBuffer: 10 * 1024 * 1024, // 10MB
+            });
+            return html;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to convert markdown with pandoc: ${errorMessage}`);
+        }
+    }
+    /**
+     * Check if pandoc is available.
+     * @returns true if pandoc is installed and accessible
+     */
+    async isAvailable() {
+        try {
+            execSync('pandoc --version', { stdio: 'pipe' });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Build pandoc command arguments from config.
+     */
+    buildPandocArgs() {
+        const args = [];
+        // Basic options
+        args.push('--from=markdown');
+        args.push('--to=html');
+        if (this.config.standalone) {
+            args.push('--standalone');
+        }
+        if (this.config.toc) {
+            args.push('--toc');
+            if (this.config.tocDepth) {
+                args.push(`--toc-depth=${this.config.tocDepth}`);
+            }
+        }
+        if (this.config.highlightStyle) {
+            args.push(`--syntax-highlighting=${this.config.highlightStyle}`);
+        }
+        // Metadata
+        if (this.config.metadata) {
+            Object.entries(this.config.metadata).forEach(([key, value]) => {
+                args.push(`--metadata=${key}:"${value}"`);
+            });
+        }
+        return args;
+    }
+}

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

@@ -0,0 +1,36 @@
+import { Parser, ParserType } from './types.js';
+import { PandocConfig } from '../../config/types.js';
+/**
+ * Factory for creating parser instances.
+ * Provides methods to create parsers by type and with fallback support.
+ */
+export declare class ParserFactory {
+    /**
+     * Create a parser instance by type.
+     * @param type - The type of parser to create
+     * @param pandocConfig - Optional configuration for pandoc parser
+     * @returns A parser instance
+     * @throws Error if the parser type is unknown
+     */
+    static create(type: ParserType, pandocConfig?: Partial<PandocConfig>): Parser;
+    /**
+     * Create a parser with fallback support.
+     * If the preferred parser is not available, falls back to markdown-it.
+     * @param preferred - The preferred parser type
+     * @param pandocConfig - Optional configuration for pandoc parser
+     * @returns A parser instance that is guaranteed to be available
+     * @throws Error if pandoc is preferred but not installed (no silent fallback)
+     */
+    static createWithFallback(preferred: ParserType, pandocConfig?: Partial<PandocConfig>): Promise<Parser>;
+    /**
+     * Get the default parser type for dev mode.
+     * @returns 'markdown-it' as the default for fast preview
+     */
+    static getDefaultDevParser(): ParserType;
+    /**
+     * Get the default parser type for build mode.
+     * @returns 'pandoc' as the default for high-quality output
+     */
+    static getDefaultBuildParser(): ParserType;
+}
+//# sourceMappingURL=parser-factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parser-factory.d.ts","sourceRoot":"","sources":["../../../src/core/parser/parser-factory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGhD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD;;;GAGG;AACH,qBAAa,aAAa;IACxB;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,MAAM;IAa7E;;;;;;;OAOG;WACU,kBAAkB,CAC7B,SAAS,EAAE,UAAU,EACrB,YAAY,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GACnC,OAAO,CAAC,MAAM,CAAC;IAmBlB;;;OAGG;IACH,MAAM,CAAC,mBAAmB,IAAI,UAAU;IAIxC;;;OAGG;IACH,MAAM,CAAC,qBAAqB,IAAI,UAAU;CAG3C"}

package/dist/core/parser/parser-factory.js

@@ -0,0 +1,63 @@
+// src/core/parser/parser-factory.ts
+import { MarkdownItParser } from './markdown-it-parser.js';
+import { PandocParser } from './pandoc-parser.js';
+/**
+ * Factory for creating parser instances.
+ * Provides methods to create parsers by type and with fallback support.
+ */
+export class ParserFactory {
+    /**
+     * Create a parser instance by type.
+     * @param type - The type of parser to create
+     * @param pandocConfig - Optional configuration for pandoc parser
+     * @returns A parser instance
+     * @throws Error if the parser type is unknown
+     */
+    static create(type, pandocConfig) {
+        switch (type) {
+            case 'markdown-it':
+                return new MarkdownItParser();
+            case 'pandoc':
+                return new PandocParser(pandocConfig);
+            default:
+                // TypeScript exhaustive check
+                const _exhaustive = type;
+                throw new Error(`Unknown parser type: ${_exhaustive}`);
+        }
+    }
+    /**
+     * Create a parser with fallback support.
+     * If the preferred parser is not available, falls back to markdown-it.
+     * @param preferred - The preferred parser type
+     * @param pandocConfig - Optional configuration for pandoc parser
+     * @returns A parser instance that is guaranteed to be available
+     * @throws Error if pandoc is preferred but not installed (no silent fallback)
+     */
+    static async createWithFallback(preferred, pandocConfig) {
+        const parser = this.create(preferred, pandocConfig);
+        if (await parser.isAvailable()) {
+            return parser;
+        }
+        // If pandoc was requested but not available, throw an error
+        // (we don't silently fall back to markdown-it for explicit pandoc requests)
+        if (preferred === 'pandoc') {
+            throw new Error('pandoc is not installed. Please install pandoc or use markdown-it parser.');
+        }
+        // For markdown-it, it's always available
+        return parser;
+    }
+    /**
+     * Get the default parser type for dev mode.
+     * @returns 'markdown-it' as the default for fast preview
+     */
+    static getDefaultDevParser() {
+        return 'markdown-it';
+    }
+    /**
+     * Get the default parser type for build mode.
+     * @returns 'pandoc' as the default for high-quality output
+     */
+    static getDefaultBuildParser() {
+        return 'pandoc';
+    }
+}

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

@@ -0,0 +1,26 @@
+/**
+ * Parser interface for markdown to HTML conversion.
+ * Both markdown-it and pandoc parsers implement this interface.
+ */
+export interface Parser {
+    /**
+     * Convert markdown content to HTML.
+     * @param markdown - The markdown content to convert
+     * @returns The converted HTML string
+     */
+    parse(markdown: string): Promise<string>;
+    /**
+     * Check if the parser is available for use.
+     * @returns true if the parser can be used
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * The name of the parser.
+     */
+    readonly name: string;
+}
+/**
+ * Available parser types.
+ */
+export type ParserType = 'markdown-it' | 'pandoc';
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/parser/types.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEzC;;;OAGG;IACH,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,QAAQ,CAAC"}

package/dist/core/parser/types.js

@@ -0,0 +1,2 @@
+// src/core/parser/types.ts
+export {};