md-pdf-studio 1.1.0

package/src/core/themes/index.js

@@ -0,0 +1,52 @@
+const coverCss = require('./cover');
+const modernTheme = require('./modern');
+const darkTheme = require('./dark');
+const academicTheme = require('./academic');
+const githubTheme = require('./github');
+const ebookTheme = require('./ebook');
+const cyberpunkTheme = require('./cyberpunk');
+const minimalTheme = require('./minimal');
+
+const THEMES = {
+  modern: modernTheme,
+  dark: darkTheme,
+  academic: academicTheme,
+  github: githubTheme,
+  ebook: ebookTheme,
+  cyberpunk: cyberpunkTheme,
+  minimal: minimalTheme
+};
+
+/**
+ * Builds font override CSS string
+ * @param {string} font 
+ * @returns {string} CSS snippet
+ */
+function getFontOverrideCss(font) {
+  if (!font) return '';
+  if (font === 'Lora' || font === 'Merriweather') {
+    return `body { font-family: '${font}', Georgia, serif !important; }\n`;
+  }
+  if (font === 'JetBrains Mono' || font === 'Fira Code') {
+    return `body { font-family: '${font}', monospace !important; }\n`;
+  }
+  return `body { font-family: '${font}', sans-serif !important; }\n`;
+}
+
+/**
+ * Returns complete CSS theme string with cover page and font override
+ * @param {string} theme Name of theme
+ * @param {string} [font] Font family override
+ * @returns {string} Consolidated CSS string
+ */
+function getThemeStyles(theme, font = '') {
+  const themeCss = THEMES[theme] || THEMES.modern;
+  const fontOverrideCss = getFontOverrideCss(font);
+
+  return `${coverCss}\n${fontOverrideCss}${themeCss}`;
+}
+
+module.exports = {
+  getThemeStyles,
+  THEMES
+};

package/src/core/themes/minimal.js

@@ -0,0 +1,20 @@
+/**
+ * Minimal Theme Styles
+ */
+module.exports = `
+  body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif; font-size: 13px; line-height: 1.5; color: #000000; background-color: #ffffff; padding: 10px; }
+  h1 { font-size: 20px; font-weight: 700; border-bottom: 2px solid #000; padding-bottom: 4px; break-after: avoid-page; }
+  h2 { font-size: 15px; font-weight: 700; margin-top: 18px; break-after: avoid-page; }
+  h3 { font-size: 13.5px; font-weight: 600; break-after: avoid-page; }
+  blockquote { border-left: 3px solid #000; padding-left: 12px; margin: 10px 0; }
+  table { width: 100%; border-collapse: collapse; margin: 12px 0; font-size: 12px; }
+  tr { break-inside: avoid-page; }
+  th, td { border: 1px solid #000; padding: 6px; }
+  th { background: #f2f2f2; font-weight: 700; }
+  code { font-family: monospace; font-size: 11px; background: #f2f2f2; padding: 2px 4px; }
+  pre { font-family: monospace; font-size: 10.5px; background: #f9f9f9; border: 1px solid #ccc; padding: 10px; break-inside: avoid-page; }
+  .formula-box { border: 1px solid #000; padding: 8px; text-align: center; margin: 10px 0; }
+  .mermaid-container { display: block; text-align: center; margin: 12px 0; border: 1px solid #ccc; padding: 8px; overflow-x: auto; break-inside: avoid-page; }
+  .mermaid { display: block; text-align: center; width: 100%; }
+  .mermaid svg { max-width: 100% !important; height: auto !important; margin: 0 auto; display: inline-block; }
+`;

package/src/core/themes/modern.js

