fraim-framework 2.0.34 → 2.0.36

package/registry/scripts/markdown-to-pdf.js

@@ -0,0 +1,395 @@
+#!/usr/bin/env node
+
+/**
+ * Markdown to PDF Converter Script
+ * 
+ * This script converts markdown files to PDF using puppeteer and markdown-it.
+ * It supports various markdown features including tables, code blocks, and images.
+ * 
+ * EXECUTION MODEL:
+ * - Script location: ~/.fraim/scripts/markdown-to-pdf.js
+ * - Working directory: Current project directory (process.cwd())
+ * - Input/output files: Relative to current project directory
+ * - Config: Reads from .fraim/config.json in current project directory
+ * 
+ * Usage:
+ *   node ~/.fraim/scripts/markdown-to-pdf.js <input.md> [output.pdf] [options]
+ * 
+ * Options:
+ *   --format <format>     Paper format (A4, Letter, Legal, etc.) - default: A4
+ *   --margin <margin>     Page margins in inches - default: 0.5
+ *   --css <file>          Custom CSS file for styling
+ *   --header <text>       Header text
+ *   --footer <text>       Footer text
+ *   --landscape           Use landscape orientation
+ *   --no-background       Disable background graphics
+ * 
+ * Examples:
+ *   node ~/.fraim/scripts/markdown-to-pdf.js README.md
+ *   node ~/.fraim/scripts/markdown-to-pdf.js docs/spec.md output/spec.pdf --format Letter
+ *   node ~/.fraim/scripts/markdown-to-pdf.js report.md --css custom.css --header "Company Report"
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// Get project directory (where the user is working)
+const PROJECT_DIR = process.cwd();
+const CONFIG_FILE = path.join(PROJECT_DIR, '.fraim', 'config.json');
+
+// Load project configuration if available
+function loadProjectConfig() {
+  try {
+    if (fs.existsSync(CONFIG_FILE)) {
+      const config = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8'));
+      return config;
+    }
+  } catch (error) {
+    console.warn('Warning: Could not load project config from .fraim/config.json');
+  }
+  return {};
+}
+
+// Check if required dependencies are available
+function checkDependencies() {
+  const requiredPackages = ['puppeteer', 'markdown-it', 'markdown-it-highlightjs'];
+  const missingPackages = [];
+
+  for (const pkg of requiredPackages) {
+    try {
+      require.resolve(pkg);
+    } catch (error) {
+      missingPackages.push(pkg);
+    }
+  }
+
+  if (missingPackages.length > 0) {
+    console.error('Missing required packages:', missingPackages.join(', '));
+    console.error('Install them with: npm install', missingPackages.join(' '));
+    return false;
+  }
+  return true;
+}
+
+// Parse command line arguments
+function parseArgs() {
+  const args = process.argv.slice(2);
+  
+  if (args.length === 0 || args.includes('--help') || args.includes('-h')) {
+    console.log(`
+Markdown to PDF Converter
+
+Usage: node ~/.fraim/scripts/markdown-to-pdf.js <input.md> [output.pdf] [options]
+
+Options:
+  --format <format>     Paper format (A4, Letter, Legal, etc.) - default: A4
+  --margin <margin>     Page margins in inches - default: 0.5
+  --css <file>          Custom CSS file for styling
+  --header <text>       Header text
+  --footer <text>       Footer text
+  --landscape           Use landscape orientation
+  --no-background       Disable background graphics
+  --help, -h            Show this help message
+
+Examples:
+  node ~/.fraim/scripts/markdown-to-pdf.js README.md
+  node ~/.fraim/scripts/markdown-to-pdf.js docs/spec.md output/spec.pdf --format Letter
+  node ~/.fraim/scripts/markdown-to-pdf.js report.md --css custom.css --header "Company Report"
+
+Working Directory: ${PROJECT_DIR}
+Config File: ${CONFIG_FILE}
+    `);
+    process.exit(0);
+  }
+
+  const config = {
+    input: args[0],
+    output: null,
+    format: 'A4',
+    margin: '0.5in',
+    css: null,
+    header: null,
+    footer: null,
+    landscape: false,
+    background: true
+  };
+
+  // Resolve input path relative to project directory
+  if (!path.isAbsolute(config.input)) {
+    config.input = path.resolve(PROJECT_DIR, config.input);
+  }
+
+  // Check if second argument is output file or option
+  if (args[1] && !args[1].startsWith('--')) {
+    config.output = args[1];
+  }
+
+  // Parse options
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    
+    if (arg === '--format' && args[i + 1]) {
+      config.format = args[i + 1];
+      i++;
+    } else if (arg === '--margin' && args[i + 1]) {
+      config.margin = args[i + 1];
+      i++;
+    } else if (arg === '--css' && args[i + 1]) {
+      config.css = args[i + 1];
+      i++;
+    } else if (arg === '--header' && args[i + 1]) {
+      config.header = args[i + 1];
+      i++;
+    } else if (arg === '--footer' && args[i + 1]) {
+      config.footer = args[i + 1];
+      i++;
+    } else if (arg === '--landscape') {
+      config.landscape = true;
+    } else if (arg === '--no-background') {
+      config.background = false;
+    }
+  }
+
+  // Set default output if not provided
+  if (!config.output) {
+    const inputPath = path.parse(config.input);
+    config.output = path.join(inputPath.dir, inputPath.name + '.pdf');
+  }
+
+  // Resolve output path relative to project directory
+  if (!path.isAbsolute(config.output)) {
+    config.output = path.resolve(PROJECT_DIR, config.output);
+  }
+
+  // Resolve CSS path relative to project directory if provided
+  if (config.css && !path.isAbsolute(config.css)) {
+    config.css = path.resolve(PROJECT_DIR, config.css);
+  }
+
+  return config;
+}
+
+// Convert markdown to HTML
+async function markdownToHtml(markdownContent, customCss = null) {
+  const MarkdownIt = require('markdown-it');
+  const hljs = require('markdown-it-highlightjs');
+  
+  const md = new MarkdownIt({
+    html: true,
+    linkify: true,
+    typographer: true,
+    breaks: false
+  }).use(hljs);
+
+  const htmlContent = md.render(markdownContent);
+  
+  // Default CSS for better PDF rendering
+  const defaultCss = `
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+      line-height: 1.6;
+      color: #333;
+      max-width: none;
+      margin: 0;
+      padding: 20px;
+    }
+    
+    h1, h2, h3, h4, h5, h6 {
+      color: #2c3e50;
+      margin-top: 2em;
+      margin-bottom: 1em;
+    }
+    
+    h1 { font-size: 2.5em; border-bottom: 2px solid #3498db; padding-bottom: 0.3em; }
+    h2 { font-size: 2em; border-bottom: 1px solid #bdc3c7; padding-bottom: 0.3em; }
+    h3 { font-size: 1.5em; }
+    
+    code {
+      background-color: #f8f9fa;
+      padding: 2px 4px;
+      border-radius: 3px;
+      font-family: 'Monaco', 'Menlo', 'Ubuntu Mono', monospace;
+    }
+    
+    pre {
+      background-color: #f8f9fa;
+      border: 1px solid #e9ecef;
+      border-radius: 6px;
+      padding: 16px;
+      overflow-x: auto;
+      margin: 1em 0;
+    }
+    
+    pre code {
+      background: none;
+      padding: 0;
+    }
+    
+    table {
+      border-collapse: collapse;
+      width: 100%;
+      margin: 1em 0;
+    }
+    
+    th, td {
+      border: 1px solid #ddd;
+      padding: 12px;
+      text-align: left;
+    }
+    
+    th {
+      background-color: #f2f2f2;
+      font-weight: bold;
+    }
+    
+    blockquote {
+      border-left: 4px solid #3498db;
+      margin: 1em 0;
+      padding-left: 1em;
+      color: #7f8c8d;
+    }
+    
+    img {
+      max-width: 100%;
+      height: auto;
+    }
+    
+    a {
+      color: #3498db;
+      text-decoration: none;
+    }
+    
+    a:hover {
+      text-decoration: underline;
+    }
+    
+    ul, ol {
+      padding-left: 2em;
+    }
+    
+    li {
+      margin: 0.5em 0;
+    }
+    
+    @media print {
+      body { margin: 0; }
+      h1, h2, h3, h4, h5, h6 { page-break-after: avoid; }
+      pre, blockquote { page-break-inside: avoid; }
+      img { page-break-inside: avoid; }
+    }
+  `;
+  
+  let customCssContent = '';
+  if (customCss && fs.existsSync(customCss)) {
+    customCssContent = fs.readFileSync(customCss, 'utf8');
+  }
+  
+  return `
+    <!DOCTYPE html>
+    <html>
+    <head>
+      <meta charset="utf-8">
+      <title>Converted from Markdown</title>
+      <style>${defaultCss}${customCssContent}</style>
+    </head>
+    <body>
+      ${htmlContent}
+    </body>
+    </html>
+  `;
+}
+
+// Convert HTML to PDF using Puppeteer
+async function htmlToPdf(html, outputPath, config) {
+  const puppeteer = require('puppeteer');
+  
+  const browser = await puppeteer.launch({
+    headless: 'new',
+    args: ['--no-sandbox', '--disable-setuid-sandbox']
+  });
+  
+  try {
+    const page = await browser.newPage();
+    await page.setContent(html, { waitUntil: 'networkidle0' });
+    
+    const pdfOptions = {
+      path: outputPath,
+      format: config.format,
+      margin: {
+        top: config.margin,
+        right: config.margin,
+        bottom: config.margin,
+        left: config.margin
+      },
+      landscape: config.landscape,
+      printBackground: config.background,
+      preferCSSPageSize: true
+    };
+    
+    if (config.header) {
+      pdfOptions.displayHeaderFooter = true;
+      pdfOptions.headerTemplate = `<div style="font-size: 10px; width: 100%; text-align: center;">${config.header}</div>`;
+    }
+    
+    if (config.footer) {
+      pdfOptions.displayHeaderFooter = true;
+      pdfOptions.footerTemplate = `<div style="font-size: 10px; width: 100%; text-align: center;">${config.footer}</div>`;
+    }
+    
+    await page.pdf(pdfOptions);
+    console.log(`✅ PDF generated successfully: ${path.relative(PROJECT_DIR, outputPath)}`);
+    
+  } finally {
+    await browser.close();
+  }
+}
+
+// Main function
+async function main() {
+  try {
+    if (!checkDependencies()) {
+      process.exit(1);
+    }
+    
+    const config = parseArgs();
+    const projectConfig = loadProjectConfig();
+    
+    console.log(`📄 Converting markdown to PDF...`);
+    console.log(`   Working directory: ${PROJECT_DIR}`);
+    console.log(`   Input: ${path.relative(PROJECT_DIR, config.input)}`);
+    console.log(`   Output: ${path.relative(PROJECT_DIR, config.output)}`);
+    
+    // Validate input file
+    if (!fs.existsSync(config.input)) {
+      console.error(`❌ Input file not found: ${path.relative(PROJECT_DIR, config.input)}`);
+      process.exit(1);
+    }
+    
+    // Ensure output directory exists
+    const outputDir = path.dirname(config.output);
+    if (!fs.existsSync(outputDir)) {
+      fs.mkdirSync(outputDir, { recursive: true });
+      console.log(`📁 Created output directory: ${path.relative(PROJECT_DIR, outputDir)}`);
+    }
+    
+    // Read markdown file
+    const markdownContent = fs.readFileSync(config.input, 'utf8');
+    
+    // Convert to HTML
+    const html = await markdownToHtml(markdownContent, config.css);
+    
+    // Convert to PDF
+    await htmlToPdf(html, config.output, config);
+    
+  } catch (error) {
+    console.error('❌ Error:', error.message);
+    process.exit(1);
+  }
+}
+
+// Run if called directly
+if (require.main === module) {
+  main();
+}
+
+module.exports = { markdownToHtml, htmlToPdf, parseArgs, checkDependencies };