md-pdf-studio 1.1.0 → 2.1.0

package/src/browser/renderer.js

@@ -1,142 +1,142 @@
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-const { execFile } = require('child_process');
-
-/**
- * Finds available Chrome or Edge binary path on system
- * @returns {string|null}
- */
-function findBrowserExecutable() {
-  const platform = os.platform();
-  const candidates = [];
-
-  if (platform === 'win32') {
-    const programFiles = process.env['PROGRAMFILES'] || 'C:\\Program Files';
-    const programFilesX86 = process.env['PROGRAMFILES(X86)'] || 'C:\\Program Files (x86)';
-    const localAppData = process.env['LOCALAPPDATA'] || path.join(os.homedir(), 'AppData', 'Local');
-
-    candidates.push(
-      path.join(programFilesX86, 'Microsoft', 'Edge', 'Application', 'msedge.exe'),
-      path.join(programFiles, 'Microsoft', 'Edge', 'Application', 'msedge.exe'),
-      path.join(programFiles, 'Google', 'Chrome', 'Application', 'chrome.exe'),
-      path.join(programFilesX86, 'Google', 'Chrome', 'Application', 'chrome.exe'),
-      path.join(localAppData, 'Google', 'Chrome', 'Application', 'chrome.exe')
-    );
-  } else if (platform === 'darwin') {
-    candidates.push(
-      '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
-      '/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge',
-      '/Applications/Chromium.app/Contents/MacOS/Chromium'
-    );
-  } else {
-    // Linux / Unix
-    candidates.push(
-      '/usr/bin/google-chrome',
-      '/usr/bin/microsoft-edge',
-      '/usr/bin/chromium-browser',
-      '/usr/bin/chromium'
-    );
-  }
-
-  for (const binPath of candidates) {
-    if (fs.existsSync(binPath)) {
-      return binPath;
-    }
-  }
-
-  return null;
-}
-
-/**
- * Renders HTML file to PDF using headless browser
- * @param {string} htmlPath 
- * @param {string} outputPath 
- * @param {Object} options 
- * @returns {Promise<string>}
- */
-function renderHtmlToPdf(htmlPath, outputPath, options = {}) {
-  return new Promise((resolve, reject) => {
-    const browserPath = options.executablePath || findBrowserExecutable();
-
-    if (!browserPath) {
-      return reject(new Error('No installed Chromium browser (Edge/Chrome) was found on your system. Please install Microsoft Edge or Google Chrome.'));
-    }
-
-    const fileUrl = 'file:///' + path.resolve(htmlPath).replace(/\\/g, '/');
-    const args = [
-      '--headless=new',
-      '--disable-gpu',
-      '--no-sandbox',
-      '--no-pdf-header-footer',
-      '--virtual-time-budget=8000',
-      `--print-to-pdf=${outputPath}`,
-      fileUrl
-    ];
-
-    execFile(browserPath, args, { timeout: 30000 }, (error) => {
-      if (error) {
-        // Fallback for older chrome versions that don't support --headless=new
-        const fallbackArgs = [
-          '--headless',
-          '--disable-gpu',
-          '--no-sandbox',
-          '--no-pdf-header-footer',
-          '--virtual-time-budget=8000',
-          `--print-to-pdf=${outputPath}`,
-          fileUrl
-        ];
-
-        execFile(browserPath, fallbackArgs, { timeout: 30000 }, (err2) => {
-          if (err2) {
-            return reject(new Error(`Failed to render PDF using browser: ${err2.message}`));
-          }
-          if (fs.existsSync(outputPath)) {
-            resolve(outputPath);
-          } else {
-            reject(new Error('Browser finished but output PDF file was not created.'));
-          }
-        });
-        return;
-      }
-
-      if (fs.existsSync(outputPath)) {
-        resolve(outputPath);
-      } else {
-        reject(new Error('Browser finished but output PDF file was not created.'));
-      }
-    });
-  });
-}
-
-/**
- * Renders multiple HTML files to PDF using concurrent browser execution pool
- * @param {Array<{ htmlPath: string, outputPath: string }>} itemPairs 
- * @param {Object} options 
- * @returns {Promise<Array<string>>}
- */
-async function renderBatchHtmlToPdf(itemPairs, options = {}) {
-  const concurrency = Math.min(options.concurrency || 4, itemPairs.length);
-  const results = [];
-  const queue = [...itemPairs];
-
-  async function worker() {
-    while (queue.length > 0) {
-      const item = queue.shift();
-      if (!item) break;
-      const pdfPath = await renderHtmlToPdf(item.htmlPath, item.outputPath, options);
-      results.push(pdfPath);
-    }
-  }
-
-  const workers = Array.from({ length: concurrency }, () => worker());
-  await Promise.all(workers);
-  return results;
-}
-
-module.exports = {
-  findBrowserExecutable,
-  renderHtmlToPdf,
-  renderBatchHtmlToPdf
-};
-
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { execFile } = require('child_process');
+
+/**
+ * Finds available Chrome or Edge binary path on system
+ * @returns {string|null}
+ */
+function findBrowserExecutable() {
+  const platform = os.platform();
+  const candidates = [];
+
+  if (platform === 'win32') {
+    const programFiles = process.env['PROGRAMFILES'] || 'C:\\Program Files';
+    const programFilesX86 = process.env['PROGRAMFILES(X86)'] || 'C:\\Program Files (x86)';
+    const localAppData = process.env['LOCALAPPDATA'] || path.join(os.homedir(), 'AppData', 'Local');
+
+    candidates.push(
+      path.join(programFilesX86, 'Microsoft', 'Edge', 'Application', 'msedge.exe'),
+      path.join(programFiles, 'Microsoft', 'Edge', 'Application', 'msedge.exe'),
+      path.join(programFiles, 'Google', 'Chrome', 'Application', 'chrome.exe'),
+      path.join(programFilesX86, 'Google', 'Chrome', 'Application', 'chrome.exe'),
+      path.join(localAppData, 'Google', 'Chrome', 'Application', 'chrome.exe')
+    );
+  } else if (platform === 'darwin') {
+    candidates.push(
+      '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
+      '/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge',
+      '/Applications/Chromium.app/Contents/MacOS/Chromium'
+    );
+  } else {
+    // Linux / Unix
+    candidates.push(
+      '/usr/bin/google-chrome',
+      '/usr/bin/microsoft-edge',
+      '/usr/bin/chromium-browser',
+      '/usr/bin/chromium'
+    );
+  }
+
+  for (const binPath of candidates) {
+    if (fs.existsSync(binPath)) {
+      return binPath;
+    }
+  }
+
+  return null;
+}
+
+/**
+ * Renders HTML file to PDF using headless browser
+ * @param {string} htmlPath 
+ * @param {string} outputPath 
+ * @param {Object} options 
+ * @returns {Promise<string>}
+ */
+function renderHtmlToPdf(htmlPath, outputPath, options = {}) {
+  return new Promise((resolve, reject) => {
+    const browserPath = options.executablePath || findBrowserExecutable();
+
+    if (!browserPath) {
+      return reject(new Error('No installed Chromium browser (Edge/Chrome) was found on your system. Please install Microsoft Edge or Google Chrome.'));
+    }
+
+    const fileUrl = 'file:///' + path.resolve(htmlPath).replace(/\\/g, '/');
+    const args = [
+      '--headless=new',
+      '--disable-gpu',
+      '--no-sandbox',
+      '--no-pdf-header-footer',
+      '--virtual-time-budget=8000',
+      `--print-to-pdf=${outputPath}`,
+      fileUrl
+    ];
+
+    execFile(browserPath, args, { timeout: 30000 }, (error) => {
+      if (error) {
+        // Fallback for older chrome versions that don't support --headless=new
+        const fallbackArgs = [
+          '--headless',
+          '--disable-gpu',
+          '--no-sandbox',
+          '--no-pdf-header-footer',
+          '--virtual-time-budget=8000',
+          `--print-to-pdf=${outputPath}`,
+          fileUrl
+        ];
+
+        execFile(browserPath, fallbackArgs, { timeout: 30000 }, (err2) => {
+          if (err2) {
+            return reject(new Error(`Failed to render PDF using browser: ${err2.message}`));
+          }
+          if (fs.existsSync(outputPath)) {
+            resolve(outputPath);
+          } else {
+            reject(new Error('Browser finished but output PDF file was not created.'));
+          }
+        });
+        return;
+      }
+
+      if (fs.existsSync(outputPath)) {
+        resolve(outputPath);
+      } else {
+        reject(new Error('Browser finished but output PDF file was not created.'));
+      }
+    });
+  });
+}
+
+/**
+ * Renders multiple HTML files to PDF using concurrent browser execution pool
+ * @param {Array<{ htmlPath: string, outputPath: string }>} itemPairs 
+ * @param {Object} options 
+ * @returns {Promise<Array<string>>}
+ */
+async function renderBatchHtmlToPdf(itemPairs, options = {}) {
+  const concurrency = Math.min(options.concurrency || 4, itemPairs.length);
+  const results = [];
+  const queue = [...itemPairs];
+
+  async function worker() {
+    while (queue.length > 0) {
+      const item = queue.shift();
+      if (!item) break;
+      const pdfPath = await renderHtmlToPdf(item.htmlPath, item.outputPath, options);
+      results.push(pdfPath);
+    }
+  }
+
+  const workers = Array.from({ length: concurrency }, () => worker());
+  await Promise.all(workers);
+  return results;
+}
+
+module.exports = {
+  findBrowserExecutable,
+  renderHtmlToPdf,
+  renderBatchHtmlToPdf
+};
+