@@ -0,0 +1,34 @@
+/**
+ * Modern Theme Styles
+ */
+module.exports = `
+  body { font-family: 'Inter', 'Noto Sans JP', -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif; font-size: 13px; line-height: 1.55; color: #1e293b; background-color: #ffffff; margin: 0; padding: 10px; }
+  h1 { font-size: 21px; font-weight: 700; color: #0f172a; border-bottom: 3px solid #2563eb; padding-bottom: 8px; margin-top: 0; margin-bottom: 16px; text-transform: uppercase; letter-spacing: 0.3px; break-after: avoid-page; page-break-after: avoid; }
+  h2 { font-size: 16px; font-weight: 700; color: #1e3a8a; background: #eff6ff; border-left: 5px solid #2563eb; padding: 6px 12px; margin-top: 22px; margin-bottom: 12px; border-radius: 0 4px 4px 0; break-after: avoid-page; page-break-after: avoid; }
+  h3 { font-size: 14.5px; font-weight: 600; color: #1e40af; margin-top: 16px; margin-bottom: 8px; border-bottom: 1px solid #e2e8f0; padding-bottom: 4px; break-after: avoid-page; page-break-after: avoid; }
+  h4 { font-size: 13.5px; font-weight: 600; color: #334155; margin-top: 12px; margin-bottom: 6px; break-after: avoid-page; page-break-after: avoid; }
+  .section-group { break-inside: avoid-page; page-break-inside: avoid; }
+  .formula-box { background: #f0f9ff; border: 1px solid #bae6fd; border-left: 4px solid #0284c7; padding: 10px 16px; border-radius: 4px; margin: 12px 0; font-size: 13.5px; color: #0369a1; text-align: center; }
+  .formula-box span { font-weight: 500; background: #ffffff; padding: 2px 8px; border-radius: 3px; border: 1px solid #e0f2fe; }
+  blockquote { margin: 12px 0; padding: 10px 16px; background-color: #f8fafc; border-left: 4px solid #3b82f6; border-radius: 4px; color: #334155; font-size: 12.5px; }
+  blockquote p { margin: 4px 0; }
+  table { width: 100%; border-collapse: collapse; margin: 12px 0; font-size: 12px; break-inside: auto; }
+  tr { break-inside: avoid-page; page-break-inside: avoid; }
+  th { background-color: #1e293b; color: #ffffff; font-weight: 600; text-align: left; padding: 7px 9px; border: 1px solid #334155; font-size: 11.5px; letter-spacing: 0.2px; }
+  td { padding: 6px 9px; border: 1px solid #cbd5e1; vertical-align: top; }
+  tbody tr:nth-child(even) { background-color: #f8fafc; }
+  code { font-family: 'JetBrains Mono', Consolas, Monaco, monospace; font-size: 11.5px; background-color: #f1f5f9; color: #0f172a; padding: 1px 5px; border-radius: 3px; border: 1px solid #e2e8f0; }
+  pre { font-family: 'JetBrains Mono', Consolas, Monaco, monospace; font-size: 10.5px; line-height: 1.4; background-color: #0f172a; color: #f8fafc; padding: 10px 12px; border-radius: 6px; overflow-x: auto; margin: 10px 0; white-space: pre-wrap; word-break: break-all; break-inside: avoid-page; page-break-inside: avoid; }
+  pre code { background: none; color: inherit; padding: 0; border: none; font-size: inherit; }
+  .ui-mockup-container { margin: 12px 0; break-inside: avoid-page; page-break-inside: avoid; }
+  .ui-mockup { background-color: #1e1e2e; color: #a6adc8; border: 1px solid #313244; border-left: 4px solid #89b4fa; box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1); }
+  .ui-mockup code { color: #cdd6f4; }
+  .mermaid-container { display: block; text-align: center; margin: 14px 0; background-color: #ffffff; padding: 12px; border: 1px solid #e2e8f0; border-radius: 6px; overflow-x: auto; break-inside: avoid-page; page-break-inside: avoid; }
+  .mermaid { display: block; text-align: center; width: 100%; }
+  .mermaid svg { max-width: 100% !important; height: auto !important; margin: 0 auto; display: inline-block; }
+  hr { border: 0; height: 1px; background: #e2e8f0; margin: 16px 0; }
+  ul, ol { padding-left: 20px; margin: 6px 0; }
+  li { margin-bottom: 3px; }
+  strong { color: #0f172a; }
+  a { color: #2563eb; text-decoration: none; }
+`;

package/src/core/toc.js

