md-pdf-studio 1.1.0 → 2.1.0

package/src/core/themes/highlight.js

@@ -0,0 +1,38 @@
+/**
+ * Syntax Highlighting Token Colors
+ * Two palettes, picked by the background each theme gives its code blocks.
+ */
+// Inline-code chrome must not repeat on every line of a block.
+const base = `
+  pre code { background: none; padding: 0; border: none; }
+`;
+
+const light = `
+  .hljs-comment, .hljs-quote, .hljs-meta { color: #6e7781; font-style: italic; }
+  .hljs-keyword, .hljs-selector-tag, .hljs-doctag, .hljs-template-tag { color: #cf222e; }
+  .hljs-string, .hljs-regexp, .hljs-char.escape_ { color: #0a3069; }
+  .hljs-number, .hljs-literal, .hljs-attr, .hljs-attribute, .hljs-variable, .hljs-template-variable, .hljs-symbol, .hljs-bullet { color: #0550ae; }
+  .hljs-title, .hljs-section, .hljs-selector-id, .hljs-selector-class { color: #8250df; }
+  .hljs-type, .hljs-built_in, .hljs-params { color: #953800; }
+  .hljs-name, .hljs-tag { color: #116329; }
+  .hljs-addition { color: #116329; background-color: #dafbe1; }
+  .hljs-deletion { color: #82071e; background-color: #ffebe9; }
+  .hljs-emphasis { font-style: italic; }
+  .hljs-strong { font-weight: 700; }
+`;
+
+const dark = `
+  .hljs-comment, .hljs-quote, .hljs-meta { color: #8b949e; font-style: italic; }
+  .hljs-keyword, .hljs-selector-tag, .hljs-doctag, .hljs-template-tag { color: #ff7b72; }
+  .hljs-string, .hljs-regexp, .hljs-char.escape_ { color: #a5d6ff; }
+  .hljs-number, .hljs-literal, .hljs-attr, .hljs-attribute, .hljs-variable, .hljs-template-variable, .hljs-symbol, .hljs-bullet { color: #79c0ff; }
+  .hljs-title, .hljs-section, .hljs-selector-id, .hljs-selector-class { color: #d2a8ff; }
+  .hljs-type, .hljs-built_in, .hljs-params { color: #ffa657; }
+  .hljs-name, .hljs-tag { color: #7ee787; }
+  .hljs-addition { color: #aff5b4; background-color: #033a16; }
+  .hljs-deletion { color: #ffdcd7; background-color: #67060c; }
+  .hljs-emphasis { font-style: italic; }
+  .hljs-strong { font-weight: 700; }
+`;
+
+module.exports = { light: base + light, dark: base + dark };

package/src/core/themes/index.js

@@ -1,52 +1,58 @@
-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
-};
+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 highlightCss = require('./highlight');
+
+const THEMES = {
+  modern: modernTheme,
+  dark: darkTheme,
+  academic: academicTheme,
+  github: githubTheme,
+  ebook: ebookTheme,
+  cyberpunk: cyberpunkTheme,
+  minimal: minimalTheme
+};
+
+// Themes whose code blocks sit on a dark background; the others use the light palette.
+const DARK_CODE_THEMES = new Set(['modern', 'dark', 'ebook', 'cyberpunk']);
+
+/**
+ * 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 themeName = THEMES[theme] ? theme : 'modern';
+  const themeCss = THEMES[themeName];
+  const tokenCss = DARK_CODE_THEMES.has(themeName) ? highlightCss.dark : highlightCss.light;
+  const fontOverrideCss = getFontOverrideCss(font);
+
+  return `${coverCss}\n${fontOverrideCss}${themeCss}${tokenCss}`;
+}
+
+module.exports = {
+  getThemeStyles,
+  THEMES
+};

package/src/core/themes/minimal.js

@@ -1,20 +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; }
-`;
+/**
+ * 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

@@ -1,34 +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; }
-`;
+/**
+ * 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

@@ -1,72 +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
-};
+/**
+ * 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

@@ -1,85 +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
-};
+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

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