package/src/core/cover.js

@@ -1,40 +1,40 @@
-/**
- * Cover Page Generator Utility
- */
-const { escapeHtml } = require('./sanitizer');
-
-/**
- * Generates a Cover Page HTML block if requested in front matter or options
- * @param {Object} metadata 
- * @returns {string} Cover page HTML string
- */
-function generateCoverPage(metadata = {}) {
-  const { title, subtitle, author, date, cover } = metadata;
-  
-  if (!cover && !subtitle && !author && !date) {
-    return '';
-  }
-
-  const docTitle = title || 'Document Report';
-  const docSubtitle = subtitle || '';
-  const docAuthor = author || '';
-  const docDate = date || '';
-
-  return `<div class="cover-page">
-  <div class="cover-page-inner">
-    <div class="cover-badge">DOCUMENT REPORT</div>
-    <h1 class="cover-title">${escapeHtml(docTitle)}</h1>
-    ${docSubtitle ? `<h2 class="cover-subtitle">${escapeHtml(docSubtitle)}</h2>` : ''}
-    <div class="cover-divider"></div>
-    <div class="cover-meta-container">
-      ${docAuthor ? `<div class="cover-meta-item"><span class="cover-meta-label">Tác giả:</span> <span class="cover-meta-val">${escapeHtml(docAuthor)}</span></div>` : ''}
-      ${docDate ? `<div class="cover-meta-item"><span class="cover-meta-label">Ngày lập:</span> <span class="cover-meta-val">${escapeHtml(docDate)}</span></div>` : ''}
-    </div>
-  </div>
-</div>
-<div class="page-break"></div>\n`;
-}
-
-module.exports = {
-  generateCoverPage
-};
+/**
+ * Cover Page Generator Utility
+ */
+const { escapeHtml } = require('./sanitizer');
+
+/**
+ * Generates a Cover Page HTML block if requested in front matter or options
+ * @param {Object} metadata 
+ * @returns {string} Cover page HTML string
+ */
+function generateCoverPage(metadata = {}) {
+  const { title, subtitle, author, date, cover } = metadata;
+  
+  if (!cover && !subtitle && !author && !date) {
+    return '';
+  }
+
+  const docTitle = title || 'Document Report';
+  const docSubtitle = subtitle || '';
+  const docAuthor = author || '';
+  const docDate = date || '';
+
+  return `<div class="cover-page">
+  <div class="cover-page-inner">
+    <div class="cover-badge">DOCUMENT REPORT</div>
+    <h1 class="cover-title">${escapeHtml(docTitle)}</h1>
+    ${docSubtitle ? `<h2 class="cover-subtitle">${escapeHtml(docSubtitle)}</h2>` : ''}
+    <div class="cover-divider"></div>
+    <div class="cover-meta-container">
+      ${docAuthor ? `<div class="cover-meta-item"><span class="cover-meta-label">Tác giả:</span> <span class="cover-meta-val">${escapeHtml(docAuthor)}</span></div>` : ''}
+      ${docDate ? `<div class="cover-meta-item"><span class="cover-meta-label">Ngày lập:</span> <span class="cover-meta-val">${escapeHtml(docDate)}</span></div>` : ''}
+    </div>
+  </div>
+</div>
+<div class="page-break"></div>\n`;
+}
+
+module.exports = {
+  generateCoverPage
+};