@@ -0,0 +1,72 @@
+/**
+ * Table of Contents (TOC) Generator Utility
+ */
+const { escapeHtml } = require('./sanitizer');
+
+/**
+ * Generates a Table of Contents (TOC) HTML block from markdown headings with dotted leader lines
+ * @param {string} mdContent 
+ * @returns {{ tocHtml: string, headingsMap: Map<string, string> }}
+ */
+function generateToc(mdContent) {
+  if (!mdContent) return { tocHtml: '', headingsMap: new Map() };
+
+  const lines = mdContent.split('\n');
+  const headings = [];
+  const headingsMap = new Map();
+  const slugCounts = {};
+
+  lines.forEach(line => {
+    const match = line.match(/^(#{1,3})\s+(.+)$/);
+    if (match) {
+      const level = match[1].length;
+      let title = match[2].trim();
+      
+      // Clean inline markdown links/code from heading title
+      title = title.replace(/\[([^\]]+)\]\([^)]+\)/g, '$1')
+                   .replace(/`([^`]+)`/g, '$1')
+                   .replace(/\*+/g, '');
+
+      // Create unique slug
+      let slug = title.toLowerCase()
+                      .replace(/[^\w\u00C0-\u024F\u1EA0-\u1EF9]+/g, '-')
+                      .replace(/^-+|-+$/g, '');
+
+      if (!slug) slug = `heading-${headings.length + 1}`;
+
+      if (slugCounts[slug]) {
+        slugCounts[slug]++;
+        slug = `${slug}-${slugCounts[slug]}`;
+      } else {
+        slugCounts[slug] = 1;
+      }
+
+      headings.push({ level, title, slug });
+      headingsMap.set(match[2].trim(), slug);
+    }
+  });
+
+  if (headings.length === 0) return { tocHtml: '', headingsMap };
+
+  let tocHtml = `<div class="toc-container">
+    <div class="toc-title">📋 Table of Contents</div>
+    <ul class="toc-list">\n`;
+
+  headings.forEach(h => {
+    const indentClass = `toc-item-h${h.level}`;
+    tocHtml += `      <li class="${indentClass}">
+        <a href="#${h.slug}">
+          <span class="toc-item-title">${escapeHtml(h.title)}</span>
+          <span class="toc-item-dots"></span>
+        </a>
+      </li>\n`;
+  });
+
+  tocHtml += `    </ul>\n  </div>\n`;
+
+  return { tocHtml, headingsMap };
+}
+
+module.exports = {
+  generateToc
+};

package/src/core/utils.js

@@ -0,0 +1,85 @@
+const fs = require('fs');
+const path = require('path');
+const { parseFrontMatter } = require('./frontmatter');
+const { generateToc } = require('./toc');
+const { generateCoverPage } = require('./cover');
+const { sanitizeHtml, escapeHtml } = require('./sanitizer');
+
+/**
+ * Preprocesses Markdown content before parsing:
+ * - Transforms GitHub Callouts/Alerts (> [!NOTE], > [!TIP], etc.)
+ * - Transforms pagebreak comments (<!-- pagebreak --> or \pagebreak)
+ * - Converts simple LaTeX arrow/math symbols
+ * @param {string} mdContent 
+ * @returns {string} Preprocessed markdown string
+ */
+function preprocessMarkdown(mdContent = '') {
+  if (!mdContent) return '';
+
+  return mdContent
+    // GitHub Callouts / Alerts
+    .replace(/^>\s*\[!NOTE\]\s*\r?\n/gm, '> **ℹ️ NOTE:** ')
+    .replace(/^>\s*\[!TIP\]\s*\r?\n/gm, '> **💡 TIP:** ')
+    .replace(/^>\s*\[!WARNING\]\s*\r?\n/gm, '> **⚠️ WARNING:** ')
+    .replace(/^>\s*\[!IMPORTANT\]\s*\r?\n/gm, '> **❗ IMPORTANT:** ')
+    .replace(/^>\s*\[!CAUTION\]\s*\r?\n/gm, '> **🚫 CAUTION:** ')
+    // Pagebreaks
+    .replace(/<!--\s*page-?break\s*-->/gi, '<div class="page-break"></div>')
+    .replace(/\\pagebreak/gi, '<div class="page-break"></div>')
+    // LaTeX math symbols
+    .replace(/\\longrightarrow/g, '⟶')
+    .replace(/\\rightarrow/g, '→')
+    .replace(/\$→\$/g, '→')
+    .replace(/\$\\rightarrow\$/g, '→')
+    .replace(/\$\\longrightarrow\$/g, '⟶')
+    .replace(/\$\\ge\$/g, '≥')
+    .replace(/\$\\le\$/g, '≤')
+    .replace(/\$x\/y\$/g, 'x/y')
+    .replace(/\$x < y\$/g, 'x < y')
+    .replace(/\$x = y\$/g, 'x = y')
+    // Formula box transformation
+    .replace(/\$\$\s*\\text\{([^}]+)\}\s*=\s*\\text\{([^}]+)\}\s*-\s*\\text\{([^}]+)\}\s*\$\$/g, 
+      '<div class="formula-box"><strong>$1</strong> = <span>$2</span> &minus; <span>$3</span></div>')
+    .replace(/\$\$\s*([\s\S]+?)\s*\$\$/g, '<div class="formula-box">$1</div>');
+}
+
+/**
+ * Safely reads custom CSS file contents
+ * @param {string} cssFilePath 
+ * @returns {string} CSS content
+ */
+function readCustomCss(cssFilePath) {
+  if (!cssFilePath) return '';
+  const absPath = resolvePath(cssFilePath);
+  if (fs.existsSync(absPath)) {
+    try {
+      return fs.readFileSync(absPath, 'utf8');
+    } catch (err) {
+      console.warn(`[Warning] Could not read custom CSS file at: ${absPath}`);
+    }
+  } else {
+    console.warn(`[Warning] Custom CSS file not found at: ${absPath}`);
+  }
+  return '';
+}
+
+/**
+ * Resolves absolute path safely
+ * @param {string} filePath 
+ * @returns {string} Absolute file path
+ */
+function resolvePath(filePath) {
+  if (!filePath) return '';
+  return path.isAbsolute(filePath) ? filePath : path.resolve(process.cwd(), filePath);
+}
+
+module.exports = {
+  parseFrontMatter,
+  generateCoverPage,
+  preprocessMarkdown,
+  generateToc,
+  readCustomCss,
+  sanitizeHtml,
+  escapeHtml,
+  resolvePath
+};

package/src/index.js

@@ -0,0 +1,2 @@
+// Re-export core API module
+module.exports = require('./core/index');