package/src/core/frontmatter.js

@@ -1,54 +1,54 @@
-/**
- * Front Matter Parser Utility
- */
-
-/**
- * Parses YAML Front Matter from Markdown raw content
- * @param {string} rawContent 
- * @returns {{ data: Object, content: string }}
- */
-function parseFrontMatter(rawContent = '') {
-  if (!rawContent || typeof rawContent !== 'string') {
-    return { data: {}, content: '' };
-  }
-
-  const frontMatterRegex = /^---\r?\n([\s\S]*?)\r?\n---\r?\n/;
-  const match = rawContent.match(frontMatterRegex);
-
-  if (!match) {
-    return { data: {}, content: rawContent };
-  }
-
-  const yamlBlock = match[1];
-  const content = rawContent.slice(match[0].length);
-  const data = {};
-
-  yamlBlock.split('\n').forEach(line => {
-    const trimmed = line.trim();
-    if (!trimmed || trimmed.startsWith('#')) return;
-
-    const colonIdx = trimmed.indexOf(':');
-    if (colonIdx === -1) return;
-
-    const key = trimmed.slice(0, colonIdx).trim();
-    let val = trimmed.slice(colonIdx + 1).trim();
-
-    // Remove quotes
-    if ((val.startsWith('"') && val.endsWith('"')) || (val.startsWith("'") && val.endsWith("'"))) {
-      val = val.slice(1, -1);
-    }
-
-    // Convert booleans & numbers
-    if (val.toLowerCase() === 'true') val = true;
-    else if (val.toLowerCase() === 'false') val = false;
-    else if (!isNaN(val) && val !== '') val = Number(val);
-
-    data[key] = val;
-  });
-
-  return { data, content };
-}
-
-module.exports = {
-  parseFrontMatter
-};
+/**
+ * Front Matter Parser Utility
+ */
+
+/**
+ * Parses YAML Front Matter from Markdown raw content
+ * @param {string} rawContent 
+ * @returns {{ data: Object, content: string }}
+ */
+function parseFrontMatter(rawContent = '') {
+  if (!rawContent || typeof rawContent !== 'string') {
+    return { data: {}, content: '' };
+  }
+
+  const frontMatterRegex = /^---\r?\n([\s\S]*?)\r?\n---\r?\n/;
+  const match = rawContent.match(frontMatterRegex);
+
+  if (!match) {
+    return { data: {}, content: rawContent };
+  }
+
+  const yamlBlock = match[1];
+  const content = rawContent.slice(match[0].length);
+  const data = {};
+
+  yamlBlock.split('\n').forEach(line => {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith('#')) return;
+
+    const colonIdx = trimmed.indexOf(':');
+    if (colonIdx === -1) return;
+
+    const key = trimmed.slice(0, colonIdx).trim();
+    let val = trimmed.slice(colonIdx + 1).trim();
+
+    // Remove quotes
+    if ((val.startsWith('"') && val.endsWith('"')) || (val.startsWith("'") && val.endsWith("'"))) {
+      val = val.slice(1, -1);
+    }
+
+    // Convert booleans & numbers
+    if (val.toLowerCase() === 'true') val = true;
+    else if (val.toLowerCase() === 'false') val = false;
+    else if (!isNaN(val) && val !== '') val = Number(val);
+
+    data[key] = val;
+  });
+
+  return { data, content };
+}
+
+module.exports = {
+  parseFrontMatter
+};

package/src/core/index.js

@@ -1,80 +1,80 @@
-const fs = require('fs');
-const path = require('path');
-const { parseMarkdownToHtml } = require('./parser');
-const { renderHtmlToPdf } = require('../browser/renderer');
-const { resolvePath } = require('./utils');
-
-/**
- * Main function to convert Markdown file to PDF
- * @param {string} inputPath Path to source .md file
- * @param {string} [outputPath] Path to target .pdf file
- * @param {Object} [options] Conversion options
- * @returns {Promise<{ htmlPath: string, pdfPath: string }>}
- */
-async function convertMarkdownToPdf(inputPath, outputPath, options = {}) {
-  const absInputPath = resolvePath(inputPath);
-
-  if (!fs.existsSync(absInputPath)) {
-    throw new Error(`Input file not found: ${absInputPath}`);
-  }
-
-  const format = options.format ? options.format.toLowerCase() : 'pdf';
-
-  // Derive output path if omitted
-  let absOutputPath;
-  if (outputPath) {
-    absOutputPath = resolvePath(outputPath);
-  } else {
-    const parsed = path.parse(absInputPath);
-    absOutputPath = path.join(parsed.dir, `${parsed.name}.${format}`);
-  }
-
-  // Read Markdown
-  const markdownContent = fs.readFileSync(absInputPath, 'utf8');
-
-  // Parse to HTML
-  const htmlContent = parseMarkdownToHtml(markdownContent, options);
-
-  if (format === 'html') {
-    fs.writeFileSync(absOutputPath, htmlContent, 'utf8');
-    return {
-      htmlPath: absOutputPath,
-      pdfPath: null
-    };
-  }
-
-  // Temporary HTML path
-  const tempHtmlPath = path.join(path.parse(absOutputPath).dir, `_temp_${Date.now()}_${Math.random().toString(36).substring(7)}.html`);
-
-  try {
-    // Save temporary HTML file
-    fs.writeFileSync(tempHtmlPath, htmlContent, 'utf8');
-
-    // Render HTML to PDF via headless browser
-    await renderHtmlToPdf(tempHtmlPath, absOutputPath, options);
-
-    // Clean up temporary HTML file unless explicitly requested to keep
-    if (!options.keepHtml) {
-      if (fs.existsSync(tempHtmlPath)) {
-        fs.unlinkSync(tempHtmlPath);
-      }
-    }
-
-    return {
-      htmlPath: tempHtmlPath,
-      pdfPath: absOutputPath
-    };
-  } catch (error) {
-    // Clean up on failure
-    if (fs.existsSync(tempHtmlPath)) {
-      try { fs.unlinkSync(tempHtmlPath); } catch (_) {}
-    }
-    throw error;
-  }
-}
-
-module.exports = {
-  convertMarkdownToPdf,
-  parseMarkdownToHtml,
-  renderHtmlToPdf
-};
+const fs = require('fs');
+const path = require('path');
+const { parseMarkdownToHtml } = require('./parser');
+const { renderHtmlToPdf } = require('../browser/renderer');
+const { resolvePath } = require('./utils');
+
+/**
+ * Main function to convert Markdown file to PDF
+ * @param {string} inputPath Path to source .md file
+ * @param {string} [outputPath] Path to target .pdf file
+ * @param {Object} [options] Conversion options
+ * @returns {Promise<{ htmlPath: string, pdfPath: string }>}
+ */
+async function convertMarkdownToPdf(inputPath, outputPath, options = {}) {
+  const absInputPath = resolvePath(inputPath);
+
+  if (!fs.existsSync(absInputPath)) {
+    throw new Error(`Input file not found: ${absInputPath}`);
+  }
+
+  const format = options.format ? options.format.toLowerCase() : 'pdf';
+
+  // Derive output path if omitted
+  let absOutputPath;
+  if (outputPath) {
+    absOutputPath = resolvePath(outputPath);
+  } else {
+    const parsed = path.parse(absInputPath);
+    absOutputPath = path.join(parsed.dir, `${parsed.name}.${format}`);
+  }
+
+  // Read Markdown
+  const markdownContent = fs.readFileSync(absInputPath, 'utf8');
+
+  // Parse to HTML
+  const htmlContent = parseMarkdownToHtml(markdownContent, options);
+
+  if (format === 'html') {
+    fs.writeFileSync(absOutputPath, htmlContent, 'utf8');
+    return {
+      htmlPath: absOutputPath,
+      pdfPath: null
+    };
+  }
+
+  // Temporary HTML path
+  const tempHtmlPath = path.join(path.parse(absOutputPath).dir, `_temp_${Date.now()}_${Math.random().toString(36).substring(7)}.html`);
+
+  try {
+    // Save temporary HTML file
+    fs.writeFileSync(tempHtmlPath, htmlContent, 'utf8');
+
+    // Render HTML to PDF via headless browser
+    await renderHtmlToPdf(tempHtmlPath, absOutputPath, options);
+
+    // Clean up temporary HTML file unless explicitly requested to keep
+    if (!options.keepHtml) {
+      if (fs.existsSync(tempHtmlPath)) {
+        fs.unlinkSync(tempHtmlPath);
+      }
+    }
+
+    return {
+      htmlPath: tempHtmlPath,
+      pdfPath: absOutputPath
+    };
+  } catch (error) {
+    // Clean up on failure
+    if (fs.existsSync(tempHtmlPath)) {
+      try { fs.unlinkSync(tempHtmlPath); } catch (_) {}
+    }
+    throw error;
+  }
+}
+
+module.exports = {
+  convertMarkdownToPdf,
+  parseMarkdownToHtml,
+  renderHtmlToPdf
+};